|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@ThreadSafe public interface Marshaller
A marshaller is a class that is able to marshall and unmarshall objects efficiently.
This interface is used to marshallReplicableCommand
s, their parameters and their
response values, as well as any other arbitraty Object <--> byte[] conversions, such as those used in client/server
communications.
The interface is also used by the CacheStore
framework to efficiently serialize data
to be persisted, as well as the StateTransferManager
when serializing the cache
for transferring state en-masse.
A single instance of any implementation is shared by multiple threads, so implementations need to be threadsafe,
and preferably immutable.
Method Summary | |
---|---|
boolean |
isMarshallable(Object o)
A method that checks whether the given object is marshallable as per the rules of this marshaller. |
Object |
objectFromByteBuffer(byte[] buf)
Unmarshalls an object from a byte array. |
Object |
objectFromByteBuffer(byte[] buf,
int offset,
int length)
Unmarshalls an object from a specific portion of a byte array. |
ByteBuffer |
objectToBuffer(Object o)
A method that returns an instance of ByteBuffer , which allows direct access to the byte
array with minimal array copying |
byte[] |
objectToByteBuffer(Object obj)
Marshalls an object to a byte array. |
byte[] |
objectToByteBuffer(Object obj,
int estimatedSize)
Marshalls an object to a byte array. |
Method Detail |
---|
byte[] objectToByteBuffer(Object obj, int estimatedSize) throws IOException
obj
- object to convert to a byte array. Must not be null.estimatedSize
- an estimate of how large the resulting byte array may be
IOException
byte[] objectToByteBuffer(Object obj) throws IOException
obj
- object to convert to a byte array. Must not be null.
IOException
Object objectFromByteBuffer(byte[] buf) throws IOException, ClassNotFoundException
buf
- byte array containing the binary representation of an object. Must not be null.
IOException
ClassNotFoundException
Object objectFromByteBuffer(byte[] buf, int offset, int length) throws IOException, ClassNotFoundException
buf
- byte array containing the binary representation of an object. Must not be null.offset
- point in buffer to start readinglength
- number of bytes to consider
IOException
ClassNotFoundException
ByteBuffer objectToBuffer(Object o) throws IOException
ByteBuffer
, which allows direct access to the byte
array with minimal array copying
o
- object to marshall
Exception
IOException
boolean isMarshallable(Object o)
o
- object to verify whether it's marshallable or not
|
Google Analytics | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |