Package com.google.protobuf

Class TextFormat.Printer

java.lang.Object

com.google.protobuf.TextFormat.Printer

Enclosing class:

TextFormat

public static final class TextFormat.Printer
extends java.lang.Object

Helper class for converting protobufs to text.

Method Summary

Modifier and Type	Method	Description
TextFormat.Printer	escapingNonAscii(boolean escapeNonAscii)	Return a new Printer instance with the specified escape mode.
void	print(MessageOrBuilder message, java.lang.Appendable output)	Outputs a textual representation of the Protocol Message supplied into the parameter output.
void	print(UnknownFieldSet fields, java.lang.Appendable output)	Outputs a textual representation of fields to output.
void	printField(Descriptors.FieldDescriptor field, java.lang.Object value, java.lang.Appendable output)
java.lang.String	printFieldToString(Descriptors.FieldDescriptor field, java.lang.Object value)
void	printFieldValue(Descriptors.FieldDescriptor field, java.lang.Object value, java.lang.Appendable output)	Outputs a textual representation of the value of given field value.
java.lang.String	printToString(MessageOrBuilder message)	Like print(), but writes directly to a String and returns it.
java.lang.String	printToString(UnknownFieldSet fields)	Like print(), but writes directly to a String and returns it.
java.lang.String	shortDebugString(Descriptors.FieldDescriptor field, java.lang.Object value)	Generates a human readable form of the field, useful for debugging and other purposes, with no newline characters.
java.lang.String	shortDebugString(MessageOrBuilder message)	Generates a human readable form of this message, useful for debugging and other purposes, with no newline characters.
java.lang.String	shortDebugString(UnknownFieldSet fields)	Generates a human readable form of the unknown fields, useful for debugging and other purposes, with no newline characters.
TextFormat.Printer	usingTypeRegistry(TypeRegistry typeRegistry)	Creates a new TextFormat.Printer using the given typeRegistry.

Methods inherited from class java.lang.Object

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

Method Detail

escapingNonAscii

public TextFormat.Printer escapingNonAscii(boolean escapeNonAscii)

Return a new Printer instance with the specified escape mode.

Parameters:

escapeNonAscii - If true, the new Printer will escape non-ASCII characters (this is the default behavior. If false, the new Printer will print non-ASCII characters as is. In either case, the new Printer still escapes newlines and quotes in strings.

Returns:

a new Printer that clones all other configurations from the current TextFormat.Printer, with the escape mode set to the given parameter.

usingTypeRegistry

public TextFormat.Printer usingTypeRegistry(TypeRegistry typeRegistry)

Creates a new TextFormat.Printer using the given typeRegistry. The new Printer clones all other configurations from the current TextFormat.Printer.

Throws:

java.lang.IllegalArgumentException - if a registry is already set.

print

public void print(MessageOrBuilder message,
                  java.lang.Appendable output)
           throws java.io.IOException

Outputs a textual representation of the Protocol Message supplied into the parameter output. (This representation is the new version of the classic "ProtocolPrinter" output from the original Protocol Buffer system)

Throws:

java.io.IOException

print

public void print(UnknownFieldSet fields,
                  java.lang.Appendable output)
           throws java.io.IOException

Outputs a textual representation of fields to output.

Throws:

java.io.IOException

printFieldToString

public java.lang.String printFieldToString(Descriptors.FieldDescriptor field,
                                           java.lang.Object value)

printField

public void printField(Descriptors.FieldDescriptor field,
                       java.lang.Object value,
                       java.lang.Appendable output)
                throws java.io.IOException

Throws:

java.io.IOException

printFieldValue

public void printFieldValue(Descriptors.FieldDescriptor field,
                            java.lang.Object value,
                            java.lang.Appendable output)
                     throws java.io.IOException

Outputs a textual representation of the value of given field value.

Parameters:

field - the descriptor of the field

value - the value of the field

output - the output to which to append the formatted value

Throws:

java.lang.ClassCastException - if the value is not appropriate for the given field descriptor

java.io.IOException - if there is an exception writing to the output

printToString

public java.lang.String printToString(MessageOrBuilder message)

Like print(), but writes directly to a String and returns it.

printToString

public java.lang.String printToString(UnknownFieldSet fields)

Like print(), but writes directly to a String and returns it.

shortDebugString

public java.lang.String shortDebugString(MessageOrBuilder message)

Generates a human readable form of this message, useful for debugging and other purposes, with no newline characters.

shortDebugString

public java.lang.String shortDebugString(Descriptors.FieldDescriptor field,
                                         java.lang.Object value)

Generates a human readable form of the field, useful for debugging and other purposes, with no newline characters.

shortDebugString

public java.lang.String shortDebugString(UnknownFieldSet fields)

Generates a human readable form of the unknown fields, useful for debugging and other purposes, with no newline characters.