Class SourceBuilder

java.lang.Object

org.inferred.freebuilder.processor.source.SourceBuilder

public class SourceBuilder
extends Object

Source code builder, using format strings for readability, with sensible formatting for type objects.

// Imports StringBuilder and appends "  StringBuilder foo;\n" to the source code.
builder.addLine("  %s foo;", StringBuilder.class);

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	LINE_SEPARATOR
private final CompilationUnitBuilder	source

Constructor Summary

Constructors

Modifier	Constructor	Description
private	SourceBuilder(ScopeHandler.Reflection reflect, FeatureSet features)

Method Summary

Modifier and Type	Method	Description
private void	add(Object arg)
SourceBuilder	add(String fmt, Object... args)	Appends formatted text to the source.
SourceBuilder	add(Excerpt excerpt)	Equivalent to add("%s", excerpt).
SourceBuilder	addLine(String fmt, Object... args)	Appends a formatted line of code to the source.
<T extends Feature<T>> T	feature(FeatureType<T> featureType)	Returns the instance of featureType appropriate for the source being written.
static SourceBuilder	forEnvironment(ProcessingEnvironment env, FeatureSet features)	Returns a SourceBuilder.
static SourceBuilder	forTesting(Feature<?>... features)	Returns a SourceBuilder using features.
static SourceBuilder	forTesting(FeatureSet features)	Returns a SourceBuilder using features.
Scope	scope()	Returns the current scope (e.g.
String	toString()
QualifiedName	typename()	Return the qualified name of the main type declared by this unit.

Methods inherited from class Object

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

Field Details

LINE_SEPARATOR

private static final String LINE_SEPARATOR

source

private final CompilationUnitBuilder source

Constructor Details

SourceBuilder

private SourceBuilder(ScopeHandler.Reflection reflect,
 FeatureSet features)

Method Details

forEnvironment

public static SourceBuilder forEnvironment(ProcessingEnvironment env,
 FeatureSet features)

Returns a SourceBuilder. env will be inspected for potential import collisions. If features is not null, it will be used instead of those deduced from env.

forTesting

public static SourceBuilder forTesting(Feature<?>... features)

Returns a SourceBuilder using features. The system classloader will be inspected for potential import collisions.

forTesting

public static SourceBuilder forTesting(FeatureSet features)

Returns a SourceBuilder using features. The system classloader will be inspected for potential import collisions.

add

public SourceBuilder add(String fmt,
 Object... args)

Appends formatted text to the source.

Formatting supports %s and %n$s. Most args are converted according to their Object.toString() method, except that:

• Package and PackageElement instances use their fully-qualified names (no "package " prefix).
• Class, TypeElement, DeclaredType and QualifiedName instances use their qualified names where necessary, or shorter versions if a suitable import line can be added.
• Excerpt instances have Excerpt.addTo(SourceBuilder) called.

add

public SourceBuilder add(Excerpt excerpt)

Equivalent to add("%s", excerpt).

addLine

public SourceBuilder addLine(String fmt,
 Object... args)

Appends a formatted line of code to the source.

Formatting supports %s and %n$s. Most args are converted according to their Object.toString() method, except that:

• Package and PackageElement instances use their fully-qualified names (no "package " prefix).
• Class, TypeElement, DeclaredType and QualifiedName instances use their qualified names where necessary, or shorter versions if a suitable import line can be added.
• Excerpt instances have Excerpt.addTo(SourceBuilder) called.

feature

public <T extends Feature<T>> T feature(FeatureType<T> featureType)

Returns the instance of featureType appropriate for the source being written. For instance, code.feature(GUAVA).isAvailable() returns true if the Guava library can be used in the generated source code.

Fluent extension point for features dynamically determined based on the current ProcessingEnvironment.

See Also:

• Feature

scope

public Scope scope()

Returns the current scope (e.g. visible method parameters).

typename

public QualifiedName typename()

Return the qualified name of the main type declared by this unit.

Throws:

IllegalStateException - if no package or type has been declared

toString

public String toString()

Overrides:

toString in class Object

add

private void add(Object arg)