com.facebook.internal

Class Utility

java.lang.Object

com.facebook.internal.Utility

public final class Utility
extends java.lang.Object

com.facebook.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.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Utility.GraphMeRequestWithCacheCallback
static interface	Utility.Mapper<T,K>
static class	Utility.PermissionsPair Internal helper class that is used to hold two different permission lists (granted and declined)
static interface	Utility.Predicate<T>

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_STREAM_BUFFER_SIZE

Constructor Summary

Constructors

Constructor and Description
Utility()

Method Summary

Modifier and Type	Method and Description
static <T> boolean	areObjectsEqual(T a, T b)
static <T> java.util.ArrayList<T>	arrayList(T... ts)
static <T> java.util.List<T>	asListNoNulls(T... array)
static org.json.JSONObject	awaitGetGraphMeRequestWithCache(java.lang.String accessToken)
static android.net.Uri	buildUri(java.lang.String authority, java.lang.String path, android.os.Bundle parameters)
static void	clearCaches(android.content.Context context)
static void	clearFacebookCookies(android.content.Context context)
static void	closeQuietly(java.io.Closeable closeable)
static java.lang.String	coerceValueIfNullOrEmpty(java.lang.String s, java.lang.String valueIfNullOrEmpty) Use this when you want to normalize empty and null strings This way, Utility.areObjectsEqual can used for comparison, where a null string is to be treated the same as an empty string.
static int	copyAndCloseInputStream(java.io.InputStream inputStream, java.io.OutputStream outputStream)
static void	deleteDirectory(java.io.File directoryOrFile)
static void	disconnectQuietly(java.net.URLConnection connection)
static <T> java.util.List<T>	filter(java.util.List<T> target, Utility.Predicate<T> predicate)
static java.lang.String	generateRandomString(int length)
static java.lang.String	getActivityName(android.content.Context context) Returns the name of the current activity if the context is an activity, otherwise return "unknown"
static java.util.Date	getBundleLongAsDate(android.os.Bundle bundle, java.lang.String key, java.util.Date dateBase)
static long	getContentSize(android.net.Uri contentUri)
static void	getGraphMeRequestWithCacheAsync(java.lang.String accessToken, Utility.GraphMeRequestWithCacheCallback callback)
static java.lang.String	getMetadataApplicationId(android.content.Context context)
static java.lang.reflect.Method	getMethodQuietly(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<?>... parameterTypes)
static java.lang.reflect.Method	getMethodQuietly(java.lang.String className, java.lang.String methodName, java.lang.Class<?>... parameterTypes)
static java.lang.Object	getStringPropertyAsJSON(org.json.JSONObject jsonObject, java.lang.String key, java.lang.String nonJSONPropertyKey)
static java.lang.String	getUriString(android.net.Uri uri)
static Utility.PermissionsPair	handlePermissionResponse(org.json.JSONObject result)
static <T> java.util.HashSet<T>	hashSet(T... ts)
static boolean	hasSameId(org.json.JSONObject a, org.json.JSONObject b)
static int[]	intersectRanges(int[] range1, int[] range2) Each array represents a set of closed or open Range, like so: [0,10,50,60] - Ranges are {0-9}, {50-59} [20] - Ranges are {20-} [30,40,100] - Ranges are {30-39}, {100-} All Ranges in the array have a closed lower bound.
static java.lang.Object	invokeMethodQuietly(java.lang.Object receiver, java.lang.reflect.Method method, java.lang.Object... args)
static boolean	isContentUri(android.net.Uri uri)
static boolean	isCurrentAccessToken(AccessToken token)
static boolean	isFileUri(android.net.Uri uri)
static <T> boolean	isNullOrEmpty(java.util.Collection<T> c)
static boolean	isNullOrEmpty(java.lang.String s)
static <T> boolean	isSubset(java.util.Collection<T> subset, java.util.Collection<T> superset)
static boolean	isWebUri(android.net.Uri uri)
static java.util.Set<java.lang.String>	jsonArrayToSet(org.json.JSONArray jsonArray)
static java.util.List<java.lang.String>	jsonArrayToStringList(org.json.JSONArray jsonArray)
static void	logd(java.lang.String tag, java.lang.Exception e)
static void	logd(java.lang.String tag, java.lang.String msg)
static void	logd(java.lang.String tag, java.lang.String msg, java.lang.Throwable t)
static <T,K> java.util.List<K>	map(java.util.List<T> target, Utility.Mapper<T,K> mapper)
static java.lang.String	md5hash(java.lang.String key)
static android.os.Bundle	parseUrlQueryString(java.lang.String queryString)
static void	putCommaSeparatedStringList(android.os.Bundle b, java.lang.String key, java.util.List<java.lang.String> list)
static boolean	putJSONValueInBundle(android.os.Bundle bundle, java.lang.String key, java.lang.Object value)
static void	putNonEmptyString(android.os.Bundle b, java.lang.String key, java.lang.String value)
static void	putUri(android.os.Bundle b, java.lang.String key, android.net.Uri uri)
static java.lang.String	readStreamToString(java.io.InputStream inputStream)
static java.util.Map<java.lang.String,java.lang.String>	readStringMapFromParcel(android.os.Parcel parcel)
static java.lang.String	safeGetStringFromResponse(org.json.JSONObject response, java.lang.String propertyName)
static void	setAppEventAttributionParameters(org.json.JSONObject params, AttributionIdentifiers attributionIdentifiers, java.lang.String anonymousAppDeviceGUID, boolean limitEventUsage)
static void	setAppEventExtendedDeviceInfoParameters(org.json.JSONObject params, android.content.Context appContext)
static java.lang.String	sha1hash(byte[] bytes)
static java.lang.String	sha1hash(java.lang.String key)
static boolean	stringsEqualOrEmpty(java.lang.String a, java.lang.String b)
static org.json.JSONArray	tryGetJSONArrayFromResponse(org.json.JSONObject response, java.lang.String propertyKey)
static org.json.JSONObject	tryGetJSONObjectFromResponse(org.json.JSONObject response, java.lang.String propertyKey)
static <T> java.util.Collection<T>	unmodifiableCollection(T... ts)
static void	writeStringMapToParcel(android.os.Parcel parcel, java.util.Map<java.lang.String,java.lang.String> map)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_STREAM_BUFFER_SIZE

public static final int DEFAULT_STREAM_BUFFER_SIZE

See Also:

Constant Field Values

Constructor Detail

Utility

public Utility()

Method Detail

intersectRanges

public static int[] intersectRanges(int[] range1,
                                    int[] range2)

Each array represents a set of closed or open Range, like so: [0,10,50,60] - Ranges are {0-9}, {50-59} [20] - Ranges are {20-} [30,40,100] - Ranges are {30-39}, {100-}

All Ranges in the array have a closed lower bound. Only the last Range in each array may be open. It is assumed that the passed in arrays are sorted with ascending order. It is assumed that no two elements in a given are equal (i.e. no 0-length ranges)

The method returns an intersect of the two passed in Range-sets

Parameters:

range1 - The first range

range2 - The second range

Returns:

The intersection of the two ranges.

isSubset

public static <T> boolean isSubset(java.util.Collection<T> subset,
                                   java.util.Collection<T> superset)

isNullOrEmpty

public static <T> boolean isNullOrEmpty(java.util.Collection<T> c)

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.String s)

coerceValueIfNullOrEmpty

public static java.lang.String coerceValueIfNullOrEmpty(java.lang.String s,
                                                        java.lang.String valueIfNullOrEmpty)

Use this when you want to normalize empty and null strings This way, Utility.areObjectsEqual can used for comparison, where a null string is to be treated the same as an empty string.

Parameters:

s - The string to coerce

valueIfNullOrEmpty - The value if s is null or empty.

Returns:

The original string s if it's not null or empty, otherwise the valueIfNullOrEmpty

unmodifiableCollection

public static <T> java.util.Collection<T> unmodifiableCollection(T... ts)

arrayList

public static <T> java.util.ArrayList<T> arrayList(T... ts)

hashSet

public static <T> java.util.HashSet<T> hashSet(T... ts)

md5hash

public static java.lang.String md5hash(java.lang.String key)

sha1hash

public static java.lang.String sha1hash(java.lang.String key)

sha1hash

public static java.lang.String sha1hash(byte[] bytes)

buildUri

public static android.net.Uri buildUri(java.lang.String authority,
                                       java.lang.String path,
                                       android.os.Bundle parameters)

parseUrlQueryString

public static android.os.Bundle parseUrlQueryString(java.lang.String queryString)

putNonEmptyString

public static void putNonEmptyString(android.os.Bundle b,
                                     java.lang.String key,
                                     java.lang.String value)

putCommaSeparatedStringList

public static void putCommaSeparatedStringList(android.os.Bundle b,
                                               java.lang.String key,
                                               java.util.List<java.lang.String> list)

putUri

public static void putUri(android.os.Bundle b,
                          java.lang.String key,
                          android.net.Uri uri)

putJSONValueInBundle

public static boolean putJSONValueInBundle(android.os.Bundle bundle,
                                           java.lang.String key,
                                           java.lang.Object value)

closeQuietly

public static void closeQuietly(java.io.Closeable closeable)

disconnectQuietly

public static void disconnectQuietly(java.net.URLConnection connection)

getMetadataApplicationId

public static java.lang.String getMetadataApplicationId(android.content.Context context)

getStringPropertyAsJSON

public static java.lang.Object getStringPropertyAsJSON(org.json.JSONObject jsonObject,
                                                       java.lang.String key,
                                                       java.lang.String nonJSONPropertyKey)
                                                throws org.json.JSONException

Throws:

org.json.JSONException

readStreamToString

public static java.lang.String readStreamToString(java.io.InputStream inputStream)
                                           throws java.io.IOException

Throws:

java.io.IOException

copyAndCloseInputStream

public static int copyAndCloseInputStream(java.io.InputStream inputStream,
                                          java.io.OutputStream outputStream)
                                   throws java.io.IOException

Throws:

java.io.IOException

stringsEqualOrEmpty

public static boolean stringsEqualOrEmpty(java.lang.String a,
                                          java.lang.String b)

clearFacebookCookies

public static void clearFacebookCookies(android.content.Context context)

logd

public static void logd(java.lang.String tag,
                        java.lang.Exception e)

logd

public static void logd(java.lang.String tag,
                        java.lang.String msg)

logd

public static void logd(java.lang.String tag,
                        java.lang.String msg,
                        java.lang.Throwable t)

areObjectsEqual

public static <T> boolean areObjectsEqual(T a,
                                          T b)

hasSameId

public static boolean hasSameId(org.json.JSONObject a,
                                org.json.JSONObject b)

safeGetStringFromResponse

public static java.lang.String safeGetStringFromResponse(org.json.JSONObject response,
                                                         java.lang.String propertyName)

tryGetJSONObjectFromResponse

public static org.json.JSONObject tryGetJSONObjectFromResponse(org.json.JSONObject response,
                                                               java.lang.String propertyKey)

tryGetJSONArrayFromResponse

public static org.json.JSONArray tryGetJSONArrayFromResponse(org.json.JSONObject response,
                                                             java.lang.String propertyKey)

clearCaches

public static void clearCaches(android.content.Context context)

deleteDirectory

public static void deleteDirectory(java.io.File directoryOrFile)

asListNoNulls

public static <T> java.util.List<T> asListNoNulls(T... array)

jsonArrayToStringList

public static java.util.List<java.lang.String> jsonArrayToStringList(org.json.JSONArray jsonArray)
                                                              throws org.json.JSONException

Throws:

org.json.JSONException

jsonArrayToSet

public static java.util.Set<java.lang.String> jsonArrayToSet(org.json.JSONArray jsonArray)
                                                      throws org.json.JSONException

Throws:

org.json.JSONException

setAppEventAttributionParameters

public static void setAppEventAttributionParameters(org.json.JSONObject params,
                                                    AttributionIdentifiers attributionIdentifiers,
                                                    java.lang.String anonymousAppDeviceGUID,
                                                    boolean limitEventUsage)
                                             throws org.json.JSONException

Throws:

org.json.JSONException

setAppEventExtendedDeviceInfoParameters

public static void setAppEventExtendedDeviceInfoParameters(org.json.JSONObject params,
                                                           android.content.Context appContext)
                                                    throws org.json.JSONException

Throws:

org.json.JSONException

getMethodQuietly

public static java.lang.reflect.Method getMethodQuietly(java.lang.Class<?> clazz,
                                                        java.lang.String methodName,
                                                        java.lang.Class<?>... parameterTypes)

getMethodQuietly

public static java.lang.reflect.Method getMethodQuietly(java.lang.String className,
                                                        java.lang.String methodName,
                                                        java.lang.Class<?>... parameterTypes)

invokeMethodQuietly

public static java.lang.Object invokeMethodQuietly(java.lang.Object receiver,
                                                   java.lang.reflect.Method method,
                                                   java.lang.Object... args)

getActivityName

public static java.lang.String getActivityName(android.content.Context context)

Returns the name of the current activity if the context is an activity, otherwise return "unknown"

filter

public static <T> java.util.List<T> filter(java.util.List<T> target,
                                           Utility.Predicate<T> predicate)

map

public static <T,K> java.util.List<K> map(java.util.List<T> target,
                                          Utility.Mapper<T,K> mapper)

getUriString

public static java.lang.String getUriString(android.net.Uri uri)

isWebUri

public static boolean isWebUri(android.net.Uri uri)

isContentUri

public static boolean isContentUri(android.net.Uri uri)

isFileUri

public static boolean isFileUri(android.net.Uri uri)

getContentSize

public static long getContentSize(android.net.Uri contentUri)

getBundleLongAsDate

public static java.util.Date getBundleLongAsDate(android.os.Bundle bundle,
                                                 java.lang.String key,
                                                 java.util.Date dateBase)

writeStringMapToParcel

public static void writeStringMapToParcel(android.os.Parcel parcel,
                                          java.util.Map<java.lang.String,java.lang.String> map)

readStringMapFromParcel

public static java.util.Map<java.lang.String,java.lang.String> readStringMapFromParcel(android.os.Parcel parcel)

isCurrentAccessToken

public static boolean isCurrentAccessToken(AccessToken token)

getGraphMeRequestWithCacheAsync

public static void getGraphMeRequestWithCacheAsync(java.lang.String accessToken,
                                                   Utility.GraphMeRequestWithCacheCallback callback)

awaitGetGraphMeRequestWithCache

public static org.json.JSONObject awaitGetGraphMeRequestWithCache(java.lang.String accessToken)

handlePermissionResponse

public static Utility.PermissionsPair handlePermissionResponse(org.json.JSONObject result)
                                                        throws org.json.JSONException

Throws:

org.json.JSONException

generateRandomString

public static java.lang.String generateRandomString(int length)