org.infinispan.marshall.core

Class MarshalledValue

java.lang.Object

org.infinispan.marshall.core.MarshalledValue

All Implemented Interfaces:

Externalizable, Serializable

public final class MarshalledValue
extends Object
implements Externalizable

Wrapper that wraps cached data, providing lazy deserialization using the calling thread's context class loader.

The MarshalledValueInterceptor handles transparent wrapping/unwrapping of cached data.

NOTE: the equals() method of this class will compare binary representations (byte arrays).

Note also that this will affect the way keys stored in the cache will work, if storeAsBinary is used, since comparisons happen on the key which will be wrapped by a MarshalledValue. Implementers of equals() methods of their keys need to be aware of this.

This class can be marshalled either via its externalizer or via the JVM serialization. The reason for supporting both methods is to enable third-party libraries to be able to marshall/unmarshall them using standard JVM serialization rules. The Infinispan marshalling layer will always chose the most performant one, aka the externalizer method.

Since:

4.0

Author:

Manik Surtani (manik@jboss.org), Mircea.Markus@jboss.com, Galder Zamarreño, Sanne Grinovero

See Also:

MarshalledValueInterceptor, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MarshalledValue.Externalizer

Constructor Summary

Constructors

Constructor and Description
MarshalledValue()
MarshalledValue(byte[] bytes, int hashCode, StreamingMarshaller marshaller)
MarshalledValue(byte[] bytes, StreamingMarshaller marshaller)
MarshalledValue(Object instance, StreamingMarshaller marshaller)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o)
Object	get() Returns the 'cached' instance
MarshalledValueByteStream	getRaw()
int	hashCode()
static boolean	isTypeExcluded(Class<?> type) Tests whether the type should be excluded from MarshalledValue wrapping.
void	readExternal(ObjectInput in)
String	toString()
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MarshalledValue

public MarshalledValue()

MarshalledValue

public MarshalledValue(byte[] bytes,
               int hashCode,
               StreamingMarshaller marshaller)

MarshalledValue

public MarshalledValue(byte[] bytes,
               StreamingMarshaller marshaller)

MarshalledValue

public MarshalledValue(Object instance,
               StreamingMarshaller marshaller)

Method Detail

getRaw

public MarshalledValueByteStream getRaw()

get

public Object get()

Returns the 'cached' instance

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

isTypeExcluded

public static boolean isTypeExcluded(Class<?> type)

Tests whether the type should be excluded from MarshalledValue wrapping.

Parameters:

type - type to test. Should not be null.

Returns:

true if it should be excluded from MarshalledValue wrapping.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException