Core :: Utilities 12.0.6 · org.eclipse.jetty.util.TypeUtil

Modifier and Type	Field and Description
private static final HashMap<Class<?>, Function<String, Object>>	class2Value
public static final int	CR
public static final int	LF
private static final MethodHandle[]	LOCATION_METHODS
private static final Logger	LOG
private static final HashMap<String, Class<?>>	name2Class
public static final Class<?>[]	NO_ARGS
private static final Pattern	TRAILING_DIGITS

Access	Constructor and Description
private	TypeUtil()

Method Summary

Modifier and Type	Method and Description
private static void	appendEnclosing(StringBuilder b, Class<?> enclosing)
public static < the array and list entry type T> List<T>	Returns: a list backed by the array. asList(T[] the array to convert to a list a) Array to List.
public static <T> Iterator<T>	concat(Iterator<T> i1, Iterator<T> i2)
public static byte	Returns: The byte value of the character 0-16. convertHexDigit(byte An ASCII encoded character 0-9 a-f A-F c)
public static int	Returns: The byte value of the character 0-16. convertHexDigit(char An ASCII encoded character 0-9 a-f A-F c)
public static int	Returns: The byte value of the character 0-16. convertHexDigit(int An ASCII encoded character 0-9 a-f A-F c)
public static void	dump(Class<?> c)
public static void	dump(ClassLoader cl)
public static < The type of the predicate test T> Predicate<T>	Returns: true falsePredicate() A `Predicate` that is always false, with optimized `and`/`or`/`not` methods.
public static Class<?>	Returns: A class , which may be a primitive TYPE field.. fromName(String A class or type name. name) Class from a canonical name for a type.
public static URI	getClassLoaderLocation(Class<?> clazz)
public static URI	getClassLoaderLocation(Class<?> clazz, ClassLoader loader)
public static URI	getCodeSourceLocation(Class<?> clazz)
public static URI	Returns: the location as a URI (this is a URI pointing to a holder of the class: a directory, a jar file, a `jrt://` resource, etc), or null of no location available. getLocationOfClass(Class<?> the loaded class to find a location for. clazz) Attempt to find the Location of a loaded Class.
public static URI	getModuleLocation(Class<?> clazz)
public static URI	getSystemClassLoaderLocation(Class<?> clazz)
public static boolean	Returns: True if passed object is not null and is either a Boolean with value false or evaluates to a string that evaluates to false. isFalse(Object Object to test for false o)
public static boolean	isHex(String str, int offset, int len)
public static boolean	Returns: True if passed object is not null and is either a Boolean with value true or evaluates to a string that evaluates to true. isTrue(Object Object to test for true o)
private static < The class of the service type. T> Stream<T>	Returns: a stream of the loaded service providers. mapToService(ServiceLoader.Provider<T> The service provider to instantiate. provider) Used on a `ServiceLoader#stream()` with `Stream#flatMap(Function)`, so that in the case a `ServiceConfigurationError` is thrown it warns and continues iterating through the service loader.
public static int	Returns: the parsed integer parseInt(String String s, int Offset within string offset, int Length of integer or -1 for remainder of string length, int base of the integer base) Parse an int from a substring.
public static int	Returns: the parsed integer parseInt(byte[] byte array b, int Offset within string offset, int Length of integer or -1 for remainder of string length, int base of the integer base) Parse an int from a byte array of ascii characters.
public static < the type of the service to load. T> Stream<ServiceLoader.Provider<T>>	Returns: A stream that lazily loads providers for this loader's service serviceProviderStream(ServiceLoader<T> the ServiceLoader instance to use. serviceLoader) Utility to create a stream which provides the same functionality as `ServiceLoader#stream()`.
public static < the type of the service to load. T> Stream<T>	Returns: a stream of the service type which will not throw `ServiceConfigurationError`. serviceStream(ServiceLoader<T> the ServiceLoader instance to use. serviceLoader) Utility method to provide a stream of the service type from a `ServiceLoader`.
public static String	Returns: the classpath reference syntax for the class file toClassReference(Class<?> the class to reference clazz) Return the Classpath / Classloader reference for the provided class file.
public static String	Returns: the classpath reference syntax for the class file toClassReference(String the class to reference className) Return the Classpath / Classloader reference for the provided class file.
public static void	toHex(byte b, Appendable buf)
public static void	toHex(int value, Appendable buf)
public static void	toHex(long value, Appendable buf)
public static String	toShortName(Class<?> type)
public static String	toString(byte[] bytes, int base)
public static < The type of the predicate test T> Predicate<T>	Returns: true truePredicate() A Predicate that is always true, with optimized `and`/`or`/`not` methods.
public static Object	Returns: The value as an Object. valueOf(Class<?> The class of the instance, which may be a primitive TYPE field. type, String The value as a string. value) Convert String value to instance.
public static Object	Returns: The value as an Object. valueOf(String classname or type (eg int) type, String The value as a string. value) Convert String value to instance.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

class2Value	back to summary
private static final HashMap<Class<?>, Function<String, Object>> class2Value

CR	back to summary
public static final int CR

LF	back to summary
public static final int LF

LOCATION_METHODS	back to summary
private static final MethodHandle[] LOCATION_METHODS

LOG	back to summary
private static final Logger LOG

name2Class	back to summary
private static final HashMap<String, Class<?>> name2Class

NO_ARGS	back to summary
public static final Class<?>[] NO_ARGS

TRAILING_DIGITS	back to summary
private static final Pattern TRAILING_DIGITS

TypeUtil	back to summary
private TypeUtil()

Method Detail

appendEnclosing	back to summary
private static void appendEnclosing(StringBuilder b, Class<?> enclosing)

asList back to summary

asList	back to summary
public static <T> List<T> asList(T[] a) Array to List. Works like `Arrays#asList(Object...)`, but handles null arrays. Parameters <T> the array and list entry type a:T[] the array to convert to a list Returns:List<T> a list backed by the array.

public static <T> List<T> asList(T[] a)

Array to List.

Works like Arrays#asList(Object...), but handles null arrays.

Parameters

<T>: the array and list entry type
a:T[]: the array to convert to a list

Returns:List<T>

a list backed by the array.

concat	back to summary
public static <T> Iterator<T> concat(Iterator<T> i1, Iterator<T> i2)

convertHexDigit	back to summary
public static byte convertHexDigit(byte c) Parameters c:byte An ASCII encoded character 0-9 a-f A-F Returns:byte The byte value of the character 0-16.

convertHexDigit	back to summary
public static int convertHexDigit(char c) Parameters c:char An ASCII encoded character 0-9 a-f A-F Returns:int The byte value of the character 0-16.

convertHexDigit	back to summary
public static int convertHexDigit(int c) Parameters c:int An ASCII encoded character 0-9 a-f A-F Returns:int The byte value of the character 0-16.

dump	back to summary
public static void dump(Class<?> c)

dump	back to summary
public static void dump(ClassLoader cl)

falsePredicate back to summary

falsePredicate	back to summary
public static <T> Predicate<T> falsePredicate() A `Predicate` that is always false, with optimized `and`/`or`/`not` methods. Parameters <T> The type of the predicate test Returns:Predicate<T> true

public static <T> Predicate<T> falsePredicate()

A Predicate that is always false, with optimized and/or/not methods.

Parameters

<T>: The type of the predicate test

Returns:Predicate<T>

true

fromName	back to summary
public static Class<?> fromName(String name) Class from a canonical name for a type. Parameters name:String A class or type name. Returns:Class<?> A class , which may be a primitive TYPE field..

fromName

back to summary

public static Class<?> fromName(String name)

Class from a canonical name for a type.

Parameters

name:String: A class or type name.

Returns:Class<?>

A class , which may be a primitive TYPE field..

getClassLoaderLocation	back to summary
public static URI getClassLoaderLocation(Class<?> clazz)

getClassLoaderLocation	back to summary
public static URI getClassLoaderLocation(Class<?> clazz, ClassLoader loader)

getCodeSourceLocation	back to summary
public static URI getCodeSourceLocation(Class<?> clazz)

getLocationOfClass back to summary

getLocationOfClass	back to summary
public static URI getLocationOfClass(Class<?> clazz) Attempt to find the Location of a loaded Class. This can be null for primitives, void, and in-memory classes. Parameters clazz:Class<?> the loaded class to find a location for. Returns:URI the location as a URI (this is a URI pointing to a holder of the class: a directory, a jar file, a `jrt://` resource, etc), or null of no location available.

public static URI getLocationOfClass(Class<?> clazz)

Attempt to find the Location of a loaded Class.

This can be null for primitives, void, and in-memory classes.

Parameters

clazz:Class<?>: the loaded class to find a location for.

Returns:URI

the location as a URI (this is a URI pointing to a holder of the class: a directory, a jar file, a jrt:// resource, etc), or null of no location available.

getModuleLocation	back to summary
public static URI getModuleLocation(Class<?> clazz)

getSystemClassLoaderLocation	back to summary
public static URI getSystemClassLoaderLocation(Class<?> clazz)

isFalse	back to summary
public static boolean isFalse(Object o) Parameters o:Object Object to test for false Returns:boolean True if passed object is not null and is either a Boolean with value false or evaluates to a string that evaluates to false.

isHex	back to summary
public static boolean isHex(String str, int offset, int len)

isTrue	back to summary
public static boolean isTrue(Object o) Parameters o:Object Object to test for true Returns:boolean True if passed object is not null and is either a Boolean with value true or evaluates to a string that evaluates to true.

mapToService back to summary

mapToService	back to summary
private static <T> Stream<T> mapToService(ServiceLoader.Provider<T> provider) Used on a `ServiceLoader#stream()` with `Stream#flatMap(Function)`, so that in the case a `ServiceConfigurationError` is thrown it warns and continues iterating through the service loader. Usage Example: `ServiceLoader.load(Service.class).stream().flatMap(TypeUtil::providerMap).collect(Collectors.toList());` Parameters <T> The class of the service type. provider:ServiceLoader.Provider<T> The service provider to instantiate. Returns:Stream<T> a stream of the loaded service providers.

private static <T> Stream<T> mapToService(ServiceLoader.Provider<T> provider)

Used on a ServiceLoader#stream() with Stream#flatMap(Function), so that in the case a ServiceConfigurationError is thrown it warns and continues iterating through the service loader.
Usage Example:

ServiceLoader.load(Service.class).stream().flatMap(TypeUtil::providerMap).collect(Collectors.toList());

Parameters

<T>: The class of the service type.
provider:ServiceLoader.Provider<T>: The service provider to instantiate.

Returns:Stream<T>

a stream of the loaded service providers.

parseInt	back to summary
public static int parseInt(String s, int offset, int length, int base) throws NumberFormatException Parse an int from a substring. Negative numbers are not handled. Parameters s:String String offset:int Offset within string length:int Length of integer or -1 for remainder of string base:int base of the integer Returns:int the parsed integer Exceptions NumberFormatException: if the string cannot be parsed

parseInt

back to summary

public static int parseInt(String s, int offset, int length, int base) throws NumberFormatException

Parse an int from a substring. Negative numbers are not handled.

Parameters

s:String: String
offset:int: Offset within string
length:int: Length of integer or -1 for remainder of string
base:int: base of the integer

Returns:int

the parsed integer

Exceptions

NumberFormatException:: if the string cannot be parsed

parseInt	back to summary
public static int parseInt(byte[] b, int offset, int length, int base) throws NumberFormatException Parse an int from a byte array of ascii characters. Negative numbers are not handled. Parameters b:byte[] byte array offset:int Offset within string length:int Length of integer or -1 for remainder of string base:int base of the integer Returns:int the parsed integer Exceptions NumberFormatException: if the array cannot be parsed into an integer

parseInt

back to summary

public static int parseInt(byte[] b, int offset, int length, int base) throws NumberFormatException

Parse an int from a byte array of ascii characters. Negative numbers are not handled.

Parameters

b:byte[]: byte array
offset:int: Offset within string
length:int: Length of integer or -1 for remainder of string
base:int: base of the integer

Returns:int

the parsed integer

Exceptions

NumberFormatException:: if the array cannot be parsed into an integer

serviceProviderStream back to summary

serviceProviderStream	back to summary
public static <T> Stream<ServiceLoader.Provider<T>> serviceProviderStream(ServiceLoader<T> serviceLoader) Utility to create a stream which provides the same functionality as `ServiceLoader#stream()`. However, this also guards the case in which `Iterator#hasNext()` throws. Any exceptions from the underlying iterator will be cached until the `ServiceLoader.Provider#get()` is called. Parameters <T> the type of the service to load. serviceLoader:ServiceLoader<T> the ServiceLoader instance to use. Returns:Stream<ServiceLoader.Provider<T>> A stream that lazily loads providers for this loader's service

public static <T> Stream<ServiceLoader.Provider<T>> serviceProviderStream(ServiceLoader<T> serviceLoader)

Utility to create a stream which provides the same functionality as ServiceLoader#stream(). However, this also guards the case in which Iterator#hasNext() throws. Any exceptions from the underlying iterator will be cached until the ServiceLoader.Provider#get() is called.

Parameters

<T>: the type of the service to load.
serviceLoader:ServiceLoader<T>: the ServiceLoader instance to use.

Returns:Stream<ServiceLoader.Provider<T>>

A stream that lazily loads providers for this loader's service

serviceStream back to summary

serviceStream	back to summary
public static <T> Stream<T> serviceStream(ServiceLoader<T> serviceLoader) Utility method to provide a stream of the service type from a `ServiceLoader`. Log warnings will be given for any `ServiceConfigurationError`s which occur when loading or instantiating the services. Parameters <T> the type of the service to load. serviceLoader:ServiceLoader<T> the ServiceLoader instance to use. Returns:Stream<T> a stream of the service type which will not throw `ServiceConfigurationError`.

public static <T> Stream<T> serviceStream(ServiceLoader<T> serviceLoader)

Utility method to provide a stream of the service type from a ServiceLoader. Log warnings will be given for any ServiceConfigurationErrors which occur when loading or instantiating the services.

Parameters

<T>: the type of the service to load.
serviceLoader:ServiceLoader<T>: the ServiceLoader instance to use.

Returns:Stream<T>

a stream of the service type which will not throw ServiceConfigurationError.

toClassReference	back to summary
public static String toClassReference(Class<?> clazz) Return the Classpath / Classloader reference for the provided class file. Convenience method for the code String ref = myObject.getClass().getName().replace('.','/') + ".class"; Parameters clazz:Class<?> the class to reference Returns:String the classpath reference syntax for the class file

toClassReference

back to summary

public static String toClassReference(Class<?> clazz)

Return the Classpath / Classloader reference for the provided class file.

Convenience method for the code

String ref = myObject.getClass().getName().replace('.','/') + ".class";

Parameters

clazz:Class<?>: the class to reference

Returns:String

the classpath reference syntax for the class file

toClassReference	back to summary
public static String toClassReference(String className) Return the Classpath / Classloader reference for the provided class file. Convenience method for the code String ref = myClassName.replace('.','/') + ".class"; Parameters className:String the class to reference Returns:String the classpath reference syntax for the class file

toClassReference

back to summary

public static String toClassReference(String className)

Return the Classpath / Classloader reference for the provided class file.

Convenience method for the code

String ref = myClassName.replace('.','/') + ".class";

Parameters

className:String: the class to reference

Returns:String

the classpath reference syntax for the class file

toHex	back to summary
public static void toHex(byte b, Appendable buf)

toHex	back to summary
public static void toHex(int value, Appendable buf) throws IOException

toHex	back to summary
public static void toHex(long value, Appendable buf) throws IOException

toShortName	back to summary
public static String toShortName(Class<?> type)

toString	back to summary
public static String toString(byte[] bytes, int base)

truePredicate back to summary

truePredicate	back to summary
public static <T> Predicate<T> truePredicate() A Predicate that is always true, with optimized `and`/`or`/`not` methods. Parameters <T> The type of the predicate test Returns:Predicate<T> true

public static <T> Predicate<T> truePredicate()

A Predicate that is always true, with optimized and/or/not methods.

Parameters

<T>: The type of the predicate test

Returns:Predicate<T>

true

valueOf	back to summary
public static Object valueOf(Class<?> type, String value) Convert String value to instance. Parameters type:Class<?> The class of the instance, which may be a primitive TYPE field. value:String The value as a string. Returns:Object The value as an Object.

valueOf

back to summary

public static Object valueOf(Class<?> type, String value)

Convert String value to instance.

Parameters

type:Class<?>: The class of the instance, which may be a primitive TYPE field.
value:String: The value as a string.

Returns:Object

The value as an Object.

valueOf	back to summary
public static Object valueOf(String type, String value) Convert String value to instance. Parameters type:String classname or type (eg int) value:String The value as a string. Returns:Object The value as an Object.

valueOf

back to summary

public static Object valueOf(String type, String value)

Convert String value to instance.

Parameters

type:String: classname or type (eg int)
value:String: The value as a string.

Returns:Object

The value as an Object.

public Class TypeUtil

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail