Module org.tquadrat.foundation.javacomposer

Package org.tquadrat.foundation.javacomposer.internal

Class LambdaSpecImpl.BuilderImpl

java.lang.Object

org.tquadrat.foundation.javacomposer.internal.LambdaSpecImpl.BuilderImpl

All Implemented Interfaces:

LambdaSpec.Builder

Enclosing class:

LambdaSpecImpl

@ClassVersion(sourceVersion="$Id: LambdaSpecImpl.java 1105 2024-02-28 12:58:46Z tquadrat $")
@API(status=INTERNAL,
     since="0.0.5")
public static final class LambdaSpecImpl.BuilderImpl
extends Object
implements LambdaSpec.Builder

The implementation for LambdaSpec.Builder.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: LambdaSpecImpl.java 1105 2024-02-28 12:58:46Z tquadrat $

Since:

0.0.5

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.javacomposer.internal.LambdaSpecImpl.BuilderImpl"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private final CodeBlockImpl.BuilderImpl	m_Code	The code for the lambda body.
private final JavaComposer	m_Composer	The reference to the factory.
private Boolean	m_InferTypes	Flag that indicates whether the parameter types will be inferred.
private int	m_Lines	The flag is used to determine the emit format.
private final Collection<ParameterSpecImpl>	m_Parameters	The parameters for the lambda.

Constructor Summary

Constructors

Constructor	Description
BuilderImpl(JavaComposer composer)	Creates a new BuilderImpl instance.

Method Summary

Modifier and Type	Method	Description
final LambdaSpecImpl.BuilderImpl	addCode(String format, Object... args)	Adds code for the lambda body.
final LambdaSpecImpl.BuilderImpl	addCode(CodeBlock codeBlock)	Adds code for the lambda body.
final LambdaSpecImpl.BuilderImpl	addComment(String format, Object... args)	Adds a comment for the lambda body.
final LambdaSpecImpl.BuilderImpl	addParameter(Type type, String name)	Adds a parameter for the lambda.
final LambdaSpecImpl.BuilderImpl	addParameter(String name)	Adds a parameter for the lambda.
final LambdaSpecImpl.BuilderImpl	addParameter(ParameterSpec parameterSpec)	Adds a parameter for the lambda.
final LambdaSpecImpl.BuilderImpl	addParameter(TypeName type, String name)	Adds a parameter for the lambda.
final LambdaSpecImpl.BuilderImpl	addParameters(Iterable<? extends ParameterSpec> parameterSpecs)	Adds parameters for the lambda.
final LambdaSpecImpl.BuilderImpl	addStatement(String format, Object... args)	Adds a statement to the code for the lambda body.
final LambdaSpecImpl.BuilderImpl	beginControlFlow(String controlFlow, Object... args)	Adds the begin of a control flow for the lambda body.
final LambdaSpecImpl	build()	Creates a new LambdaSpec instance from the components that have been added to this builder.
final CodeBlockImpl	code()	Returns the code for the lambda body.
final LambdaSpecImpl.BuilderImpl	endControlFlow()	Ends the current control flow for the lambda body.
final LambdaSpecImpl.BuilderImpl	endControlFlow(String controlFlow, Object... args)	Ends the current control flow for the lambda body; this version is only used for do-while constructs.
final boolean	inferTypes()	Returns the flag that indicates whether the types of the parameters will be inferred.
final boolean	isMultiLine()	Return the flag that indicates the emit format.
final LambdaSpecImpl.BuilderImpl	nextControlFlow(String controlFlow, Object... args)	Begins another control flow for the lambda body.
final List<ParameterSpecImpl>	parameters()	Returns the parameters for the lambda.

Methods inherited from class java.lang.Object

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

Field Details

m_Code

private final CodeBlockImpl.BuilderImpl m_Code

The code for the lambda body.

m_Composer

private final JavaComposer m_Composer

The reference to the factory.

m_InferTypes

private Boolean m_InferTypes

Flag that indicates whether the parameter types will be inferred.

m_Lines

private int m_Lines

The flag is used to determine the emit format.

m_Parameters

private final Collection<ParameterSpecImpl> m_Parameters

The parameters for the lambda.

Constructor Details

BuilderImpl

public BuilderImpl(JavaComposer composer)

Creates a new BuilderImpl instance.

Parameters:

composer - The reference to the factory that created this builder instance.

Method Details

addCode

public final LambdaSpecImpl.BuilderImpl addCode(CodeBlock codeBlock)

Adds code for the lambda body.

If only this method is called only once to add code to the lambda body, the short, single line form for the lambda expression will be emitted. That this will result in valid code requires that the given code block has an appropriate contents.

Specified by:

addCode in interface LambdaSpec.Builder

Parameters:

codeBlock - The code.

Returns:

This Builder instance.

addCode

public final LambdaSpecImpl.BuilderImpl addCode(String format,
 Object... args)

Adds code for the lambda body.

If only this method is called only once to add code to the lambda body, the short, single line form for the lambda expression will be emitted.

Specified by:

addCode in interface LambdaSpec.Builder

Parameters:

format - The format.

args - The arguments.

Returns:

This Builder instance.

addComment

public final LambdaSpecImpl.BuilderImpl addComment(String format,
 Object... args)

Adds a comment for the lambda body.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

addComment in interface LambdaSpec.Builder

Parameters:

format - The format.

args - The arguments.

Returns:

This Builder instance.

addParameter

public final LambdaSpecImpl.BuilderImpl addParameter(String name)

Adds a parameter for the lambda.

The type of the parameter is inferred.

Specified by:

addParameter in interface LambdaSpec.Builder

Parameters:

name - The name of the parameter.

Returns:

This Builder instance.

addParameter

public final LambdaSpecImpl.BuilderImpl addParameter(ParameterSpec parameterSpec)

Adds a parameter for the lambda. Only type and name of the given parameter are considered, annotations or modifiers will be ignored.

Specified by:

addParameter in interface LambdaSpec.Builder

Parameters:

parameterSpec - The parameter.

Returns:

This Builder instance.

addParameter

public final LambdaSpecImpl.BuilderImpl addParameter(Type type,
 String name)

Adds a parameter for the lambda.

Specified by:

addParameter in interface LambdaSpec.Builder

Parameters:

type - The type of the parameter.

name - The name of the parameter.

Returns:

This Builder instance.

addParameter

public final LambdaSpecImpl.BuilderImpl addParameter(TypeName type,
 String name)

Adds a parameter for the lambda.

Specified by:

addParameter in interface LambdaSpec.Builder

Parameters:

type - The type of the parameter.

name - The name of the parameter.

Returns:

This Builder instance.

addParameters

public final LambdaSpecImpl.BuilderImpl addParameters(Iterable<? extends ParameterSpec> parameterSpecs)

Adds parameters for the lambda. Only type and name of the given parameters are considered, annotations or modifiers will be ignored.

Specified by:

addParameters in interface LambdaSpec.Builder

Parameters:

parameterSpecs - The parameters.

Returns:

This Builder instance.

addStatement

public final LambdaSpecImpl.BuilderImpl addStatement(String format,
 Object... args)

Adds a statement to the code for the lambda body.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

addStatement in interface LambdaSpec.Builder

Parameters:

format - The format.

args - The arguments.

Returns:

This Builder instance.

beginControlFlow

public final LambdaSpecImpl.BuilderImpl beginControlFlow(String controlFlow,
 Object... args)

Adds the begin of a control flow for the lambda body.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

beginControlFlow in interface LambdaSpec.Builder

Parameters:

controlFlow - The control flow construct and its code, such as "if (foo == 5)"; it should not contain braces or newline characters.

args - The arguments.

Returns:

This Builder instance.

See Also:

• LambdaSpec.Builder.endControlFlow()
• LambdaSpec.Builder.endControlFlow(String, Object...)
• LambdaSpec.Builder.nextControlFlow(String, Object...)

build

public final LambdaSpecImpl build()

Creates a new LambdaSpec instance from the components that have been added to this builder.

Specified by:

build in interface LambdaSpec.Builder

Returns:

The MethodSpec instance.

code

public final CodeBlockImpl code()

Returns the code for the lambda body.

Returns:

The body code.

endControlFlow

public final LambdaSpecImpl.BuilderImpl endControlFlow()

Ends the current control flow for the lambda body.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

endControlFlow in interface LambdaSpec.Builder

Returns:

This Builder instance.

See Also:

• LambdaSpec.Builder.beginControlFlow(String, Object...)
• LambdaSpec.Builder.endControlFlow(String, Object...)
• LambdaSpec.Builder.nextControlFlow(String, Object...)

endControlFlow

public final LambdaSpecImpl.BuilderImpl endControlFlow(String controlFlow,
 Object... args)

Ends the current control flow for the lambda body; this version is only used for do-while constructs.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

endControlFlow in interface LambdaSpec.Builder

Parameters:

controlFlow - The optional control flow construct and its code, such as "while(foo == 20)"; it should not contain braces or newline characters.

args - The arguments.

Returns:

This Builder instance.

See Also:

• LambdaSpec.Builder.beginControlFlow(String, Object...)
• LambdaSpec.Builder.endControlFlow()

inferTypes

public final boolean inferTypes()

Returns the flag that indicates whether the types of the parameters will be inferred.

Returns:

true if the parameter types are inferred, false if they are explicit.

isMultiLine

public final boolean isMultiLine()

Return the flag that indicates the emit format.

Returns:

true if the multi-line format with curly braces and a return statement is to be emitted, false if the single line format can be used.

nextControlFlow

public final LambdaSpecImpl.BuilderImpl nextControlFlow(String controlFlow,
 Object... args)

Begins another control flow for the lambda body.

A call to this method forces the multi-line emit format for the lambda expression.

Specified by:

nextControlFlow in interface LambdaSpec.Builder

Parameters:

controlFlow - The control flow construct and its code, such as "else if (foo == 10)"; it should not contain braces or newline characters.

args - The arguments.

Returns:

This Builder instance.

See Also:

• LambdaSpec.Builder.beginControlFlow(String, Object...)
• LambdaSpec.Builder.endControlFlow()

parameters

public final List<ParameterSpecImpl> parameters()

Returns the parameters for the lambda.

Returns:

The parameters.