com.segment.analytics.internal

Class Utils

java.lang.Object

com.segment.analytics.internal.Utils

public final class Utils
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Utils.AnalyticsExecutorService A ThreadPoolExecutor implementation by Analytics instances.
static class	Utils.AnalyticsThreadFactory
static class	Utils.NullableConcurrentHashMap<K,V> A ConcurrentHashMap that rejects null keys and values instead of failing.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_COLLECT_DEVICE_ID
static int	DEFAULT_FLUSH_INTERVAL
static int	DEFAULT_FLUSH_QUEUE_SIZE
static java.lang.String	THREAD_PREFIX

Method Summary

Modifier and Type	Method and Description
static java.io.BufferedReader	buffer(java.io.InputStream is) Buffers the given InputStream.
static void	closeQuietly(java.io.Closeable closeable) Close the given Closeable.
static float	coerceToFloat(java.lang.Object value, float defaultValue) Returns the float representation at value if it exists and is a float or can be coerced to a float.
static void	createDirectory(java.io.File location) Ensures that a directory is created in the given location, throws an IOException otherwise.
static <T> java.util.Map<java.lang.String,T>	createMap()
static java.lang.String	getDeviceId(android.content.Context context) Creates a unique device id.
static java.lang.String	getResourceString(android.content.Context context, java.lang.String key) Get the string resource for the given key.
static android.content.SharedPreferences	getSegmentSharedPreferences(android.content.Context context) Returns a shared preferences for storing any library preferences.
static <T> T	getSystemService(android.content.Context context, java.lang.String serviceConstant) Returns the system service for the given string.
static boolean	hasFeature(android.content.Context context, java.lang.String feature) Returns true if the application has the given feature.
static boolean	hasPermission(android.content.Context context, java.lang.String permission) Returns true if the application has the given permission.
static boolean	isConnected(android.content.Context context) Returns true if the phone is connected to a network, or if we don't have the enough permissions.
static boolean	isNullOrEmpty(java.lang.CharSequence text) Returns true if the string is null, or empty (once trimmed).
static boolean	isNullOrEmpty(java.util.Collection collection) Returns true if the collection or has a size 0.
static boolean	isNullOrEmpty(java.util.Map map) Returns true if the map is null or empty, false otherwise.
static boolean	isOnClassPath(java.lang.String className) Return true if a class with the given name is found.
static <T> java.util.Set<T>	newSet(T... values) Creates a mutable HashSet instance containing the given elements in unspecified order
static java.lang.String	readFully(java.io.BufferedReader reader) Reads the give BufferedReader into a String.
static java.lang.String	readFully(java.io.InputStream is) Reads the give InputStream into a String.
static java.lang.String	toISO8601Date(java.util.Date date) Returns the date as a string formatted with ISO_8601_DATE_FORMAT.
static java.util.Date	toISO8601Date(java.lang.String date) Returns the string as a date parsed with ISO_8601_DATE_FORMAT.
static org.json.JSONObject	toJsonObject(java.util.Map<java.lang.String,?> map) Return a copy of the contents of the given map as a JSONObject.
static <T> java.util.Map<java.lang.String,T>	transform(java.util.Map<java.lang.String,T> in, java.util.Map<java.lang.String,java.lang.String> mapper) Transforms the given map by replacing the keys mapped by mapper.

Methods inherited from class java.lang.Object

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

Field Detail

THREAD_PREFIX

public static final java.lang.String THREAD_PREFIX

See Also:

Constant Field Values

DEFAULT_FLUSH_INTERVAL

public static final int DEFAULT_FLUSH_INTERVAL

See Also:

Constant Field Values

DEFAULT_FLUSH_QUEUE_SIZE

public static final int DEFAULT_FLUSH_QUEUE_SIZE

See Also:

Constant Field Values

DEFAULT_COLLECT_DEVICE_ID

public static final boolean DEFAULT_COLLECT_DEVICE_ID

See Also:

Constant Field Values

Method Detail

newSet

public static <T> java.util.Set<T> newSet(T... values)

Creates a mutable HashSet instance containing the given elements in unspecified order

toISO8601Date

public static java.lang.String toISO8601Date(java.util.Date date)

Returns the date as a string formatted with ISO_8601_DATE_FORMAT.

toISO8601Date

public static java.util.Date toISO8601Date(java.lang.String date)
                                    throws java.text.ParseException

Returns the string as a date parsed with ISO_8601_DATE_FORMAT.

Throws:

java.text.ParseException

coerceToFloat

public static float coerceToFloat(java.lang.Object value,
                                  float defaultValue)

Returns the float representation at value if it exists and is a float or can be coerced to a float. Returns defaultValue otherwise.

hasPermission

public static boolean hasPermission(android.content.Context context,
                                    java.lang.String permission)

Returns true if the application has the given permission.

hasFeature

public static boolean hasFeature(android.content.Context context,
                                 java.lang.String feature)

Returns true if the application has the given feature.

getSystemService

public static <T> T getSystemService(android.content.Context context,
                                     java.lang.String serviceConstant)

Returns the system service for the given string.

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.CharSequence text)

Returns true if the string is null, or empty (once trimmed).

isNullOrEmpty

public static boolean isNullOrEmpty(java.util.Collection collection)

Returns true if the collection or has a size 0.

isNullOrEmpty

public static boolean isNullOrEmpty(java.util.Map map)

Returns true if the map is null or empty, false otherwise.

getDeviceId

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

Creates a unique device id.

getSegmentSharedPreferences

public static android.content.SharedPreferences getSegmentSharedPreferences(android.content.Context context)

Returns a shared preferences for storing any library preferences.

getResourceString

public static java.lang.String getResourceString(android.content.Context context,
                                                 java.lang.String key)

Get the string resource for the given key. Returns null if not found.

isConnected

public static boolean isConnected(android.content.Context context)

Returns true if the phone is connected to a network, or if we don't have the enough permissions. Returns false otherwise.

isOnClassPath

public static boolean isOnClassPath(java.lang.String className)

Return true if a class with the given name is found.

closeQuietly

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

Close the given Closeable. If an exception is thrown during Closeable.close(), this will quietly ignore it. Does nothing if closeable is null.

buffer

public static java.io.BufferedReader buffer(java.io.InputStream is)

Buffers the given InputStream.

readFully

public static java.lang.String readFully(java.io.InputStream is)
                                  throws java.io.IOException

Reads the give InputStream into a String.

Throws:

java.io.IOException

readFully

public static java.lang.String readFully(java.io.BufferedReader reader)
                                  throws java.io.IOException

Reads the give BufferedReader into a String.

Throws:

java.io.IOException

transform

public static <T> java.util.Map<java.lang.String,T> transform(java.util.Map<java.lang.String,T> in,
                                                              java.util.Map<java.lang.String,java.lang.String> mapper)

Transforms the given map by replacing the keys mapped by mapper. Any keys not in the mapper preserve their original keys. If a key in the mapper maps to null or a blank string, that value is dropped. e.g. transform({a: 1, b: 2, c: 3}, {a: a, c: ""}) -> {$a: 1, b: 2} - transforms a to $a - keeps b - removes c

toJsonObject

public static org.json.JSONObject toJsonObject(java.util.Map<java.lang.String,?> map)

Return a copy of the contents of the given map as a JSONObject. Instead of failing on null values like the JSONObject map constructor, it cleans them up and correctly converts them to JSONObject.NULL.

createMap

public static <T> java.util.Map<java.lang.String,T> createMap()

createDirectory

public static void createDirectory(java.io.File location)
                            throws java.io.IOException

Ensures that a directory is created in the given location, throws an IOException otherwise.

Throws:

java.io.IOException