FBSessionTokenCachingStrategy
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 FBSessionTokenCachingStrategy class is responsible for persisting and retrieving cached data related to an FBSession object, including the user's Facebook access token.

Discussion:

FBSessionTokenCachingStrategy is designed to be instantiated directly or used as a base class. Usually default token caching behavior is sufficient, and you do not need to interface directly with FBSessionTokenCachingStrategy objects. However, if you need to control where or how FBSession information is cached, then you may take one of two approaches.

The first and simplest approach is to instantiate an instance of FBSessionTokenCachingStrategy, and then pass the instance to FBSession class' init method. This enables your application to control the key name used in NSUserDefaults to store session information. You may consider this approach if you plan to cache session information for multiple users.

The second and more advanced approached is to derive a custom class from FBSessionTokenCachingStrategy, which will be responsible for caching behavior of your application. This approach is useful if you need to change where the information is cached, for example if you prefer to use the filesystem or make a network connection to fetch and persist cached tokens. Inheritors should override the cacheTokenInformation, fetchTokenInformation, and clearToken methods. Doing this enables your application to implement any token caching scheme, including no caching at all.

Direct use of FBSessionTokenCachingStrategyis an advanced technique. Most applications use FBSession objects without passing an FBSessionTokenCachingStrategy, which yields default caching to NSUserDefaults.

Inherits from:NSObject
Declared in:FBSessionTokenCachingStrategy.h
Class Methods
defaultInstance

Helper function called by the SDK as well as apps, in order to fetch the default strategy instance.

+ (FBSessionTokenCachingStrategy*) defaultInstance;
isValidTokenInformation:

Helper function called by the SDK as well as application code, used to determine whether a given dictionary contains the minimum token information usable by the FBSession.

ParameterDescription
tokenInformation

Dictionary containing token information to be validated

+ (BOOL) isValidTokenInformation:(NSDictionary*)tokenInformation;
Instance Methods
cacheTokenInformation:

Called by FBSession (and overridden by inheritors), in order to cache token information.

ParameterDescription
tokenInformation

Dictionary containing token information to be cached by the method

- (void) cacheTokenInformation:(NSDictionary*)tokenInformation;
clearToken

Called by FBSession (and overridden by inheritors), in order delete any cached information for the current token

- (void) clearToken;
fetchTokenInformation

Called by FBSession (and overridden by inheritors), in order to fetch cached token information

- (NSDictionary*) fetchTokenInformation;
Discussion:

An overriding implementation should only return a token if it can also return an expiration date, otherwise return nil

init

Initializes and returns an instance

- (id) init;
initWithUserDefaultTokenInformationKeyName:

Initializes and returns an instance

ParameterDescription
tokenInformationKeyName

Specifies a key name to use for cached token information in NSUserDefaults, nil indicates a default value of @"FBAccessTokenInformationKey"

- (id) initWithUserDefaultTokenInformationKeyName:(NSString*)tokenInformationKeyName;