com.facebook.share.internal

Class ShareInternalUtility

java.lang.Object

com.facebook.share.internal.ShareInternalUtility

public final class ShareInternalUtility
extends java.lang.Object

com.facebook.share.internal is solely for the use of other packages within the Facebook SDK for Android. Use of any of the classes in this package is unsupported, and they may be modified or removed without warning at any time.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MY_PHOTOS

Method Summary

Modifier and Type	Method and Description
static android.util.Pair<java.lang.String,java.lang.String>	getFieldNameAndNamespaceFromFullName(java.lang.String fullName)
static LikeView.ObjectType	getMostSpecificObjectType(LikeView.ObjectType objectType1, LikeView.ObjectType objectType2)
static java.lang.String	getNativeDialogCompletionGesture(android.os.Bundle result) Returns the gesture with which the user completed the native dialog.
static boolean	getNativeDialogDidComplete(android.os.Bundle result) Determines whether the native dialog completed normally (without error or exception).
static java.util.List<java.lang.String>	getPhotoUrls(SharePhotoContent photoContent, java.util.UUID appCallId)
static java.lang.String	getShareDialogPostId(android.os.Bundle result) Returns the id of the published post.
static ResultProcessor	getShareResultProcessor(FacebookCallback<Sharer.Result> callback)
static java.lang.String	getVideoUrl(ShareVideoContent videoContent, java.util.UUID appCallId)
static boolean	handleActivityResult(int requestCode, int resultCode, android.content.Intent data, ResultProcessor resultProcessor)
static void	invokeCallbackWithError(FacebookCallback<Sharer.Result> callback, java.lang.String error)
static void	invokeCallbackWithException(FacebookCallback<Sharer.Result> callback, java.lang.Exception exception)
static void	invokeCallbackWithResults(FacebookCallback<Sharer.Result> callback, java.lang.String postId, GraphResponse graphResponse)
static GraphRequest	newPostOpenGraphActionRequest(AccessToken accessToken, org.json.JSONObject openGraphAction, GraphRequest.Callback callback) Creates a new Request configured to publish an Open Graph action.
static GraphRequest	newPostOpenGraphObjectRequest(AccessToken accessToken, org.json.JSONObject openGraphObject, GraphRequest.Callback callback) Creates a new Request configured to create a user owned Open Graph object.
static GraphRequest	newPostOpenGraphObjectRequest(AccessToken accessToken, java.lang.String type, java.lang.String title, java.lang.String imageUrl, java.lang.String url, java.lang.String description, org.json.JSONObject objectProperties, GraphRequest.Callback callback) Creates a new Request configured to create a user owned Open Graph object.
static GraphRequest	newStatusUpdateRequest(AccessToken accessToken, java.lang.String message, GraphRequest.Callback callback) Creates a new Request configured to post a status update to a user's feed.
static GraphRequest	newStatusUpdateRequest(AccessToken accessToken, java.lang.String message, org.json.JSONObject place, java.util.List<org.json.JSONObject> tags, GraphRequest.Callback callback) Creates a new Request configured to post a status update to a user's feed.
static GraphRequest	newUpdateOpenGraphObjectRequest(AccessToken accessToken, org.json.JSONObject openGraphObject, GraphRequest.Callback callback) Creates a new Request configured to update a user owned Open Graph object.
static GraphRequest	newUpdateOpenGraphObjectRequest(AccessToken accessToken, java.lang.String id, java.lang.String title, java.lang.String imageUrl, java.lang.String url, java.lang.String description, org.json.JSONObject objectProperties, GraphRequest.Callback callback) Creates a new Request configured to update a user owned Open Graph object.
static GraphRequest	newUploadPhotoRequest(java.lang.String graphPath, AccessToken accessToken, android.graphics.Bitmap image, java.lang.String caption, android.os.Bundle params, GraphRequest.Callback callback) Creates a new Request configured to upload a photo to the specified graph path.
static GraphRequest	newUploadPhotoRequest(java.lang.String graphPath, AccessToken accessToken, java.io.File file, java.lang.String caption, android.os.Bundle params, GraphRequest.Callback callback) Creates a new Request configured to upload a photo to the specified graph path.
static GraphRequest	newUploadPhotoRequest(java.lang.String graphPath, AccessToken accessToken, android.net.Uri photoUri, java.lang.String caption, android.os.Bundle params, GraphRequest.Callback callback) Creates a new Request configured to upload a photo to the specified graph path.
static GraphRequest	newUploadStagingResourceWithImageRequest(AccessToken accessToken, android.graphics.Bitmap image, GraphRequest.Callback callback) Creates a new Request configured to upload an image to create a staging resource.
static GraphRequest	newUploadStagingResourceWithImageRequest(AccessToken accessToken, java.io.File file, GraphRequest.Callback callback) Creates a new Request configured to upload an image to create a staging resource.
static GraphRequest	newUploadStagingResourceWithImageRequest(AccessToken accessToken, android.net.Uri imageUri, GraphRequest.Callback callback) Creates a new Request configured to upload an image to create a staging resource.
static void	registerSharerCallback(int requestCode, CallbackManager callbackManager, FacebookCallback<Sharer.Result> callback)
static void	registerStaticShareCallback(int requestCode)
static org.json.JSONArray	removeNamespacesFromOGJsonArray(org.json.JSONArray jsonArray, boolean requireNamespace)
static org.json.JSONObject	removeNamespacesFromOGJsonObject(org.json.JSONObject jsonObject, boolean requireNamespace)
static org.json.JSONObject	toJSONObjectForCall(java.util.UUID callId, ShareOpenGraphContent content)
static org.json.JSONObject	toJSONObjectForWeb(ShareOpenGraphContent shareOpenGraphContent)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MY_PHOTOS

public static final java.lang.String MY_PHOTOS

See Also:

Constant Field Values

Method Detail

invokeCallbackWithException

public static void invokeCallbackWithException(FacebookCallback<Sharer.Result> callback,
                                               java.lang.Exception exception)

invokeCallbackWithError

public static void invokeCallbackWithError(FacebookCallback<Sharer.Result> callback,
                                           java.lang.String error)

invokeCallbackWithResults

public static void invokeCallbackWithResults(FacebookCallback<Sharer.Result> callback,
                                             java.lang.String postId,
                                             GraphResponse graphResponse)

getNativeDialogDidComplete

public static boolean getNativeDialogDidComplete(android.os.Bundle result)

Determines whether the native dialog completed normally (without error or exception).

Parameters:

result - the bundle passed back to onActivityResult

Returns:

true if the native dialog completed normally

getNativeDialogCompletionGesture

public static java.lang.String getNativeDialogCompletionGesture(android.os.Bundle result)

Returns the gesture with which the user completed the native dialog. This is only returned if the user has previously authorized the calling app with basic permissions.

Parameters:

result - the bundle passed back to onActivityResult

Returns:

"post" or "cancel" as the completion gesture

getShareDialogPostId

public static java.lang.String getShareDialogPostId(android.os.Bundle result)

Returns the id of the published post. This is only returned if the user has previously given the app publish permissions.

Parameters:

result - the bundle passed back to onActivityResult

Returns:

the id of the published post

handleActivityResult

public static boolean handleActivityResult(int requestCode,
                                           int resultCode,
                                           android.content.Intent data,
                                           ResultProcessor resultProcessor)

getShareResultProcessor

public static ResultProcessor getShareResultProcessor(FacebookCallback<Sharer.Result> callback)

registerStaticShareCallback

public static void registerStaticShareCallback(int requestCode)

registerSharerCallback

public static void registerSharerCallback(int requestCode,
                                          CallbackManager callbackManager,
                                          FacebookCallback<Sharer.Result> callback)

getPhotoUrls

public static java.util.List<java.lang.String> getPhotoUrls(SharePhotoContent photoContent,
                                                            java.util.UUID appCallId)

getVideoUrl

public static java.lang.String getVideoUrl(ShareVideoContent videoContent,
                                           java.util.UUID appCallId)

toJSONObjectForCall

public static org.json.JSONObject toJSONObjectForCall(java.util.UUID callId,
                                                      ShareOpenGraphContent content)
                                               throws org.json.JSONException

Throws:

org.json.JSONException

toJSONObjectForWeb

public static org.json.JSONObject toJSONObjectForWeb(ShareOpenGraphContent shareOpenGraphContent)
                                              throws org.json.JSONException

Throws:

org.json.JSONException

removeNamespacesFromOGJsonArray

public static org.json.JSONArray removeNamespacesFromOGJsonArray(org.json.JSONArray jsonArray,
                                                                 boolean requireNamespace)
                                                          throws org.json.JSONException

Throws:

org.json.JSONException

removeNamespacesFromOGJsonObject

public static org.json.JSONObject removeNamespacesFromOGJsonObject(org.json.JSONObject jsonObject,
                                                                   boolean requireNamespace)

getFieldNameAndNamespaceFromFullName

public static android.util.Pair<java.lang.String,java.lang.String> getFieldNameAndNamespaceFromFullName(java.lang.String fullName)

newPostOpenGraphObjectRequest

public static GraphRequest newPostOpenGraphObjectRequest(AccessToken accessToken,
                                                         org.json.JSONObject openGraphObject,
                                                         GraphRequest.Callback callback)

Creates a new Request configured to create a user owned Open Graph object.

Parameters:

accessToken - the accessToken to use, or null

openGraphObject - the Open Graph object to create; must not be null, and must have a non-empty type and title

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newPostOpenGraphObjectRequest

public static GraphRequest newPostOpenGraphObjectRequest(AccessToken accessToken,
                                                         java.lang.String type,
                                                         java.lang.String title,
                                                         java.lang.String imageUrl,
                                                         java.lang.String url,
                                                         java.lang.String description,
                                                         org.json.JSONObject objectProperties,
                                                         GraphRequest.Callback callback)

Creates a new Request configured to create a user owned Open Graph object.

Parameters:

accessToken - the access token to use, or null

type - the fully-specified Open Graph object type (e.g., my_app_namespace:my_object_name); must not be null

title - the title of the Open Graph object; must not be null

imageUrl - the link to an image to be associated with the Open Graph object; may be null

url - the url to be associated with the Open Graph object; may be null

description - the description to be associated with the object; may be null

objectProperties - any additional type-specific properties for the Open Graph object; may be null

callback - a callback that will be called when the request is completed to handle success or error conditions; may be null

Returns:

a Request that is ready to execute

newPostOpenGraphActionRequest

public static GraphRequest newPostOpenGraphActionRequest(AccessToken accessToken,
                                                         org.json.JSONObject openGraphAction,
                                                         GraphRequest.Callback callback)

Creates a new Request configured to publish an Open Graph action.

Parameters:

accessToken - the access token to use, or null

openGraphAction - the Open Graph action to create; must not be null, and must have a non-empty 'type'

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUpdateOpenGraphObjectRequest

public static GraphRequest newUpdateOpenGraphObjectRequest(AccessToken accessToken,
                                                           org.json.JSONObject openGraphObject,
                                                           GraphRequest.Callback callback)

Creates a new Request configured to update a user owned Open Graph object.

Parameters:

accessToken - the access token to use, or null

openGraphObject - the Open Graph object to update, which must have a valid 'id' property

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUpdateOpenGraphObjectRequest

public static GraphRequest newUpdateOpenGraphObjectRequest(AccessToken accessToken,
                                                           java.lang.String id,
                                                           java.lang.String title,
                                                           java.lang.String imageUrl,
                                                           java.lang.String url,
                                                           java.lang.String description,
                                                           org.json.JSONObject objectProperties,
                                                           GraphRequest.Callback callback)

Creates a new Request configured to update a user owned Open Graph object.

Parameters:

accessToken - the access token to use, or null

id - the id of the Open Graph object

title - the title of the Open Graph object

imageUrl - the link to an image to be associated with the Open Graph object

url - the url to be associated with the Open Graph object

description - the description to be associated with the object

objectProperties - any additional type-specific properties for the Open Graph object

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUploadPhotoRequest

public static GraphRequest newUploadPhotoRequest(java.lang.String graphPath,
                                                 AccessToken accessToken,
                                                 android.graphics.Bitmap image,
                                                 java.lang.String caption,
                                                 android.os.Bundle params,
                                                 GraphRequest.Callback callback)

Creates a new Request configured to upload a photo to the specified graph path.

Parameters:

graphPath - the graph path to use

accessToken - the access token to use, or null

image - the image to upload

caption - the user generated caption for the photo.

params - the parameters

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUploadPhotoRequest

public static GraphRequest newUploadPhotoRequest(java.lang.String graphPath,
                                                 AccessToken accessToken,
                                                 java.io.File file,
                                                 java.lang.String caption,
                                                 android.os.Bundle params,
                                                 GraphRequest.Callback callback)
                                          throws java.io.FileNotFoundException

Creates a new Request configured to upload a photo to the specified graph path. The photo will be read from the specified file.

Parameters:

graphPath - the graph path to use

accessToken - the access token to use, or null

file - the file containing the photo to upload

caption - the user generated caption for the photo.

params - the parameters

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

Throws:

java.io.FileNotFoundException

newUploadPhotoRequest

public static GraphRequest newUploadPhotoRequest(java.lang.String graphPath,
                                                 AccessToken accessToken,
                                                 android.net.Uri photoUri,
                                                 java.lang.String caption,
                                                 android.os.Bundle params,
                                                 GraphRequest.Callback callback)
                                          throws java.io.FileNotFoundException

Creates a new Request configured to upload a photo to the specified graph path. The photo will be read from the specified Uri.

Parameters:

graphPath - the graph path to use

accessToken - the access token to use, or null

photoUri - the file:// or content:// Uri to the photo on device.

caption - the user generated caption for the photo.

params - the parameters

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

Throws:

java.io.FileNotFoundException

newStatusUpdateRequest

public static GraphRequest newStatusUpdateRequest(AccessToken accessToken,
                                                  java.lang.String message,
                                                  GraphRequest.Callback callback)

Creates a new Request configured to post a status update to a user's feed.

Parameters:

accessToken - the access token to use, or null

message - the text of the status update

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newStatusUpdateRequest

public static GraphRequest newStatusUpdateRequest(AccessToken accessToken,
                                                  java.lang.String message,
                                                  org.json.JSONObject place,
                                                  java.util.List<org.json.JSONObject> tags,
                                                  GraphRequest.Callback callback)

Creates a new Request configured to post a status update to a user's feed.

Parameters:

accessToken - the access token to use, or null

message - the text of the status update

place - an optional place to associate with the post

tags - an optional list of users to tag in the post

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUploadStagingResourceWithImageRequest

public static GraphRequest newUploadStagingResourceWithImageRequest(AccessToken accessToken,
                                                                    android.graphics.Bitmap image,
                                                                    GraphRequest.Callback callback)

Creates a new Request configured to upload an image to create a staging resource. Staging resources allow you to post binary data such as images, in preparation for a post of an Open Graph object or action which references the image. The URI returned when uploading a staging resource may be passed as the image property for an Open Graph object or action.

Parameters:

accessToken - the access token to use, or null

image - the image to upload

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

newUploadStagingResourceWithImageRequest

public static GraphRequest newUploadStagingResourceWithImageRequest(AccessToken accessToken,
                                                                    java.io.File file,
                                                                    GraphRequest.Callback callback)
                                                             throws java.io.FileNotFoundException

Creates a new Request configured to upload an image to create a staging resource. Staging resources allow you to post binary data such as images, in preparation for a post of an Open Graph object or action which references the image. The URI returned when uploading a staging resource may be passed as the image property for an Open Graph object or action.

Parameters:

accessToken - the access token to use, or null

file - the file containing the image to upload

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

Throws:

java.io.FileNotFoundException

newUploadStagingResourceWithImageRequest

public static GraphRequest newUploadStagingResourceWithImageRequest(AccessToken accessToken,
                                                                    android.net.Uri imageUri,
                                                                    GraphRequest.Callback callback)
                                                             throws java.io.FileNotFoundException

Creates a new Request configured to upload an image to create a staging resource. Staging resources allow you to post binary data such as images, in preparation for a post of an Open Graph object or action which references the image. The URI returned when uploading a staging resource may be passed as the image property for an Open Graph object or action.

Parameters:

accessToken - the access token to use, or null

imageUri - the file:// or content:// Uri pointing to the image to upload

callback - a callback that will be called when the request is completed to handle success or error conditions

Returns:

a Request that is ready to execute

Throws:

java.io.FileNotFoundException

getMostSpecificObjectType

public static LikeView.ObjectType getMostSpecificObjectType(LikeView.ObjectType objectType1,
                                                            LikeView.ObjectType objectType2)