JBoss Marshalling 1.3.0.CR9

org.jboss.marshalling
Class Marshalling

java.lang.Object
  extended by org.jboss.marshalling.Marshalling

public final class Marshalling
extends Object

Static utility methods for simplifying use of marshallers.


Method Summary
static ByteInput createByteInput(ByteBuffer buffer)
          Create a ByteInput wrapper for a ByteBuffer.
static ByteInput createByteInput(InputStream inputStream)
          Create a ByteInput wrapper for an InputStream.
static ByteOutput createByteOutput(ByteBuffer buffer)
          Create a ByteOutput wrapper for a ByteBuffer.
static ByteOutput createByteOutput(OutputStream outputStream)
          Create a ByteOutput wrapper for an OutputStream.
static InputStream createInputStream(ByteInput byteInput)
          Create an InputStream wrapper for a ByteInput.
static OptionalDataException createOptionalDataException(boolean eof)
          Construct a new OptionalDataException.
static OptionalDataException createOptionalDataException(int length)
          Construct a new OptionalDataException.
static OutputStream createOutputStream(ByteOutput byteOutput)
          Create a OutputStream wrapper for a ByteOutput.
static MarshallerFactory getMarshallerFactory(String name)
          Deprecated. It is recommended that you use getProvidedMarshallerFactory(String) instead; using the context class loader to find a marshalling implementation is risky at best as the user may have just about anything on their class path.
static MarshallerFactory getMarshallerFactory(String name, ClassLoader classLoader)
          Get a marshaller factory, by name.
static MarshallerFactory getProvidedMarshallerFactory(String name)
          Get a marshaller factory which is visible to this implementation, by name.
static ClassExternalizerFactory nullClassExternalizerFactory()
          Return the null class externalizer factory.
static ClassTable nullClassTable()
          Return the null class table instance.
static Externalizer nullExternalizer()
          Get a null externalizer.
static ObjectResolver nullObjectResolver()
          Return the null object resolver.
static ObjectTable nullObjectTable()
          Return the null object instance table.
static StreamHeader nullStreamHeader()
          Get the default stream header producer, which reads and writes no header at all.
static void readFully(ByteInput input, byte[] dest)
          Read bytes from a ByteInput.
static void readFully(ByteInput input, byte[] dest, int offs, int len)
          Read bytes from a ByteInput.
static StreamHeader streamHeader(byte[] headerBytes)
          Create a stream header that uses the given bytes.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getMarshallerFactory

@Deprecated
public static MarshallerFactory getMarshallerFactory(String name)
Deprecated. It is recommended that you use getProvidedMarshallerFactory(String) instead; using the context class loader to find a marshalling implementation is risky at best as the user may have just about anything on their class path.

Get a marshaller factory, by name. Uses the thread's current context classloader, if available, to locate the factory.

Parameters:
name - the name of the protocol to acquire
Returns:
the marshaller factory, or null if no matching factory was found
See Also:
ServiceLoader

getMarshallerFactory

public static MarshallerFactory getMarshallerFactory(String name,
                                                     ClassLoader classLoader)
Get a marshaller factory, by name. Uses the given classloader to locate the factory.

Parameters:
name - the name of the protocol to acquire
classLoader - the class loader to use
Returns:
the marshaller factory, or null if no matching factory was found
See Also:
ServiceLoader

getProvidedMarshallerFactory

public static MarshallerFactory getProvidedMarshallerFactory(String name)
Get a marshaller factory which is visible to this implementation, by name. Uses the class loader of this API.

Parameters:
name - the name of the protocol to acquire
Returns:
the marshaller factory, or null if no matching factory was found

nullStreamHeader

public static StreamHeader nullStreamHeader()
Get the default stream header producer, which reads and writes no header at all.

Returns:
the default stream header producer

streamHeader

public static StreamHeader streamHeader(byte[] headerBytes)
Create a stream header that uses the given bytes.

Parameters:
headerBytes - the header bytes
Returns:
the stream header object

readFully

public static void readFully(ByteInput input,
                             byte[] dest)
                      throws IOException
Read bytes from a ByteInput. Fully fills in the array.

Parameters:
input - the input
dest - the destination
Throws:
EOFException - if the end of file is reached before the array is filled
IOException - if an I/O error occurs

readFully

public static void readFully(ByteInput input,
                             byte[] dest,
                             int offs,
                             int len)
                      throws IOException
Read bytes from a ByteInput. Fully fills in len bytes in the array.

Parameters:
input - the input
dest - the destination
offs - the offset into the array
len - the number of bytes
Throws:
EOFException - if the end of file is reached before the array is filled
IOException - if an I/O error occurs

createByteInput

public static ByteInput createByteInput(ByteBuffer buffer)
Create a ByteInput wrapper for a ByteBuffer.

Parameters:
buffer - the byte buffer
Returns:
the byte input wrapper

createByteInput

public static ByteInput createByteInput(InputStream inputStream)
Create a ByteInput wrapper for an InputStream.

Parameters:
inputStream - the input stream
Returns:
the byte input wrapper

createInputStream

public static InputStream createInputStream(ByteInput byteInput)
Create an InputStream wrapper for a ByteInput.

Parameters:
byteInput - the byte input
Returns:
the input stream wrapper

createByteOutput

public static ByteOutput createByteOutput(ByteBuffer buffer)
Create a ByteOutput wrapper for a ByteBuffer.

Parameters:
buffer - the byte buffer
Returns:
the byte output wrapper

createByteOutput

public static ByteOutput createByteOutput(OutputStream outputStream)
Create a ByteOutput wrapper for an OutputStream.

Parameters:
outputStream - the output stream
Returns:
the byte output wrapper

createOutputStream

public static OutputStream createOutputStream(ByteOutput byteOutput)
Create a OutputStream wrapper for a ByteOutput.

Parameters:
byteOutput - the byte output
Returns:
the output stream wrapper

nullClassExternalizerFactory

public static ClassExternalizerFactory nullClassExternalizerFactory()
Return the null class externalizer factory. This instance does not externalize any classes.

Returns:
the null class externalizer factory

nullObjectResolver

public static ObjectResolver nullObjectResolver()
Return the null object resolver. This instance does not translate objects in any way.

Returns:
the null object resolver

nullObjectTable

public static ObjectTable nullObjectTable()
Return the null object instance table. This instance contains no predefined instances.

Returns:
the null instance table

nullClassTable

public static ClassTable nullClassTable()
Return the null class table instance. This instance contains no predefined classes.

Returns:
the null class table

createOptionalDataException

public static OptionalDataException createOptionalDataException(boolean eof)
Construct a new OptionalDataException. This method is necssary because there are no public constructors in the API.

Parameters:
eof - true if there is no more data in the buffered part of the stream
Returns:
a new OptionalDataException

createOptionalDataException

public static OptionalDataException createOptionalDataException(int length)
Construct a new OptionalDataException. This method is necssary because there are no public constructors in the API.

Parameters:
length - the number of bytes of primitive data available to be read in the current buffer
Returns:
a new OptionalDataException

nullExternalizer

public static Externalizer nullExternalizer()
Get a null externalizer. Useful in conjunction with ObjectTable entries. This externalizer reads and writes no data.

Returns:
the null externalizer

JBoss Marshalling 1.3.0.CR9

Copyright © 2011 JBoss, a division of Red Hat, Inc.