io.protostuff

Class JsonXOutput

java.lang.Object

io.protostuff.WriteSession

io.protostuff.JsonXOutput

All Implemented Interfaces:

Output, StatefulOutput

public final class JsonXOutput
extends WriteSession
implements Output, StatefulOutput

An optimized json output which is efficient in writing numeric keys and pre-encoded utf8 strings (in byte array form).

This is the appropriate output sink to use when writing from binary (protostuff,protobuf,etc) pipes.

Author:

David Yu

Date created:

Jul 2, 2010

Nested Class Summary

Nested classes/interfaces inherited from class io.protostuff.WriteSession

WriteSession.FlushHandler

Field Summary

Fields inherited from class io.protostuff.WriteSession

flushHandler, head, nextBufferSize, out, sink, size, tail

Constructor Summary

Constructors

Constructor and Description
JsonXOutput(LinkedBuffer head, boolean numeric, Schema<?> schema)
JsonXOutput(LinkedBuffer head, OutputStream out, boolean numeric, Schema<?> schema)
JsonXOutput(LinkedBuffer head, OutputStream out, WriteSession.FlushHandler flushHandler, int nextBufferSize, boolean numeric, Schema<?> schema)

Method Summary

Modifier and Type	Method and Description
JsonXOutput	clear()
int	getLastNumber() Gets the last field number written.
boolean	isLastRepeated() Returns true if the last written field was a repeated field.
boolean	isNumeric() Returns whether the incoming messages' field names are numeric.
void	reset() Resets this output for re-use.
void	updateLast(Schema<?> schema, Schema<?> lastSchema)
JsonXOutput	use(Schema<?> schema) Before serializing a message/object tied to a schema, this should be called.
void	writeBool(int fieldNumber, boolean value, boolean repeated)
void	writeByteArray(int fieldNumber, byte[] value, boolean repeated)
void	writeByteRange(boolean utf8String, int fieldNumber, byte[] value, int offset, int length, boolean repeated)
void	writeBytes(int fieldNumber, ByteBuffer value, boolean repeated) Writes a ByteBuffer field.
void	writeBytes(int fieldNumber, ByteString value, boolean repeated)
void	writeDouble(int fieldNumber, double value, boolean repeated)
void	writeEnum(int fieldNumber, int value, boolean repeated)
void	writeFixed32(int fieldNumber, int value, boolean repeated)
void	writeFixed64(int fieldNumber, long value, boolean repeated)
void	writeFloat(int fieldNumber, float value, boolean repeated)
void	writeInt32(int fieldNumber, int value, boolean repeated)
void	writeInt64(int fieldNumber, long value, boolean repeated)
<T> void	writeObject(int fieldNumber, T value, Schema<T> schema, boolean repeated)
void	writeSFixed32(int fieldNumber, int value, boolean repeated)
void	writeSFixed64(int fieldNumber, long value, boolean repeated)
void	writeSInt32(int fieldNumber, int value, boolean repeated)
void	writeSInt64(int fieldNumber, long value, boolean repeated)
void	writeString(int fieldNumber, String value, boolean repeated)
void	writeUInt32(int fieldNumber, int value, boolean repeated)
void	writeUInt64(int fieldNumber, long value, boolean repeated)

Methods inherited from class io.protostuff.WriteSession

flush, flush, flush, getSize, toByteArray

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonXOutput

public JsonXOutput(LinkedBuffer head,
                   boolean numeric,
                   Schema<?> schema)

JsonXOutput

public JsonXOutput(LinkedBuffer head,
                   OutputStream out,
                   WriteSession.FlushHandler flushHandler,
                   int nextBufferSize,
                   boolean numeric,
                   Schema<?> schema)

JsonXOutput

public JsonXOutput(LinkedBuffer head,
                   OutputStream out,
                   boolean numeric,
                   Schema<?> schema)

Method Detail

reset

public void reset()

Resets this output for re-use.

Overrides:

reset in class WriteSession

clear

public JsonXOutput clear()

Overrides:

clear in class WriteSession

use

public JsonXOutput use(Schema<?> schema)

Before serializing a message/object tied to a schema, this should be called.

isNumeric

public boolean isNumeric()

Returns whether the incoming messages' field names are numeric.

getLastNumber

public int getLastNumber()

Gets the last field number written.

isLastRepeated

public boolean isLastRepeated()

Returns true if the last written field was a repeated field.

updateLast

public void updateLast(Schema<?> schema,
                       Schema<?> lastSchema)

Specified by:

updateLast in interface StatefulOutput

writeBool

public void writeBool(int fieldNumber,
                      boolean value,
                      boolean repeated)
               throws IOException

Specified by:

writeBool in interface Output

Throws:

IOException

writeByteArray

public void writeByteArray(int fieldNumber,
                           byte[] value,
                           boolean repeated)
                    throws IOException

Specified by:

writeByteArray in interface Output

Throws:

IOException

writeByteRange

public void writeByteRange(boolean utf8String,
                           int fieldNumber,
                           byte[] value,
                           int offset,
                           int length,
                           boolean repeated)
                    throws IOException

Specified by:

writeByteRange in interface Output

Throws:

IOException

writeBytes

public void writeBytes(int fieldNumber,
                       ByteString value,
                       boolean repeated)
                throws IOException

Specified by:

writeBytes in interface Output

Throws:

IOException

writeDouble

public void writeDouble(int fieldNumber,
                        double value,
                        boolean repeated)
                 throws IOException

Specified by:

writeDouble in interface Output

Throws:

IOException

writeEnum

public void writeEnum(int fieldNumber,
                      int value,
                      boolean repeated)
               throws IOException

Specified by:

writeEnum in interface Output

Throws:

IOException

writeFixed32

public void writeFixed32(int fieldNumber,
                         int value,
                         boolean repeated)
                  throws IOException

Specified by:

writeFixed32 in interface Output

Throws:

IOException

writeFixed64

public void writeFixed64(int fieldNumber,
                         long value,
                         boolean repeated)
                  throws IOException

Specified by:

writeFixed64 in interface Output

Throws:

IOException

writeFloat

public void writeFloat(int fieldNumber,
                       float value,
                       boolean repeated)
                throws IOException

Specified by:

writeFloat in interface Output

Throws:

IOException

writeInt32

public void writeInt32(int fieldNumber,
                       int value,
                       boolean repeated)
                throws IOException

Specified by:

writeInt32 in interface Output

Throws:

IOException

writeInt64

public void writeInt64(int fieldNumber,
                       long value,
                       boolean repeated)
                throws IOException

Specified by:

writeInt64 in interface Output

Throws:

IOException

writeSFixed32

public void writeSFixed32(int fieldNumber,
                          int value,
                          boolean repeated)
                   throws IOException

Specified by:

writeSFixed32 in interface Output

Throws:

IOException

writeSFixed64

public void writeSFixed64(int fieldNumber,
                          long value,
                          boolean repeated)
                   throws IOException

Specified by:

writeSFixed64 in interface Output

Throws:

IOException

writeSInt32

public void writeSInt32(int fieldNumber,
                        int value,
                        boolean repeated)
                 throws IOException

Specified by:

writeSInt32 in interface Output

Throws:

IOException

writeSInt64

public void writeSInt64(int fieldNumber,
                        long value,
                        boolean repeated)
                 throws IOException

Specified by:

writeSInt64 in interface Output

Throws:

IOException

writeString

public void writeString(int fieldNumber,
                        String value,
                        boolean repeated)
                 throws IOException

Specified by:

writeString in interface Output

Throws:

IOException

writeUInt32

public void writeUInt32(int fieldNumber,
                        int value,
                        boolean repeated)
                 throws IOException

Specified by:

writeUInt32 in interface Output

Throws:

IOException

writeUInt64

public void writeUInt64(int fieldNumber,
                        long value,
                        boolean repeated)
                 throws IOException

Specified by:

writeUInt64 in interface Output

Throws:

IOException

writeObject

public <T> void writeObject(int fieldNumber,
                            T value,
                            Schema<T> schema,
                            boolean repeated)
                     throws IOException

Specified by:

writeObject in interface Output

Throws:

IOException

writeBytes

public void writeBytes(int fieldNumber,
                       ByteBuffer value,
                       boolean repeated)
                throws IOException

Writes a ByteBuffer field.

Specified by:

writeBytes in interface Output

Throws:

IOException