FBGraphObject
This class is no longer available in the most recent version of the SDK.
A more recent version of this class is available. Check out the latest version.

The FBGraphObject protocol is the base protocol which enables typed access to graph objects and open graph objects. Inherit from this protocol or a sub-protocol in order to introduce custom types for typed access to Facebook objects.

Discussion:

The FBGraphObject protocol is the core type used by the Facebook SDK for iOS to represent objects in the Facebook Social Graph and the Facebook Open Graph (OG). The FBGraphObject class implements useful default functionality, but is rarely used directly by applications. The FBGraphObject protocol, in contrast is the base protocol for all graph object access via the SDK.

Goals of the FBGraphObject types:

  • Lightweight/maintainable/robust
  • Extensible and resilient to change, both by Facebook and third party (OG)
  • Simple and natural extension to Objective-C

The FBGraphObject at its core is a duck typed (if it walks/swims/quacks... its a duck) model which supports an optional static facade. Duck-typing achieves the flexibility necessary for Social Graph and OG uses, and the static facade increases discoverability, maintainability, robustness and simplicity. The following excerpt from the PlacePickerSample shows a simple use of the a facade protocol FBGraphPlace by an application:

 - (void)placePickerViewControllerSelectionDidChange:(FBPlacePickerViewController *)placePicker
 {
 id<FBGraphPlace> place = placePicker.selection;

 // we'll use logging to show the simple typed property access to place and location info
 NSLog(@"place=%@, city=%@, state=%@, lat long=%@ %@",
 place.name,
 place.location.city,
 place.location.state,
 place.location.latitude,
 place.location.longitude);
 }

Note that in this example, access to common place information is available through typed property syntax. But if at some point places in the Social Graph supported additional fields "foo" and "bar", not reflected in the FBGraphPlace protocol, the application could still access the values like so:

 NSString *foo = [place objectForKey:@"foo"]; // perhaps located at the ... in the preceding example
 NSNumber *bar = [place objectForKey:@"bar"]; // extensibility applies to Social and Open graph uses

In addition to untyped access, applications and future revisions of the SDK may add facade protocols by declaring a protocol inheriting the FBGraphObject protocol, like so:

 @protocol MyGraphThing<FBGraphObject>
 @property (copy, nonatomic) NSString *objectID;
 @property (copy, nonatomic) NSString *name;
 @end

Important: facade implementations are inferred by graph objects returned by the methods of the SDK. This means that no explicit implementation is required by application or SDK code. Any FBGraphObject instance may be cast to any FBGraphObject facade protocol, and accessed via properties. If a field is not present for a given facade property, the property will return nil.

The following layer diagram depicts some of the concepts discussed thus far:

                        *-------------* *------------* *-------------**--------------------------*
 Facade -->             | FBGraphUser | |FBGraphPlace| | MyGraphThing|| MyGraphPersonExtentension| ...
                        *-------------* *------------* *-------------**--------------------------*
                        *------------------------------------* *--------------------------------------*
 Transparent impl -->   |     FBGraphObject (instances)      | |      CustomClass<FBGraphObject>      |
                        *------------------------------------* *--------------------------------------*
                        *-------------------**------------------------* *-----------------------------*
 Apparent impl -->      |NSMutableDictionary||FBGraphObject (protocol)| |FBGraphObject (class methods)|
                        *-------------------**------------------------* *-----------------------------*

The Facade layer is meant for typed access to graph objects. The Transparent impl layer (more specifically, the instance capabilities of FBGraphObject) are used by the SDK and app logic internally, but are not part of the public interface between application and SDK. The Apparent impl layer represents the lower-level "duck-typed" use of graph objects.

Implementation note: the SDK returns NSMutableDictionary derived instances with types declared like one of the following:

 NSMutableDictionary<FBGraphObject> *obj;     // no facade specified (still castable by app)
 NSMutableDictionary<FBGraphPlace> *person;   // facade specified when possible

However, when passing a graph object to the SDK, NSMutableDictionary is not assumed; only the FBGraphObject protocol is assumed, like so:

 id<FBGraphObject> anyGraphObj;

As such, the methods declared on the FBGraphObject protocol represent the methods used by the SDK to consume graph objects. While the FBGraphObject class implements the full NSMutableDictionary and KVC interfaces, these are not consumed directly by the SDK, and are optional for custom implementations.

Extends Protocol:NSObject
Declared in:FBGraphObject.h
Properties
provisionedForPost

This property signifies that the current graph object is provisioned for POST (as a definition for a new or updated graph object), and should be posted AS-IS in its JSON encoded form, whereas some graph objects (usually those embedded in other graph objects as references to existing objects) may only have their "id" or "url" posted.

@property (nonatomic, assign) BOOL provisionedForPost;
Declared In: FBGraphObject.h
Instance Methods
count

Returns the number of properties on this FBGraphObject.

- (NSUInteger) count;
Declared In: FBGraphObject.h
keyEnumerator

Returns an enumerator of the property names on this FBGraphObject.

- (NSEnumerator *) keyEnumerator;
Declared In: FBGraphObject.h
objectForKey:

Returns a property on this FBGraphObject.

ParameterDescription
aKey

Name of the property to return

- (id) objectForKey:(id)aKey;
Declared In: FBGraphObject.h
removeObjectForKey:

Removes a property on this FBGraphObject.

ParameterDescription
aKey

Name of the property to remove

- (void) removeObjectForKey:(id)aKey;
Declared In: FBGraphObject.h
setObject:forKey:

Sets the value of a property on this FBGraphObject.

ParameterDescription
anObject

The new value of the property

aKey

Name of the property to set

- (void)
setObject: (id)anObject
forKey: (id)aKey;
Declared In: FBGraphObject.h