io.protostuff

Class GraphIOUtil

java.lang.Object

io.protostuff.GraphIOUtil

public final class GraphIOUtil
extends Object

IO Utilities for graph objects (references and cyclic dependencies).

Author:

David Yu

Date created:

Jan 19, 2011

Method Summary

Methods

Modifier and Type	Method and Description
static <T> int	mergeDelimitedFrom(DataInput in, T message, Schema<T> schema) Used by the code generated messages that implement Externalizable.
static <T> int	mergeDelimitedFrom(InputStream in, T message, Schema<T> schema) Merges the message (delimited) from the InputStream using the given schema.
static <T> int	mergeDelimitedFrom(InputStream in, T message, Schema<T> schema, LinkedBuffer buffer) Merges the message (delimited) from the InputStream using the given schema.
static <T> void	mergeFrom(byte[] data, int offset, int length, T message, Schema<T> schema) Merges the message with the byte array using the given schema.
static <T> void	mergeFrom(byte[] data, T message, Schema<T> schema) Merges the message with the byte array using the given schema.
static <T> void	mergeFrom(InputStream in, T message, Schema<T> schema) Merges the message from the InputStream using the given schema.
static <T> void	mergeFrom(InputStream in, T message, Schema<T> schema, LinkedBuffer buffer) Merges the message from the InputStream using the given schema.
static <T> boolean	optMergeDelimitedFrom(InputStream in, T message, Schema<T> schema, boolean drainRemainingBytesIfTooLarge, LinkedBuffer buffer) Optimal/Optional mergeDelimitedFrom - If the message does not fit the buffer, no merge is done and this method will return false.
static <T> boolean	optMergeDelimitedFrom(InputStream in, T message, Schema<T> schema, LinkedBuffer buffer) Optimal/Optional mergeDelimitedFrom - If the message does not fit the buffer, no merge is done and this method will return false.
static <T> int	optWriteDelimitedTo(OutputStream out, T message, Schema<T> schema, LinkedBuffer buffer) Optimal writeDelimitedTo - The varint32 prefix is written to the buffer instead of directly writing to outputstream.
static <T> byte[]	toByteArray(T message, Schema<T> schema, LinkedBuffer buffer) Serializes the message into a byte array using the given schema.
static <T> int	writeDelimitedTo(DataOutput out, T message, Schema<T> schema) Used by the code generated messages that implement Externalizable.
static <T> int	writeDelimitedTo(OutputStream out, T message, Schema<T> schema, LinkedBuffer buffer) Serializes the message, prefixed with its length, into an OutputStream.
static <T> int	writeTo(LinkedBuffer buffer, T message, Schema<T> schema) Writes the message into the LinkedBuffer using the given schema.
static <T> int	writeTo(OutputStream out, T message, Schema<T> schema, LinkedBuffer buffer) Serializes the message into an OutputStream using the given schema.

Methods inherited from class java.lang.Object

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

Method Detail

mergeFrom

public static <T> void mergeFrom(byte[] data,
                 T message,
                 Schema<T> schema)

Merges the message with the byte array using the given schema.

mergeFrom

public static <T> void mergeFrom(byte[] data,
                 int offset,
                 int length,
                 T message,
                 Schema<T> schema)

Merges the message with the byte array using the given schema.

mergeFrom

public static <T> void mergeFrom(InputStream in,
                 T message,
                 Schema<T> schema)
                      throws IOException

Merges the message from the InputStream using the given schema.

Throws:

IOException

mergeFrom

public static <T> void mergeFrom(InputStream in,
                 T message,
                 Schema<T> schema,
                 LinkedBuffer buffer)
                      throws IOException

Merges the message from the InputStream using the given schema.

The buffer's internal byte array will be used for reading the message.

Throws:

IOException

mergeDelimitedFrom

public static <T> int mergeDelimitedFrom(InputStream in,
                         T message,
                         Schema<T> schema)
                              throws IOException

Merges the message (delimited) from the InputStream using the given schema.

Returns:

the size of the message

Throws:

IOException

mergeDelimitedFrom

public static <T> int mergeDelimitedFrom(InputStream in,
                         T message,
                         Schema<T> schema,
                         LinkedBuffer buffer)
                              throws IOException

Merges the message (delimited) from the InputStream using the given schema.

The delimited message size must not be larger than the buffer's size/capacity. ProtobufException "size limit exceeded" is thrown otherwise.

Returns:

the size of the message

Throws:

IOException

mergeDelimitedFrom

public static <T> int mergeDelimitedFrom(DataInput in,
                         T message,
                         Schema<T> schema)
                              throws IOException

Used by the code generated messages that implement Externalizable. Merges from the DataInput.

Returns:

the size of the message

Throws:

IOException

toByteArray

public static <T> byte[] toByteArray(T message,
                     Schema<T> schema,
                     LinkedBuffer buffer)

Serializes the message into a byte array using the given schema.

Returns:

the byte array containing the data.

writeTo

public static <T> int writeTo(LinkedBuffer buffer,
              T message,
              Schema<T> schema)

Writes the message into the LinkedBuffer using the given schema.

Returns:

the size of the message

writeTo

public static <T> int writeTo(OutputStream out,
              T message,
              Schema<T> schema,
              LinkedBuffer buffer)
                   throws IOException

Serializes the message into an OutputStream using the given schema.

Returns:

the size of the message

Throws:

IOException

writeDelimitedTo

public static <T> int writeDelimitedTo(OutputStream out,
                       T message,
                       Schema<T> schema,
                       LinkedBuffer buffer)
                            throws IOException

Serializes the message, prefixed with its length, into an OutputStream.

Returns:

the size of the message

Throws:

IOException

writeDelimitedTo

public static <T> int writeDelimitedTo(DataOutput out,
                       T message,
                       Schema<T> schema)
                            throws IOException

Used by the code generated messages that implement Externalizable. Writes to the DataOutput .

Returns:

the size of the message.

Throws:

IOException

optMergeDelimitedFrom

public static <T> boolean optMergeDelimitedFrom(InputStream in,
                                T message,
                                Schema<T> schema,
                                LinkedBuffer buffer)
                                     throws IOException

Optimal/Optional mergeDelimitedFrom - If the message does not fit the buffer, no merge is done and this method will return false.

This is strictly for reading a single message from the stream because the buffer is aggressively filled when reading the delimited size (which could result into reading more bytes than it has to).

The remaining bytes will be drained (consumed and discared) when the message is too large.

Throws:

IOException

optMergeDelimitedFrom

public static <T> boolean optMergeDelimitedFrom(InputStream in,
                                T message,
                                Schema<T> schema,
                                boolean drainRemainingBytesIfTooLarge,
                                LinkedBuffer buffer)
                                     throws IOException

Optimal/Optional mergeDelimitedFrom - If the message does not fit the buffer, no merge is done and this method will return false.

This is strictly for reading a single message from the stream because the buffer is aggressively filled when reading the delimited size (which could result into reading more bytes than it has to).

Throws:

IOException

optWriteDelimitedTo

public static <T> int optWriteDelimitedTo(OutputStream out,
                          T message,
                          Schema<T> schema,
                          LinkedBuffer buffer)
                               throws IOException

Optimal writeDelimitedTo - The varint32 prefix is written to the buffer instead of directly writing to outputstream.

Returns:

the size of the message

Throws:

IOException