https://github.com/foursquare/fsqmessageforwarder

An Obj-C message forwarder class, for when you don't have access to the source of the sending object.
https://github.com/foursquare/fsqmessageforwarder

Last synced: 3 days ago
JSON representation

An Obj-C message forwarder class, for when you don't have access to the source of the sending object.

• Host: GitHub
• URL: https://github.com/foursquare/fsqmessageforwarder
• Owner: foursquare
• License: other
• Created: 2015-04-02T20:59:21.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-05-18T18:21:30.000Z (over 7 years ago)
• Last Synced: 2024-10-08T21:46:33.021Z (about 1 month ago)
• Language: Objective-C
• Size: 14.6 KB
• Stars: 6
• Watchers: 167
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
FSQMessageForwarder

===============

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

An Obj-C message forwarder class, for when you don't have access to the source of the sending object.

Overview

========

The delegate pattern is very common in many Obj-C libraries, such as UIKit. However sometimes you want the ability to have more than one object receive delegate callbacks. FSQMessageForwarder acts as proxy delegate object, forwarding messages it receives to other objects.

Note: A test project is included but it is used for build testing only - an example application is currently not included in this repository.

Setup

=====

You can include FSQMessageForwarder via Carthage (by adding `github "foursquare/FSQMessageForwarder"` to your Cartfile) or CocoaPods. Alternatively you can simply copy the h and m files for the class to your project manually.

Using Message Forwarder

=======================

There are two different flavors of message forwarder included. One manages its own array of weak references to child objects. The other uses an enumerator to manage its children which is provided to it by a delegate object that you set. 

Either way, using the forwarder is simple. Just instantiate and retain the type of forwarder you want to use and setup its list of child objects. Usually you will then set the forwarder as the delegate of some other class (such as UITableView). The forwarder will forward any messages it does not itself implement to all of its children in order.

Calls to conformsToProtocol:, respondsToSelector:, and methodSignatureForSelector: will work as expected (eg. the forwarder conforms to a protocol if any of its children do, etc.).

If you yourself are writing the sending object, it is generally better to just write your code in such a way that it supports multiple delegates. FSQMessageForwarder is intended to be a workaround for 3rd-party classes that you do not have direct control over (such as those in UIKit)

Return Values

=============

If a forwarded message has a return value, the return value of the first child to respond to the message will be used. If a later child would like its return value to be used instead, it can implement messageForwarder:shouldUseResponseForInvocation: to override this behavior.

Contributors

============

FSQMessageForwarder was initially developed by Foursquare Labs for internal use. It was originally written by Brian Dorfman ([@bdorfman](https://twitter.com/bdorfman)) and is currently maintained Sam Grossberg ([@samgro](https://github.com/samgro)).