Package org.inferred.freebuilder.processor

Class BuildableType

java.lang.Object

org.inferred.freebuilder.processor.BuildableType

Direct Known Subclasses:

BuildableType_Builder.Rebuildable

public abstract class BuildableType
extends Object

Metadata about a buildable user type.

A buildable type is one with a Builder class providing a similar API to proto or @FreeBuilder:

• a public constructor, or static builder()/newBuilder() method;
• build(), buildPartial() and clear() methods; and
• a mergeFrom(Value) method.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BuildableType.Builder
private static final class	BuildableType.IsBuildMethod
private static final class	BuildableType.IsMergeFromMethod
private static final class	BuildableType.IsToBuilderMethod
static enum	BuildableType.MergeBuilderMethod	How to merge the values from one Builder into another.
static enum	BuildableType.PartialToBuilderMethod	How to convert a partial value into a Builder.

Field Summary

Fields

Modifier and Type	Field	Description
private static final Function<Element,Stream<ExecutableElement>>	METHODS
private static final Function<Element,Stream<TypeElement>>	TYPES

Constructor Summary

Constructors

Constructor	Description
BuildableType()

Method Summary

Modifier and Type	Method	Description
abstract BuilderFactory	builderFactory()
abstract Type	builderType()	Returns the builder type that will build instances of type().
static BuildableType	create(DeclaredType datatype, DeclaredType builder, Elements elements, Types types)
private static BuildableType.MergeBuilderMethod	detectMergeFromBuilderMethod(DeclaredType builder, Elements elements, Types types, TypeElement datatypeElement)
private static BuildableType.PartialToBuilderMethod	detectPartialToBuilderMethod(DeclaredType datatype, DeclaredType builder, Elements elements, Types types)
private static boolean	isBuilderType(TypeElement element)
private static boolean	isCallableMethod(ExecutableElement element)
private static boolean	isClearMethod(ExecutableElement element)
static Optional<DeclaredType>	maybeBuilder(DeclaredType type, Elements elements, Types types)
abstract BuildableType.MergeBuilderMethod	mergeBuilder()
private static boolean	methodIsObscured(DeclaredType targetType, Elements elements, Types types, DeclaredType returnType, String methodName, DeclaredType... parameterTypes)
Excerpt	newBuilder(BuilderFactory.TypeInference typeInference)	Returns an excerpt calling the Builder factory method.
abstract BuildableType.PartialToBuilderMethod	partialToBuilder()
abstract Excerpt	suppressUnchecked()
private static Excerpt	suppressUncheckedExcerptFor(DeclaredType datatype)
abstract Type	type()	Returns the parameterized buildable type.

Methods inherited from class java.lang.Object

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

Field Details

TYPES

private static final Function<Element,Stream<TypeElement>> TYPES

METHODS

private static final Function<Element,Stream<ExecutableElement>> METHODS

Constructor Details

BuildableType

public BuildableType()

Method Details

type

public abstract Type type()

Returns the parameterized buildable type.

This may be parameterized with any compatible types, including concrete types, wildcards, type variables, or generic types containing any combination of the above.

builderType

public abstract Type builderType()

Returns the builder type that will build instances of type().

mergeBuilder

public abstract BuildableType.MergeBuilderMethod mergeBuilder()

partialToBuilder

public abstract BuildableType.PartialToBuilderMethod partialToBuilder()

builderFactory

public abstract BuilderFactory builderFactory()

suppressUnchecked

public abstract Excerpt suppressUnchecked()

newBuilder

public Excerpt newBuilder(BuilderFactory.TypeInference typeInference)

Returns an excerpt calling the Builder factory method.

maybeBuilder

public static Optional<DeclaredType> maybeBuilder(DeclaredType type,
 Elements elements,
 Types types)

methodIsObscured

private static boolean methodIsObscured(DeclaredType targetType,
 Elements elements,
 Types types,
 DeclaredType returnType,
 String methodName,
 DeclaredType... parameterTypes)

create

public static BuildableType create(DeclaredType datatype,
 DeclaredType builder,
 Elements elements,
 Types types)

detectMergeFromBuilderMethod

private static BuildableType.MergeBuilderMethod detectMergeFromBuilderMethod(DeclaredType builder,
 Elements elements,
 Types types,
 TypeElement datatypeElement)

detectPartialToBuilderMethod

private static BuildableType.PartialToBuilderMethod detectPartialToBuilderMethod(DeclaredType datatype,
 DeclaredType builder,
 Elements elements,
 Types types)

suppressUncheckedExcerptFor

private static Excerpt suppressUncheckedExcerptFor(DeclaredType datatype)

isCallableMethod

private static boolean isCallableMethod(ExecutableElement element)

isBuilderType

private static boolean isBuilderType(TypeElement element)

isClearMethod

private static boolean isClearMethod(ExecutableElement element)