Package org.infinispan.commons.marshall

Class MarshallUtil

java.lang.Object

org.infinispan.commons.marshall.MarshallUtil

@Immutable
public class MarshallUtil
extends Object

MarshallUtil.

Since:

4.0

Author:

Galder Zamarreño

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	MarshallUtil.ArrayBuilder<E>
static interface	MarshallUtil.CollectionBuilder<E,T extends Collection<E>>
static interface	MarshallUtil.ElementReader<E>
static interface	MarshallUtil.ElementWriter<E>
static interface	MarshallUtil.EnumBuilder<E extends Enum<E>>
static interface	MarshallUtil.MapBuilder<K,V,T extends Map<K,V>>
static interface	MarshallUtil.UnboundedCollectionBuilder<E,T extends Collection<E>>

Constructor Summary

Constructors

Constructor	Description
MarshallUtil()

Method Summary

Modifier and Type	Method	Description
static boolean	isSafeClass(String className, List<String> whitelist)	Checks whether class name is matched by the class name white list regular expressions provided.
static <E> void	marshallArray(E[] array, ObjectOutput out)	Marshall arrays.
static void	marshallByteArray(byte[] array, ObjectOutput out)	Same as marshallArray(Object[], ObjectOutput) but specialized for byte arrays.
static <E> void	marshallCollection(Collection<E> collection, ObjectOutput out)	Marshall a Collection.
static <E> void	marshallCollection(Collection<E> collection, ObjectOutput out, MarshallUtil.ElementWriter<E> writer)	Marshall a Collection.
static <E extends Enum<E>> void	marshallEnum(E e, ObjectOutput output)
static void	marshallIntCollection(Collection<Integer> collection, ObjectOutput out)	Marshalls a collection of integers.
static <K,V,T extends Map<K,V>> void	marshallMap(T map, ObjectOutput out)	Marshall the map to the ObjectOutput.
static <K,V,T extends Map<K,V>> void	marshallMap(T map, MarshallUtil.ElementWriter<K> keyWriter, MarshallUtil.ElementWriter<V> valueWrite, ObjectOutput out)	Marshall the map to the ObjectOutput.
static void	marshallSize(ObjectOutput out, int value)	A special marshall implementation for integer.
static void	marshallString(String string, ObjectOutput out)	Marshall the String.
static void	marshallUUID(UUID uuid, ObjectOutput out, boolean checkNull)	Marshall the UUID by sending the most and lest significant bits.
static <E> E[]	unmarshallArray(ObjectInput in, MarshallUtil.ArrayBuilder<E> builder)	Unmarshall arrays.
static byte[]	unmarshallByteArray(ObjectInput in)	Same as unmarshallArray(ObjectInput, ArrayBuilder) but specialized for byte array.
static <E,T extends Collection<E>> T	unmarshallCollection(ObjectInput in, MarshallUtil.CollectionBuilder<E,T> builder)	Unmarshal a Collection.
static <E,T extends Collection<E>> T	unmarshallCollection(ObjectInput in, MarshallUtil.CollectionBuilder<E,T> builder, MarshallUtil.ElementReader<E> reader)	Unmarshal a Collection.
static <E,T extends Collection<E>> T	unmarshallCollectionUnbounded(ObjectInput in, MarshallUtil.UnboundedCollectionBuilder<E,T> builder)	Same as unmarshallCollection(ObjectInput, CollectionBuilder).
static <E extends Enum<E>> E	unmarshallEnum(ObjectInput input, MarshallUtil.EnumBuilder<E> builder)
static <T extends Collection<Integer>> T	unmarshallIntCollection(ObjectInput in, MarshallUtil.CollectionBuilder<Integer,T> builder)	Unmarshalls a collection of integers.
static <K,V,T extends Map<K,V>> T	unmarshallMap(ObjectInput in, MarshallUtil.ElementReader<K> keyReader, MarshallUtil.ElementReader<V> valueReader, MarshallUtil.MapBuilder<K,V,T> builder)	Unmarshall the Map.
static <K,V,T extends Map<K,V>> T	unmarshallMap(ObjectInput in, MarshallUtil.MapBuilder<K,V,T> builder)	Unmarshall the Map.
static int	unmarshallSize(ObjectInput in)	Unmarshall an integer.
static String	unmarshallString(ObjectInput in)	Unmarshall a String.
static UUID	unmarshallUUID(ObjectInput in, boolean checkNull)	Unmarshall UUID.

Methods inherited from class java.lang.Object

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

Constructor Detail

MarshallUtil

public MarshallUtil()

Method Detail

marshallMap

public static <K,V,T extends Map<K,V>> void marshallMap(T map,
                                                                          ObjectOutput out)
                                                                   throws IOException

Marshall the map to the ObjectOutput.

null maps are supported.

Type Parameters:

K - Key type of the map.

V - Value type of the map.

T - Type of the Map.

Parameters:

map - Map to marshall.

out - ObjectOutput to write. It must be non-null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallMap

public static <K,V,T extends Map<K,V>> T unmarshallMap(ObjectInput in,
                                                                         MarshallUtil.MapBuilder<K,V,T> builder)
                                                                  throws IOException,
                                                                         ClassNotFoundException

Unmarshall the Map.

If the marshalled map is null, then the MarshallUtil.MapBuilder is not invoked.

Parameters:

in - ObjectInput to read.

builder - MarshallUtil.MapBuilder to create the concrete Map implementation.

Returns:

The populated Map created by the MarshallUtil.MapBuilder or null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

ClassNotFoundException - If the class of a serialized object cannot be found.

See Also:

marshallMap(Map, ObjectOutput)

marshallMap

public static <K,V,T extends Map<K,V>> void marshallMap(T map,
                                                                          MarshallUtil.ElementWriter<K> keyWriter,
                                                                          MarshallUtil.ElementWriter<V> valueWrite,
                                                                          ObjectOutput out)
                                                                   throws IOException

Marshall the map to the ObjectOutput.

null maps are supported.

Type Parameters:

K - Key type of the map.

V - Value type of the map.

T - Type of the Map.

Parameters:

map - Map to marshall.

out - ObjectOutput to write. It must be non-null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallMap

public static <K,V,T extends Map<K,V>> T unmarshallMap(ObjectInput in,
                                                                         MarshallUtil.ElementReader<K> keyReader,
                                                                         MarshallUtil.ElementReader<V> valueReader,
                                                                         MarshallUtil.MapBuilder<K,V,T> builder)
                                                                  throws IOException,
                                                                         ClassNotFoundException

Unmarshall the Map.

If the marshalled map is null, then the MarshallUtil.MapBuilder is not invoked.

Parameters:

in - ObjectInput to read.

builder - MarshallUtil.MapBuilder to create the concrete Map implementation.

Returns:

The populated Map created by the MarshallUtil.MapBuilder or null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

ClassNotFoundException - If the class of a serialized object cannot be found.

See Also:

marshallMap(Map, ElementWriter, ElementWriter, ObjectOutput)

marshallUUID

public static void marshallUUID(UUID uuid,
                                ObjectOutput out,
                                boolean checkNull)
                         throws IOException

Marshall the UUID by sending the most and lest significant bits.

This method supports null if checkNull is set to true.

Parameters:

uuid - UUID to marshall.

out - ObjectOutput to write.

checkNull - If true, it checks if uuid is null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallUUID

public static UUID unmarshallUUID(ObjectInput in,
                                  boolean checkNull)
                           throws IOException

Unmarshall UUID.

Parameters:

in - ObjectInput to read.

checkNull - If true, it checks if the UUID marshalled was null.

Returns:

UUID marshalled.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

marshallArray

public static <E> void marshallArray(E[] array,
                                     ObjectOutput out)
                              throws IOException

Marshall arrays.

This method supports null array.

Type Parameters:

E - Array type.

Parameters:

array - Array to marshall.

out - ObjectOutput to write.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallArray

public static <E> E[] unmarshallArray(ObjectInput in,
                                      MarshallUtil.ArrayBuilder<E> builder)
                               throws IOException,
                                      ClassNotFoundException

Unmarshall arrays.

Type Parameters:

E - Array type.

Parameters:

in - ObjectInput to read.

builder - MarshallUtil.ArrayBuilder to build the array.

Returns:

The populated array.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

ClassNotFoundException - If the class of a serialized object cannot be found.

marshallCollection

public static <E> void marshallCollection(Collection<E> collection,
                                          ObjectOutput out)
                                   throws IOException

Marshall a Collection.

This method supports null collection.

Type Parameters:

E - Collection's element type.

Parameters:

collection - Collection to marshal.

out - ObjectOutput to write.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

marshallCollection

public static <E> void marshallCollection(Collection<E> collection,
                                          ObjectOutput out,
                                          MarshallUtil.ElementWriter<E> writer)
                                   throws IOException

Marshall a Collection.

This method supports null collection.

Type Parameters:

E - Collection's element type.

Parameters:

collection - Collection to marshal.

out - ObjectOutput to write.

writer - MarshallUtil.ElementWriter that writes single element to the output.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallCollection

public static <E,T extends Collection<E>> T unmarshallCollection(ObjectInput in,
                                                                       MarshallUtil.CollectionBuilder<E,T> builder,
                                                                       MarshallUtil.ElementReader<E> reader)
                                                                throws IOException,
                                                                       ClassNotFoundException

Unmarshal a Collection.

Type Parameters:

E - Collection's element type.

T - Collection implementation.

Parameters:

in - ObjectInput to read.

builder - MarshallUtil.CollectionBuilder builds the concrete Collection based on size.

reader - MarshallUtil.ElementReader reads one element from the input.

Returns:

The concrete Collection implementation.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

ClassNotFoundException - If the class of a serialized object cannot be found.

unmarshallCollection

public static <E,T extends Collection<E>> T unmarshallCollection(ObjectInput in,
                                                                       MarshallUtil.CollectionBuilder<E,T> builder)
                                                                throws IOException,
                                                                       ClassNotFoundException

Unmarshal a Collection.

Type Parameters:

E - Collection's element type.

T - Collection implementation.

Parameters:

in - ObjectInput to read.

builder - MarshallUtil.CollectionBuilder builds the concrete Collection based on size.

Returns:

The concrete Collection implementation.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

ClassNotFoundException - If the class of a serialized object cannot be found.

unmarshallCollectionUnbounded

public static <E,T extends Collection<E>> T unmarshallCollectionUnbounded(ObjectInput in,
                                                                                MarshallUtil.UnboundedCollectionBuilder<E,T> builder)
                                                                         throws IOException,
                                                                                ClassNotFoundException

Same as unmarshallCollection(ObjectInput, CollectionBuilder).

Used when the size of the Collection is not needed for it construction.

Throws:

IOException

ClassNotFoundException

marshallString

public static void marshallString(String string,
                                  ObjectOutput out)
                           throws IOException

Marshall the String.

Same behavior as DataOutput.writeUTF(String) but it checks for null. If the string is never null, it is better to use DataOutput.writeUTF(String).

Parameters:

string - String to marshall.

out - ObjectOutput to write.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallString

public static String unmarshallString(ObjectInput in)
                               throws IOException

Unmarshall a String.

Parameters:

in - ObjectInput to read.

Returns:

The String or null.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

marshallByteArray

public static void marshallByteArray(byte[] array,
                                     ObjectOutput out)
                              throws IOException

Same as marshallArray(Object[], ObjectOutput) but specialized for byte arrays.

Throws:

IOException

unmarshallByteArray

public static byte[] unmarshallByteArray(ObjectInput in)
                                  throws IOException

Same as unmarshallArray(ObjectInput, ArrayBuilder) but specialized for byte array.

No MarshallUtil.ArrayBuilder is necessary.

Throws:

IOException

marshallSize

public static void marshallSize(ObjectOutput out,
                                int value)
                         throws IOException

A special marshall implementation for integer.

This method supports negative values but they are handles as NULL_VALUE. It means that the real value is lost and NULL_VALUE is returned by unmarshallSize(ObjectInput).

The integer is marshalled in a variable length from 1 to 5 bytes. Negatives values are always marshalled in 1 byte.

Parameters:

out - ObjectOutput to write.

value - Integer value to marshall.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

unmarshallSize

public static int unmarshallSize(ObjectInput in)
                          throws IOException

Unmarshall an integer.

Parameters:

in - ObjectInput to read.

Returns:

The integer value or NULL_VALUE if the original value was negative.

Throws:

IOException - If any of the usual Input/Output related exceptions occur.

marshallEnum

public static <E extends Enum<E>> void marshallEnum(E e,
                                                    ObjectOutput output)
                                             throws IOException

Throws:

IOException

unmarshallEnum

public static <E extends Enum<E>> E unmarshallEnum(ObjectInput input,
                                                   MarshallUtil.EnumBuilder<E> builder)
                                            throws IOException

Throws:

IOException

marshallIntCollection

public static void marshallIntCollection(Collection<Integer> collection,
                                         ObjectOutput out)
                                  throws IOException

Marshalls a collection of integers.

Parameters:

collection - the collection to marshall.

out - the ObjectOutput to write to.

Throws:

IOException - if an error occurs.

unmarshallIntCollection

public static <T extends Collection<Integer>> T unmarshallIntCollection(ObjectInput in,
                                                                        MarshallUtil.CollectionBuilder<Integer,T> builder)
                                                                 throws IOException

Unmarshalls a collection of integers.

Type Parameters:

T - the concrete type of the collection.

Parameters:

in - the ObjectInput to read from.

builder - the MarshallUtil.CollectionBuilder to build the collection of integer.

Returns:

the collection.

Throws:

IOException - if an error occurs.

isSafeClass

public static boolean isSafeClass(String className,
                                  List<String> whitelist)

Checks whether class name is matched by the class name white list regular expressions provided.

Parameters:

className - class to verify

whitelist - list of regular expressions to match class name against

Returns:

true if the class matched at least one of the regular expressions, false otherwise