Initializes a new Session with the specified context.

Save the Session object into the supplied Bundle. This method is intended to be called from an Activity or Fragment's onSaveInstanceState method in order to preserve Sessions across Activity lifecycle events.

Restores the saved session from a Bundle, if any. Returns the restored Session or null if it could not be restored. This method is intended to be called from an Activity or Fragment's onCreate method when a Session has previously been saved into a Bundle via saveState to preserve a Session across Activity lifecycle events.

Returns the current active Session, or null if there is none.

Sets the current active Session.

The active Session is used implicitly by predefined Request factory methods as well as optionally by UI controls in the sdk.

It is legal to set this to null, or to a Session that is not yet open.

If a cached token is available, creates and opens the session and makes it active without any user interaction, otherwise this does nothing.

If allowLoginUI is true, this will create a new Session, make it active, and open it. If the default token cache is not available, then this will request basic permissions. If the default token cache is available and cached tokens are loaded, this will use the cached token and associated permissions.

If allowedLoginUI is false, this will only create the active session and open it if it requires no user interaction (i.e. the token cache is available and there are cached tokens).

If allowLoginUI is true, this will create a new Session, make it active, and open it. If the default token cache is not available, then this will request the permissions provided (and basic permissions of no permissions are provided). If the default token cache is available and cached tokens are loaded, this will use the cached token and associated permissions.

If allowedLoginUI is false, this will only create the active session and open it if it requires no user interaction (i.e. the token cache is available and there are cached tokens).

If allowLoginUI is true, this will create a new Session, make it active, and open it. If the default token cache is not available, then this will request basic permissions. If the default token cache is available and cached tokens are loaded, this will use the cached token and associated permissions.

If allowedLoginUI is false, this will only create the active session and open it if it requires no user interaction (i.e. the token cache is available and there are cached tokens).

If allowLoginUI is true, this will create a new Session, make it active, and open it. If the default token cache is not available, then this will request the permissions provided (and basic permissions of no permissions are provided). If the default token cache is available and cached tokens are loaded, this will use the cached token and associated permissions.

If allowedLoginUI is false, this will only create the active session and open it if it requires no user interaction (i.e. the token cache is available and there are cached tokens).

Opens a session based on an existing Facebook access token, and also makes this session the currently active session. This method should be used only in instances where an application has previously obtained an access token and wishes to import it into the Session/TokenCachingStrategy-based session-management system. A primary example would be an application which previously did not use the Facebook SDK for Android and implemented its own session-management scheme, but wishes to implement an upgrade path for existing users so they do not need to log in again when upgrading to a version of the app that uses the SDK. In general, this method will be called only once, when the app detects that it has been upgraded -- after that, the usual Session lifecycle methods should be used to manage the session and its associated token.

No validation is done that the token, token source, or permissions are actually valid. It is the caller's responsibility to ensure that these accurately reflect the state of the token that has been passed in, or calls to the Facebook API may fail.

Returns a Bundle containing data that was returned from Facebook during authorization.

Returns a boolean indicating whether the session is opened.

Returns the current state of the Session. See SessionState for details.

Returns the application id associated with this Session.

Returns the access token String.

Returns the Date at which the current token will expire.

Note that Session automatically attempts to extend the lifetime of Tokens as needed when Facebook requests are made.

Returns the list of permissions associated with the session.

If there is a valid token, this represents the permissions granted by that token. This can change during calls to Session.requestNewReadPermissions or Session.requestNewPublishPermissions.

 Returns whether a particular permission has been granted

Returns the list of permissions that have been requested in this session but not granted

Logs a user in to Facebook.

A session may not be used with Request and other classes in the SDK until it is open. If, prior to calling open, the session is in the CREATED_TOKEN_LOADED.CREATED_TOKEN_LOADED state, and the requested permissions are a subset of the previously authorized permissions, then the Session becomes usable immediately with no user interaction.

The permissions associated with the openRequest passed to this method must be read permissions only (or null/empty). It is not allowed to pass publish permissions to this method and will result in an exception being thrown.

Any open method must be called at most once, and cannot be called after the Session is closed. Calling the method at an invalid time will result in UnsuportedOperationException.

Logs a user in to Facebook.

A session may not be used with Request and other classes in the SDK until it is open. If, prior to calling open, the session is in the CREATED_TOKEN_LOADED.CREATED_TOKEN_LOADED state, and the requested permissions are a subset of the previously authorized permissions, then the Session becomes usable immediately with no user interaction.

The permissions associated with the openRequest passed to this method must be publish or manage permissions only and must be non-empty. Any read permissions will result in a warning, and may fail during server-side authorization. Also, an application must have at least basic read permissions prior to requesting publish permissions, so this method should only be used if the application knows that the user has already granted read permissions to the application; otherwise, openForRead should be used, followed by a call to requestNewPublishPermissions. For more information on this flow, see https://developers.facebook.com/docs/facebook-login/permissions/.

Any open method must be called at most once, and cannot be called after the Session is closed. Calling the method at an invalid time will result in UnsuportedOperationException.

Opens a session based on an existing Facebook access token. This method should be used only in instances where an application has previously obtained an access token and wishes to import it into the Session/TokenCachingStrategy-based session-management system. An example would be an application which previously did not use the Facebook SDK for Android and implemented its own session-management scheme, but wishes to implement an upgrade path for existing users so they do not need to log in again when upgrading to a version of the app that uses the SDK.

No validation is done that the token, token source, or permissions are actually valid. It is the caller's responsibility to ensure that these accurately reflect the state of the token that has been passed in, or calls to the Facebook API may fail.

Issues a request to add new read permissions to the Session.

If successful, this will update the set of permissions on this session to match the newPermissions. If this fails, the Session remains unchanged.

The permissions associated with the newPermissionsRequest passed to this method must be read permissions only (or null/empty). It is not allowed to pass publish permissions to this method and will result in an exception being thrown.

Issues a request to add new publish or manage permissions to the Session.

If successful, this will update the set of permissions on this session to match the newPermissions. If this fails, the Session remains unchanged.

The permissions associated with the newPermissionsRequest passed to this method must be publish or manage permissions only and must be non-empty. Any read permissions will result in a warning, and may fail during server-side authorization.

Issues a request to refresh the permissions on the session.

If successful, this will update the permissions and call the app back with SessionState.OPENED_TOKEN_UPDATED. The session can then be queried to see the granted and declined permissions. If this fails because the user has removed the app, the session will close.

Provides an implementation for onActivityResult.onActivityResult that updates the Session based on information returned during the authorization flow. The Activity that calls open or requestNewPermissions should forward the resulting onActivityResult call here to update the Session state based on the contents of the resultCode and data.

Closes the local in-memory Session object, but does not clear the persisted token cache.

Closes the local in-memory Session object and clears any persisted token cache related to the Session.

Adds a callback that will be called when the state of this Session changes.

Removes a StatusCallback from this Session.