Uses of Interface
org.inferred.freebuilder.processor.source.Excerpt

Packages that use Excerpt

Package	Description
org.inferred.freebuilder.processor
org.inferred.freebuilder.processor.excerpt
org.inferred.freebuilder.processor.property
org.inferred.freebuilder.processor.source
org.inferred.freebuilder.processor.source.feature

Uses of Excerpt in org.inferred.freebuilder.processor

Classes in org.inferred.freebuilder.processor that implement Excerpt

Modifier and Type	Class	Description
static enum	Datatype.Visibility
class	GeneratedBuilder	Code generation for the @FreeBuilder annotation.
private static class	GeneratedBuilder.FieldAccessList
(package private) class	GeneratedStub
(package private) class	GeneratedType
private static final class	GwtSupport.CustomValueSerializer
private static final class	GwtSupport.GwtWhitelist

Fields in org.inferred.freebuilder.processor declared as Excerpt

Modifier and Type	Field	Description
private final Excerpt	BuildableType_Builder.Partial.suppressUnchecked
private Excerpt	BuildableType_Builder.suppressUnchecked
private final Excerpt	BuildableType_Builder.Value.suppressUnchecked

Fields in org.inferred.freebuilder.processor with type parameters of type Excerpt

Modifier and Type	Field	Description
private List<Excerpt>	Datatype_Builder.generatedBuilderAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.generatedBuilderAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.generatedBuilderAnnotations
private List<Excerpt>	Datatype_Builder.nestedClasses
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.nestedClasses
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.nestedClasses
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.valueTypeAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.valueTypeAnnotations
private List<Excerpt>	Datatype_Builder.valueTypeAnnotations

Methods in org.inferred.freebuilder.processor that return Excerpt

Modifier and Type	Method	Description
private static Excerpt	GeneratedBuilder.extending(Object type, boolean isInterface)	Returns an Excerpt of "implements/extends type".
Excerpt	BuildableType.newBuilder(BuilderFactory.TypeInference typeInference)	Returns an excerpt calling the Builder factory method.
abstract Excerpt	BuilderFactory.newBuilder(Type builderType, BuilderFactory.TypeInference typeInference)	Returns an excerpt calling the Builder factory method.
Excerpt	BuildableType_Builder.Partial.suppressUnchecked()
Excerpt	BuildableType_Builder.suppressUnchecked()	Returns the value that will be returned by BuildableType.suppressUnchecked().
Excerpt	BuildableType_Builder.Value.suppressUnchecked()
abstract Excerpt	BuildableType.suppressUnchecked()
private static Excerpt	BuildableType.suppressUncheckedExcerptFor(DeclaredType datatype)

Methods in org.inferred.freebuilder.processor that return types with arguments of type Excerpt

Modifier and Type	Method	Description
List<Excerpt>	Datatype_Builder.getGeneratedBuilderAnnotations()	Returns an unmodifiable view of the list that will be returned by Datatype.getGeneratedBuilderAnnotations().
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.getGeneratedBuilderAnnotations()
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.getGeneratedBuilderAnnotations()
abstract com.google.common.collect.ImmutableList<Excerpt>	Datatype.getGeneratedBuilderAnnotations()	Returns a list of annotations that should be applied to the generated builder class.
List<Excerpt>	Datatype_Builder.getNestedClasses()	Returns an unmodifiable view of the list that will be returned by Datatype.getNestedClasses().
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.getNestedClasses()
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.getNestedClasses()
abstract com.google.common.collect.ImmutableList<Excerpt>	Datatype.getNestedClasses()	Returns a list of nested classes that should be added to the generated builder class.
List<Excerpt>	Datatype_Builder.getValueTypeAnnotations()	Returns an unmodifiable view of the list that will be returned by Datatype.getValueTypeAnnotations().
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Partial.getValueTypeAnnotations()
com.google.common.collect.ImmutableList<Excerpt>	Datatype_Builder.Value.getValueTypeAnnotations()
abstract com.google.common.collect.ImmutableList<Excerpt>	Datatype.getValueTypeAnnotations()	Returns a list of annotations that should be applied to the generated value class.

Methods in org.inferred.freebuilder.processor with parameters of type Excerpt

Modifier and Type	Method	Description
Datatype.Builder	Datatype_Builder.addGeneratedBuilderAnnotations(Excerpt element)	Adds element to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.addGeneratedBuilderAnnotations(Excerpt... elements)	Adds each element of elements to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.addNestedClasses(Excerpt element)	Adds element to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.addNestedClasses(Excerpt... elements)	Adds each element of elements to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.addValueTypeAnnotations(Excerpt element)	Adds element to the list to be returned from Datatype.getValueTypeAnnotations().
Datatype.Builder	Datatype_Builder.addValueTypeAnnotations(Excerpt... elements)	Adds each element of elements to the list to be returned from Datatype.getValueTypeAnnotations().
BuildableType.Builder	BuildableType_Builder.suppressUnchecked(Excerpt suppressUnchecked)	Sets the value to be returned by BuildableType.suppressUnchecked().

Method parameters in org.inferred.freebuilder.processor with type arguments of type Excerpt

Modifier and Type	Method	Description
Datatype.Builder	Datatype_Builder.addAllGeneratedBuilderAnnotations(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.addAllGeneratedBuilderAnnotations(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.addAllGeneratedBuilderAnnotations(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.addAllNestedClasses(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.addAllNestedClasses(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.addAllNestedClasses(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.addAllValueTypeAnnotations(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getValueTypeAnnotations().
Datatype.Builder	Datatype_Builder.addAllValueTypeAnnotations(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Datatype.getValueTypeAnnotations().
Datatype.Builder	Datatype_Builder.addAllValueTypeAnnotations(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Datatype.getValueTypeAnnotations().
BuildableType.Builder	BuildableType_Builder.mapSuppressUnchecked(UnaryOperator<Excerpt> mapper)	Replaces the value to be returned by BuildableType.suppressUnchecked() by applying mapper to it and using the result.
Datatype.Builder	Datatype_Builder.mutateGeneratedBuilderAnnotations(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Datatype.getGeneratedBuilderAnnotations().
Datatype.Builder	Datatype_Builder.mutateNestedClasses(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Datatype.getNestedClasses().
Datatype.Builder	Datatype_Builder.mutateValueTypeAnnotations(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Datatype.getValueTypeAnnotations().

Uses of Excerpt in org.inferred.freebuilder.processor.excerpt

Classes in org.inferred.freebuilder.processor.excerpt that implement Excerpt

Modifier and Type	Class	Description
class	BuildableList	Excerpts defining a list implementation that stores a mixture of builders and value types.
class	CheckedBiMap
private static class	CheckedBiMap.CheckedEntry
private static class	CheckedBiMap.CheckedEntryIterator
private static class	CheckedBiMap.CheckedEntrySet
class	CheckedList	Excerpts defining a list implementation that delegates to a provided add method to perform element validation and insertion into a random-access backing list.
class	CheckedListMultimap	Excerpts defining a multimap implementation that delegates to a provided put method to perform entry validation and insertion into a backing multimap.
class	CheckedMap	Excerpts defining a map implementation that delegates to a provided put method to perform entry validation and insertion into a backing map.
private static class	CheckedMap.CheckedEntry
private static class	CheckedMap.CheckedEntryIterator
private static class	CheckedMap.CheckedEntrySet
class	CheckedMultiset	Excerpts defining a multiset implementation that delegates to a provided setCount method to perform element validation and insertion into a backing multiset.
class	CheckedNavigableSet	Excerpts defining a navigable set implementation that delegates to a provided add method to perform element validation and insertion into a backing set.
class	CheckedSet	Excerpts defining a set implementation that delegates to a provided add method to perform element validation and insertion into a backing set.
class	CheckedSetMultimap	Excerpts defining a multimap implementation that delegates to a provided put method to perform entry validation and insertion into a backing multimap.

Uses of Excerpt in org.inferred.freebuilder.processor.property

Classes in org.inferred.freebuilder.processor.property that implement Excerpt

Modifier and Type	Class	Description
private static class	ListProperty.ImmutableListMethod
private static class	MapProperty.ImmutableMapMethod
private static class	SetProperty.ImmutableSetMethod

Fields in org.inferred.freebuilder.processor.property with type parameters of type Excerpt

Modifier and Type	Field	Description
private List<Excerpt>	Property_Builder.accessorAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.accessorAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.accessorAnnotations
private List<Excerpt>	Property_Builder.getterAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.getterAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.getterAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.putAnnotations
private List<Excerpt>	Property_Builder.putAnnotations
private final com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.putAnnotations

Methods in org.inferred.freebuilder.processor.property that return types with arguments of type Excerpt

Modifier and Type	Method	Description
List<Excerpt>	Property_Builder.getAccessorAnnotations()	Returns an unmodifiable view of the list that will be returned by Property.getAccessorAnnotations().
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.getAccessorAnnotations()
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.getAccessorAnnotations()
abstract com.google.common.collect.ImmutableList<Excerpt>	Property.getAccessorAnnotations()	Returns a list of annotations that should be applied to the accessor methods of this property; that is, the getter method, and a single setter method that will accept the result of the getter method as its argument.
List<Excerpt>	Property_Builder.getGetterAnnotations()	Returns an unmodifiable view of the list that will be returned by Property.getGetterAnnotations().
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.getGetterAnnotations()
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.getGetterAnnotations()
abstract com.google.common.collect.ImmutableList<Excerpt>	Property.getGetterAnnotations()	Returns a list of annotations that should be applied to the getter method of this property.
List<Excerpt>	Property_Builder.getPutAnnotations()	Returns an unmodifiable view of the list that will be returned by Property.getPutAnnotations().
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Partial.getPutAnnotations()
com.google.common.collect.ImmutableList<Excerpt>	Property_Builder.Value.getPutAnnotations()
abstract com.google.common.collect.ImmutableList<Excerpt>	Property.getPutAnnotations()	Returns a list of annotations that should be applied to the put method of this property.

Methods in org.inferred.freebuilder.processor.property with parameters of type Excerpt

Modifier and Type	Method	Description
Property.Builder	Property_Builder.addAccessorAnnotations(Excerpt element)	Adds element to the list to be returned from Property.getAccessorAnnotations().
Property.Builder	Property_Builder.addAccessorAnnotations(Excerpt... elements)	Adds each element of elements to the list to be returned from Property.getAccessorAnnotations().
private void	BuildableListProperty.addFieldAssignment(SourceBuilder code, Excerpt finalField, String builder, String buildMethod)
private void	BuildableProperty.addFieldAssignment(SourceBuilder code, Excerpt finalField, String builder, String buildMethod)
void	BiMapProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	BuildableListProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	BuildableProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	DefaultProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	ListMultimapProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	ListProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	MapProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	MultisetProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	NullableProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	OptionalProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	PrimitiveOptionalProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
abstract void	PropertyCodeGenerator.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)	Add the final assignment of the property to the value object's source code.
void	SetMultimapProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	SetProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	SortedSetProperty.addFinalFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
Property.Builder	Property_Builder.addGetterAnnotations(Excerpt element)	Adds element to the list to be returned from Property.getGetterAnnotations().
Property.Builder	Property_Builder.addGetterAnnotations(Excerpt... elements)	Adds each element of elements to the list to be returned from Property.getGetterAnnotations().
void	BuildableListProperty.addPartialFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	BuildableProperty.addPartialFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)
void	PropertyCodeGenerator.addPartialFieldAssignment(SourceBuilder code, Excerpt finalField, String builder)	Add the final assignment of the property to the partial value object's source code.
Property.Builder	Property_Builder.addPutAnnotations(Excerpt element)	Adds element to the list to be returned from Property.getPutAnnotations().
Property.Builder	Property_Builder.addPutAnnotations(Excerpt... elements)	Adds each element of elements to the list to be returned from Property.getPutAnnotations().
void	OptionalProperty.addReadValueFragment(SourceBuilder code, Excerpt finalField)
void	PropertyCodeGenerator.addReadValueFragment(SourceBuilder code, Excerpt finalField)	Adds a fragment converting the value object's field to the property's type.
void	BiMapProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	BuildableListProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	BuildableProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	DefaultProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	ListMultimapProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	ListProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	MapProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	MultisetProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	NullableProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	OptionalProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	PrimitiveOptionalProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
abstract void	PropertyCodeGenerator.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)	Adds a set call for the property from a function result to the builder's source code.
void	SetMultimapProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	SetProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)
void	SortedSetProperty.addSetFromResult(SourceBuilder code, Excerpt builder, Excerpt variable)

Method parameters in org.inferred.freebuilder.processor.property with type arguments of type Excerpt

Modifier and Type	Method	Description
Property.Builder	Property_Builder.addAllAccessorAnnotations(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getAccessorAnnotations().
Property.Builder	Property_Builder.addAllAccessorAnnotations(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getAccessorAnnotations().
Property.Builder	Property_Builder.addAllAccessorAnnotations(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Property.getAccessorAnnotations().
Property.Builder	Property_Builder.addAllGetterAnnotations(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getGetterAnnotations().
Property.Builder	Property_Builder.addAllGetterAnnotations(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getGetterAnnotations().
Property.Builder	Property_Builder.addAllGetterAnnotations(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Property.getGetterAnnotations().
Property.Builder	Property_Builder.addAllPutAnnotations(Iterable<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getPutAnnotations().
Property.Builder	Property_Builder.addAllPutAnnotations(Spliterator<? extends Excerpt> elements)	Adds each element of elements to the list to be returned from Property.getPutAnnotations().
Property.Builder	Property_Builder.addAllPutAnnotations(BaseStream<? extends Excerpt,?> elements)	Adds each element of elements to the list to be returned from Property.getPutAnnotations().
Property.Builder	Property_Builder.mutateAccessorAnnotations(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Property.getAccessorAnnotations().
Property.Builder	Property_Builder.mutateGetterAnnotations(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Property.getGetterAnnotations().
Property.Builder	Property_Builder.mutatePutAnnotations(Consumer<? super List<Excerpt>> mutator)	Applies mutator to the list to be returned from Property.getPutAnnotations().

Uses of Excerpt in org.inferred.freebuilder.processor.source

Classes in org.inferred.freebuilder.processor.source that implement Excerpt

Modifier and Type	Class	Description
class	FieldAccess
class	LazyName
private static final class	PreconditionExcerpts.GuavaCheckExcerpt
class	Type	Representation of a parameterized class or interface type.
static class	Type.JavadocLink
(package private) static class	Type.TypeImpl
class	TypeClass	Representation of a class or interface element.
class	Variable

Fields in org.inferred.freebuilder.processor.source declared as Excerpt

Modifier and Type	Field	Description
private final Excerpt	LazyName.definition
static final Excerpt	Excerpts.EMPTY

Methods in org.inferred.freebuilder.processor.source with type parameters of type Excerpt

Modifier and Type	Method	Description
static <E extends ValueType & Excerpt> LazyName	LazyName.of(String preferredName, E definition)

Methods in org.inferred.freebuilder.processor.source that return Excerpt

Modifier and Type	Method	Description
static Excerpt	Excerpts.add(String fmt, Object... args)
static Excerpt	PreconditionExcerpts.checkArgument(String conditionTemplate, String messageTemplate, Object... args)	Returns an excerpt equivalent to Guava's Preconditions.checkArgument(boolean, String, Object...).
static Excerpt	PreconditionExcerpts.checkState(String conditionTemplate, String messageTemplate, Object... args)	Returns an excerpt equivalent to Guava's Preconditions.checkState(boolean, String, Object...).
Excerpt	Type.constructor()	Returns a source excerpt suitable for constructing an instance of this type, including "new" keyword but excluding brackets.
Excerpt	TypeClass.declaration()	Returns a source excerpt suitable for declaring this type element.
Excerpt	TypeClass.declarationParameters()	Returns a source excerpt of the type parameters of this type element, including bounds and angle brackets.
Excerpt	Type.diamondOperator()	Returns a source excerpt equivalent to the diamond operator for this type.
static Excerpt	ObjectsExcerpts.equals(Object a, Object b, TypeKind kind)	Returns an Excerpt equivalent to Objects.equals(a, b).
private static Excerpt	ObjectsExcerpts.equalsExcerpt(boolean areEqual, Object a, Object b, TypeKind kind)
static Excerpt	Excerpts.generated(Class<?> generator)	Returns an excerpt of the Generated annotation, if available, with value set to the full name of the generator class as recommended.
static Excerpt	Excerpts.join(String separator, Iterable<?> excerpts)
static Excerpt	ObjectsExcerpts.notEquals(Object a, Object b, TypeKind kind)	Returns an Excerpt equivalent to !Objects.equals(a, b).
Excerpt	FieldAccess.on(Object obj)
Excerpt	Type.typeParameters()	Returns a source excerpt of the type parameters of this type, including angle brackets.
Excerpt	Type.JavadocLink.withText(String fmt, Object... args)

Methods in org.inferred.freebuilder.processor.source with parameters of type Excerpt

Modifier and Type	Method	Description
SourceBuilder	SourceBuilder.add(Excerpt excerpt)	Equivalent to add("%s", excerpt).

Constructors in org.inferred.freebuilder.processor.source with parameters of type Excerpt

Modifier	Constructor	Description
private	LazyName(String preferredName, Excerpt definition)	A LazyName, when first used, determines a unique name, using preferredName if still available, and registers the definition to be added later.

Uses of Excerpt in org.inferred.freebuilder.processor.source.feature

Classes in org.inferred.freebuilder.processor.source.feature that implement Excerpt

Modifier and Type	Class	Description
private static class	Jsr305.NullableExcerpt

Methods in org.inferred.freebuilder.processor.source.feature that return Excerpt

Modifier and Type	Method	Description
static Excerpt	Jsr305.nullable()	Excerpt that adds a JSR-303 Nullable annotation, if available.