Class StableValuesPreviewExamples

java.lang.Object

net.jrodolfo.java_evolution.java25.stable_values.StableValuesPreviewExamples

public class StableValuesPreviewExamples
extends Object

Demonstrates Java 25 Stable Values, previewed by JEP 502.

The repository itself does not compile against preview APIs. Instead, this example writes a small Java 25 source file, compiles it with javac --enable-preview --release 25, and runs it with java --enable-preview when the active toolchain is JDK 25. That keeps the main Maven build stable while still demonstrating the real preview API.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	StableValuesPreviewExamples.CommandResult	Result from one child process invocation.
static final record	StableValuesPreviewExamples.StableValuesWorkflowResult	Result from compiling and running the generated preview source.

Constructor Summary

Constructors

Constructor	Description
StableValuesPreviewExamples()

Method Summary

Modifier and Type	Method	Description
String	java25Idea()	Explains the Java 25 feature goal.
String	previewBoundary()	Explains why this example uses a child process.
String	probeSource()	Source used by the child JVM to exercise the Java 25 preview API.
String	problem()	Explains the problem that Stable Values address.
StableValuesPreviewExamples.StableValuesWorkflowResult	runStableValuesWorkflow(Path workspace)	Runs a real Java 25 preview Stable Values workflow in a temporary workspace.
String	testBoundary()	Explains what this executable example can and cannot prove.

Methods inherited from class Object

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

Constructor Details

StableValuesPreviewExamples

public StableValuesPreviewExamples()

Method Details

runStableValuesWorkflow

public StableValuesPreviewExamples.StableValuesWorkflowResult runStableValuesWorkflow(Path workspace)
                                                                               throws IOException,
InterruptedException

Runs a real Java 25 preview Stable Values workflow in a temporary workspace. Full child-compilation execution requires a JDK 25 preview compiler.

Parameters:

workspace - temporary directory for generated source and class files

Returns:

result containing compilation and execution output

Throws:

IOException - when the source file cannot be written

InterruptedException - when waiting for a child process is interrupted

probeSource

public String probeSource()

Source used by the child JVM to exercise the Java 25 preview API.

Returns:

generated Java source

problem

public String problem()

Explains the problem that Stable Values address.

Returns:

a short problem statement

java25Idea

public String java25Idea()

Explains the Java 25 feature goal.

Returns:

a short feature explanation

previewBoundary

public String previewBoundary()

Explains why this example uses a child process.

Returns:

the preview boundary

testBoundary

public String testBoundary()

Explains what this executable example can and cannot prove.

Returns:

the test boundary