Module org.tquadrat.foundation.javacomposer

Package org.tquadrat.foundation.javacomposer

Interface LambdaSpec

All Known Implementing Classes:

LambdaSpecImpl

@ClassVersion(sourceVersion="$Id: LambdaSpec.java 1085 2024-01-05 16:23:28Z tquadrat $")
@API(status=STABLE,
     since="0.0.5")
public sealed interface LambdaSpec
permits LambdaSpecImpl

The specification for a generated lambda construct.

Parameters and Types

When adding more than one parameter, all of them must have a specified type or none of them may have one, leaving the compiler to infer the type. As paramterBuilder() does require a type, we take Primitives.VOID instead of a concrete type if we want to get the type being inferred.

Formatting

Basically, a lambda expression has two different formats, one without curly braces

  a -> modify( a )

and the other with with curly braces, requiring a return statement:

  a ->
  {
      modify( a );
      return a.result;
  }

The body of the second form usually has more than one statement.

JavaComposer emits the first form when only one of the methods

• LambdaSpec.Builder.addCode(String, Object...)
• LambdaSpec.Builder.addCode(CodeBlock)

is called only once on the builder instance. The second form is forced, when one of the methods above is called again, or when one of the methods

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

is called.

There is no validation on the code; this means it is in the caller's responsibility to ensure that there is a return statement in the second case.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: LambdaSpec.java 1085 2024-01-05 16:23:28Z tquadrat $

Since:

0.0.5

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.javacomposer.LambdaSpec"

⁠

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	LambdaSpec.Builder	The builder for an instance of LambdaSpec

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
int	hashCode()
LambdaSpec.Builder	toBuilder()	Creates a new builder that is initialised with the components of this lambda.
String	toString()

Method Details

equals

boolean equals(Object o)

Overrides:

equals in class Object

hashCode

int hashCode()

Overrides:

hashCode in class Object

toBuilder

LambdaSpec.Builder toBuilder()

Creates a new builder that is initialised with the components of this lambda.

Returns:

The new builder.

toString

String toString()

Overrides:

toString in class Object