io.sentry.util

Class Util

java.lang.Object

io.sentry.util.Util

public final class Util
extends Object

Sentry static Utility class.

Method Summary

Modifier and Type	Method and Description
static void	closeQuietly(Closeable closeable) Closes an instance of Closeable and suppress all possible raised Exceptions.
static boolean	equals(Object a, Object b) Returns true if the arguments are equal to each other and false otherwise.
static boolean	isNullOrEmpty(String string) Returns true if the given string is null or is the empty string.
static Double	parseDouble(String value, Double defaultValue) Parses the provided string value into a double value.
static Map<String,String>	parseExtra(String extrasString) Parses the provided extras string into a Map of String -> String.
static Set<String>	parseExtraTags(String extraTagsString) Deprecated. prefer parseMdcTags(String)
static Integer	parseInteger(String value, Integer defaultValue) Parses the provided string value into an integer value.
static Long	parseLong(String value, Long defaultValue) Parses the provided string value into a long value.
static Set<String>	parseMdcTags(String mdcTagsString) Parses the provided Strings into a Set of Strings.
static Map<String,String>	parseTags(String tagsString) Parses the provided tags string into a Map of String -> String.
static boolean	safelyRemoveShutdownHook(Thread shutDownHook) Try to remove the shutDownHook, handling the case where the VM is in shutdown process.
static String	trimString(String string, int maxMessageLength) Trims a String, ensuring that the maximum length isn't reached.

Methods inherited from class java.lang.Object

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

Method Detail

equals

public static boolean equals(Object a,
                             Object b)

Returns true if the arguments are equal to each other and false otherwise. Consequently, if both arguments are null, true is returned and if exactly one argument is null, false is returned. Otherwise, equality is determined by using the equals method of the first argument.

Parameters:

a - an object

b - an object to be compared with a for equality

Returns:

true if the arguments are equal to each other and false otherwise

See Also:

Object.equals(Object)

isNullOrEmpty

public static boolean isNullOrEmpty(String string)

Returns true if the given string is null or is the empty string.

Parameters:

string - a string reference to check

Returns:

true if the string is null or is the empty string

parseTags

public static Map<String,String> parseTags(String tagsString)

Parses the provided tags string into a Map of String -> String.

Parameters:

tagsString - comma-delimited key-value pairs, e.g. "tag1:value1,tag2:value2".

Returns:

Map of tags e.g. (tag1 -> value1, tag2 -> value2)

parseExtra

public static Map<String,String> parseExtra(String extrasString)

Parses the provided extras string into a Map of String -> String.

Parameters:

extrasString - comma-delimited key-value pairs, e.g. "extra1:value1,extra2:value2".

Returns:

Map of extras e.g. (extra1 -> value1, extra2 -> value2)

parseExtraTags

@Deprecated
public static Set<String> parseExtraTags(String extraTagsString)

Deprecated. prefer parseMdcTags(String)

Parses the provided extraTags string into a Set of Strings.

Parameters:

extraTagsString - comma-delimited tags

Returns:

Set of Strings representing extra tags

parseMdcTags

public static Set<String> parseMdcTags(String mdcTagsString)

Parses the provided Strings into a Set of Strings.

Parameters:

mdcTagsString - comma-delimited tags

Returns:

Set of Strings representing mdc tags

parseInteger

public static Integer parseInteger(String value,
                                   Integer defaultValue)

Parses the provided string value into an integer value.

If the string is null or empty this returns the default value.

Parameters:

value - value to parse

defaultValue - default value

Returns:

integer representation of provided value or default value.

parseLong

public static Long parseLong(String value,
                             Long defaultValue)

Parses the provided string value into a long value.

If the string is null or empty this returns the default value.

Parameters:

value - value to parse

defaultValue - default value

Returns:

long representation of provided value or default value.

parseDouble

public static Double parseDouble(String value,
                                 Double defaultValue)

Parses the provided string value into a double value.

If the string is null or empty this returns the default value.

Parameters:

value - value to parse

defaultValue - default value

Returns:

double representation of provided value or default value.

trimString

public static String trimString(String string,
                                int maxMessageLength)

Trims a String, ensuring that the maximum length isn't reached.

Parameters:

string - string to trim

maxMessageLength - maximum length of the string

Returns:

trimmed string

safelyRemoveShutdownHook

public static boolean safelyRemoveShutdownHook(Thread shutDownHook)

Try to remove the shutDownHook, handling the case where the VM is in shutdown process.

Parameters:

shutDownHook - the shutDownHook to remove

Returns:

true if the hook was removed, false otherwise

closeQuietly

public static void closeQuietly(Closeable closeable)

Closes an instance of Closeable and suppress all possible raised Exceptions.

Parameters:

closeable - an instance that needs to be closed. null value is supported.