org.glassfish.tyrus.core

Class Utils

java.lang.Object

org.glassfish.tyrus.core.Utils

public class Utils
extends Object

Utility methods shared among Tyrus modules.

Author:

Pavel Bucek (pavel.bucek at oracle.com)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Utils.Stringifier<T> Define to String conversion for various types.

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Methods

Modifier and Type	Method and Description
static ByteBuffer	appendBuffers(ByteBuffer buffer, ByteBuffer buffer1, int incomingBufferSize, int BUFFER_STEP_SIZE) Concatenates two buffers into one.
static <T> void	checkNotNull(T reference, String errorMessage) Check for null.
static <T> String	getHeaderFromList(List<T> list) Creates single String value from provided List by calling Object.toString() on each item and separating existing ones with ", ".
static <T> String	getHeaderFromList(List<T> list, Utils.Stringifier<T> stringifier) Convert list of values to singe String usable as HTTP header value.
static <T> T	getProperty(Map<String,Object> properties, String key, Class<T> type) Get typed property from generic property map.
static <T> T	getProperty(Map<String,Object> properties, String key, Class<T> type, T defaultValue) Get typed property from generic property map.
static byte[]	getRemainingArray(ByteBuffer buffer) Creates the array of bytes containing the bytes from the position to the limit of the ByteBuffer.
static <T> List<String>	getStringList(List<T> list, Utils.Stringifier<T> stringifier) Get list of strings from List<T>.
static List<String>	parseHeaderValue(String headerValue) Parse header value - splits multiple values (quoted, unquoted) separated by comma.
static byte[]	toArray(long value) Convert long to byte[].
static long	toLong(byte[] bytes, int start, int end) Convert byte[] to long.
static List<String>	toString(byte[] bytes)
static List<String>	toString(byte[] bytes, int start, int end)

Methods inherited from class java.lang.Object

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

Constructor Detail

Utils

public Utils()

Method Detail

parseHeaderValue

public static List<String> parseHeaderValue(String headerValue)

Parse header value - splits multiple values (quoted, unquoted) separated by comma.

Parameters:

headerValue - string containing header values.

Returns:

split list of values.

getRemainingArray

public static byte[] getRemainingArray(ByteBuffer buffer)

Creates the array of bytes containing the bytes from the position to the limit of the ByteBuffer.

Parameters:

buffer - where the bytes are taken from.

Returns:

array of bytes containing the bytes from the position to the limit of the ByteBuffer.

getHeaderFromList

public static <T> String getHeaderFromList(List<T> list)

Creates single String value from provided List by calling Object.toString() on each item and separating existing ones with ", ".

Type Parameters:

T - item type.

Parameters:

list - to be serialized.

Returns:

single String containing all items from provided list.

getStringList

public static <T> List<String> getStringList(List<T> list,
                             Utils.Stringifier<T> stringifier)

Get list of strings from List<T>.

Parameters:

list - list to be converted.

stringifier - strignifier used for conversion. When null, Object.toString() method will be used.

Returns:

converted list.

getHeaderFromList

public static <T> String getHeaderFromList(List<T> list,
                           Utils.Stringifier<T> stringifier)

Convert list of values to singe String usable as HTTP header value.

Parameters:

list - list of values.

stringifier - strignifier used for conversion. When null, Object.toString() method will be used.

Returns:

serialized list.

checkNotNull

public static <T> void checkNotNull(T reference,
                    String errorMessage)

Check for null. Throws IllegalArgumentException if provided value is null.

Type Parameters:

T - object type.

Parameters:

reference - object to check.

errorMessage - message to be set to thrown IllegalArgumentException.

toArray

public static byte[] toArray(long value)

Convert long to byte[].

Parameters:

value - to be converted.

Returns:

converted value.

toLong

public static long toLong(byte[] bytes,
          int start,
          int end)

Convert byte[] to long.

Parameters:

bytes - to be converted.

start - start index.

end - end index.

Returns:

converted value.

toString

public static List<String> toString(byte[] bytes)

toString

public static List<String> toString(byte[] bytes,
                    int start,
                    int end)

appendBuffers

public static ByteBuffer appendBuffers(ByteBuffer buffer,
                       ByteBuffer buffer1,
                       int incomingBufferSize,
                       int BUFFER_STEP_SIZE)

Concatenates two buffers into one. If buffer given as first argument has enough space for putting the other one, it will be done and the original buffer will be returned. Otherwise new buffer will be created.

Parameters:

buffer - first buffer.

buffer1 - second buffer.

Returns:

concatenation.

getProperty

public static <T> T getProperty(Map<String,Object> properties,
                String key,
                Class<T> type)

Get typed property from generic property map.

Parameters:

properties - property map.

key - key of value to be retrieved.

type - type of value to be retrieved.

Returns:

typed value or null if property is not set or value is not assignable.

getProperty

public static <T> T getProperty(Map<String,Object> properties,
                String key,
                Class<T> type,
                T defaultValue)

Get typed property from generic property map.

Parameters:

properties - property map.

key - key of value to be retrieved.

type - type of value to be retrieved.

defaultValue - value returned when record does not exist in supplied map.

Returns:

typed value or null if property is not set or value is not assignable.