Class JsonFormat.Parser

java.lang.Object

com.google.protobuf.util.JsonFormat.Parser

Enclosing class:

JsonFormat

public static class JsonFormat.Parser
extends Object

A Parser parses the ProtoJSON format into a protobuf message.

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	DEFAULT_RECURSION_LIMIT
private final ExtensionRegistry	extensionRegistry
private final boolean	ignoringUnknownFields
private final boolean	legacyLenient
private final JsonFormat.TypeRegistry	oldRegistry
private final int	recursionLimit
private final TypeRegistry	registry

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Parser(TypeRegistry registry, JsonFormat.TypeRegistry oldRegistry, ExtensionRegistry extensionRegistry, boolean ignoreUnknownFields, int recursionLimit, boolean legacyLenient)

Method Summary

Modifier and Type	Method	Description
JsonFormat.Parser	ignoringUnknownFields()	Creates a new JsonFormat.Parser configured to not throw an exception when an unknown field is encountered.
void	merge(Reader json, Message.Builder builder)	Parses from the ProtoJSON encoding into a protobuf message.
void	merge(String json, Message.Builder builder)	Parses from the ProtoJSON format into a protobuf message.
(package private) JsonFormat.Parser	usingExtensionRegistry(ExtensionRegistry extensionRegistry)	Creates a new JsonFormat.Parser using the given extension registry.
(package private) JsonFormat.Parser	usingRecursionLimit(int recursionLimit)
JsonFormat.Parser	usingTypeRegistry(TypeRegistry registry)	Creates a new JsonFormat.Parser using the given registry.
JsonFormat.Parser	usingTypeRegistry(JsonFormat.TypeRegistry oldRegistry)	Creates a new JsonFormat.Parser using the given registry.

Methods inherited from class Object

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

Field Details

registry

private final TypeRegistry registry

oldRegistry

private final JsonFormat.TypeRegistry oldRegistry

extensionRegistry

private final ExtensionRegistry extensionRegistry

ignoringUnknownFields

private final boolean ignoringUnknownFields

recursionLimit

private final int recursionLimit

legacyLenient

private final boolean legacyLenient

DEFAULT_RECURSION_LIMIT

private static final int DEFAULT_RECURSION_LIMIT

See Also:

• Constant Field Values

Constructor Details

Parser

private Parser(TypeRegistry registry,
 JsonFormat.TypeRegistry oldRegistry,
 ExtensionRegistry extensionRegistry,
 boolean ignoreUnknownFields,
 int recursionLimit,
 boolean legacyLenient)

Method Details

usingTypeRegistry

public JsonFormat.Parser usingTypeRegistry(JsonFormat.TypeRegistry oldRegistry)

Creates a new JsonFormat.Parser using the given registry. The new Parser clones all other configurations from this Parser.

Throws:

IllegalArgumentException - if a registry is already set

usingTypeRegistry

public JsonFormat.Parser usingTypeRegistry(TypeRegistry registry)

Creates a new JsonFormat.Parser using the given registry. The new Parser clones all other configurations from this Parser.

Throws:

IllegalArgumentException - if a registry is already set

usingExtensionRegistry

JsonFormat.Parser usingExtensionRegistry(ExtensionRegistry extensionRegistry)

Creates a new JsonFormat.Parser using the given extension registry. The new Parser clones all other configurations from this Parser.

ignoringUnknownFields

public JsonFormat.Parser ignoringUnknownFields()

Creates a new JsonFormat.Parser configured to not throw an exception when an unknown field is encountered. The new Parser clones all other configurations from this Parser.

merge

public void merge(String json,
 Message.Builder builder)
           throws InvalidProtocolBufferException

Parses from the ProtoJSON format into a protobuf message.

Throws:

InvalidProtocolBufferException - if the input is not valid JSON proto3 format or there are unknown fields in the input.

merge

public void merge(Reader json,
 Message.Builder builder)
           throws IOException

Parses from the ProtoJSON encoding into a protobuf message.

Throws:

InvalidProtocolBufferException - if the input is not valid ProtoJSON format or there are unknown fields in the input

IOException - if reading from the input throws

usingRecursionLimit

JsonFormat.Parser usingRecursionLimit(int recursionLimit)