com.google.protobuf

Class ExtensionRegistryLite

java.lang.Object

com.google.protobuf.ExtensionRegistryLite

public class ExtensionRegistryLite
extends Object

A table of known extensions, searchable by name or field number. When parsing a protocol message that might have extensions, you must provide an ExtensionRegistryLite in which you have registered any extensions that you want to be able to parse. Otherwise, those extensions will just be treated like unknown fields.

For example, if you had the .proto file:

 option java_class = "MyProto";

 message Foo {
   extensions 1000 to max;
 }

 extend Foo {
   optional int32 bar;
 }
 

Then you might write code like:

 ExtensionRegistryLite registry = ExtensionRegistryLite.newInstance();
 registry.add(MyProto.bar);
 MyProto.Foo message = MyProto.Foo.parseFrom(input, registry);
 

Background:

You might wonder why this is necessary. Two alternatives might come to mind. First, you might imagine a system where generated extensions are automatically registered when their containing classes are loaded. This is a popular technique, but is bad design; among other things, it creates a situation where behavior can change depending on what classes happen to be loaded. It also introduces a security vulnerability, because an unprivileged class could cause its code to be called unexpectedly from a privileged class by registering itself as an extension of the right type.

Another option you might consider is lazy parsing: do not parse an extension until it is first requested, at which point the caller must provide a type to use. This introduces a different set of problems. First, it would require a mutex lock any time an extension was accessed, which would be slow. Second, corrupt data would not be detected until first access, at which point it would be much harder to deal with it. Third, it could violate the expectation that message objects are immutable, since the type provided could be any arbitrary message class. An unprivileged user could take advantage of this to inject a mutable object into a message belonging to privileged code and create mischief.

Author:

kenton@google.com Kenton Varda

Method Summary

Modifier and Type	Method and Description
void	add(GeneratedMessageLite.GeneratedExtension<?,?> extension) Add an extension from a lite generated file to the registry.
<ContainingType extends MessageLite> GeneratedMessageLite.GeneratedExtension<ContainingType,?>	findLiteExtensionByNumber(ContainingType containingTypeDefaultInstance, int fieldNumber) Find an extension by containing type and field number.
static ExtensionRegistryLite	getEmptyRegistry() Get the unmodifiable singleton empty instance of either ExtensionRegistryLite or ExtensionRegistry (if the full (non-Lite) proto libraries are available).
ExtensionRegistryLite	getUnmodifiable() Returns an unmodifiable view of the registry.
static boolean	isEagerlyParseMessageSets()
static ExtensionRegistryLite	newInstance() Construct a new, empty instance.
static void	setEagerlyParseMessageSets(boolean isEagerlyParse)

Methods inherited from class java.lang.Object

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

Method Detail

add

public final void add(GeneratedMessageLite.GeneratedExtension<?,?> extension)

Add an extension from a lite generated file to the registry.

findLiteExtensionByNumber

@Nullable
public <ContainingType extends MessageLite> GeneratedMessageLite.GeneratedExtension<ContainingType,?> findLiteExtensionByNumber(ContainingType containingTypeDefaultInstance,
                                                                                                                                          int fieldNumber)

Find an extension by containing type and field number.

Returns:

Information about the extension if found, or null otherwise.

getEmptyRegistry

public static ExtensionRegistryLite getEmptyRegistry()

Get the unmodifiable singleton empty instance of either ExtensionRegistryLite or ExtensionRegistry (if the full (non-Lite) proto libraries are available).

getUnmodifiable

public ExtensionRegistryLite getUnmodifiable()

Returns an unmodifiable view of the registry.

isEagerlyParseMessageSets

public static boolean isEagerlyParseMessageSets()

newInstance

public static ExtensionRegistryLite newInstance()

Construct a new, empty instance.

This may be an ExtensionRegistry if the full (non-Lite) proto libraries are available.

setEagerlyParseMessageSets

public static void setEagerlyParseMessageSets(boolean isEagerlyParse)