|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Marshaller
A marshaller is a class that is able to marshall and unmarshall objects efficiently.
The reason why this is implemented specially in Infinispan rather than resorting to Java serialization or even the more efficient JBoss serialization is that a lot of efficiency can be gained when a majority of the serialization that occurs has to do with a small set of known types such asorg.infinispan.transaction.GlobalTransaction
or
ReplicableCommand
, and class type information can be replaced with simple magic
numbers.
Unknown types (typically user data) falls back to JBoss serialization.
In addition, using a marshaller allows adding additional data to the byte stream, such as context class loader
information on which class loader to use to deserialize the object stream, or versioning information to allow streams
to interoperate between different versions of Infinispan (see VersionAwareMarshaller
This interface is used to marshall ReplicableCommand
s, their parameters and their
response values.
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.
Method Summary | |
---|---|
void |
finishObjectInput(ObjectInput oi)
Finish using the given ObjectInput. |
void |
finishObjectOutput(ObjectOutput oo)
Finish using the given ObjectOutput. |
Object |
objectFromByteBuffer(byte[] buf)
|
Object |
objectFromByteBuffer(byte[] buf,
int offset,
int length)
|
Object |
objectFromInputStream(InputStream is)
|
Object |
objectFromObjectStream(ObjectInput in)
Unmarshalls an object from an ObjectInput |
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)
|
void |
objectToObjectStream(Object obj,
ObjectOutput out)
Marshalls an object to a given ObjectOutput |
ObjectInput |
startObjectInput(InputStream is)
Create and open a new ObjectInput for the given input stream. |
ObjectOutput |
startObjectOutput(OutputStream os)
Create and open a new ObjectOutput for the given output stream. |
Method Detail |
---|
ObjectOutput startObjectOutput(OutputStream os) throws IOException
os
- output stream
IOException
void finishObjectOutput(ObjectOutput oo)
oo
- data output that finished usingvoid objectToObjectStream(Object obj, ObjectOutput out) throws IOException
ObjectOutput
obj
- object to marshallout
- stream to marshall to
IOException
ObjectInput startObjectInput(InputStream is) throws IOException
is
- input stream
IOException
void finishObjectInput(ObjectInput oi)
oi
- data input that finished usingObject objectFromObjectStream(ObjectInput in) throws IOException, ClassNotFoundException
ObjectInput
in
- stream to unmarshall from
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
Object objectFromByteBuffer(byte[] buf, int offset, int length) throws IOException, ClassNotFoundException
IOException
ClassNotFoundException
byte[] objectToByteBuffer(Object obj) throws IOException
IOException
Object objectFromByteBuffer(byte[] buf) throws IOException, ClassNotFoundException
IOException
ClassNotFoundException
Object objectFromInputStream(InputStream is) throws IOException, ClassNotFoundException
IOException
ClassNotFoundException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |