Class VectorApiTenthIncubatorExamples

java.lang.Object

net.jrodolfo.java_evolution.java25.vector_api.VectorApiTenthIncubatorExamples

public class VectorApiTenthIncubatorExamples
extends Object

Demonstrates the Java 25 Vector API, continued as a tenth incubator by JEP 508.

The repository itself does not compile against incubator modules. Instead, this example writes a small Java source file, compiles it with javac --add-modules jdk.incubator.vector --release 25, and runs it with java --add-modules jdk.incubator.vector. That keeps the main Maven build stable while still demonstrating the real incubator API.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	VectorApiTenthIncubatorExamples.CommandResult	Result from one child process invocation.
static final record	VectorApiTenthIncubatorExamples.VectorWorkflowResult	Result from compiling and running the generated incubator-module source.

Constructor Summary

Constructors

Constructor	Description
VectorApiTenthIncubatorExamples()

Method Summary

Modifier and Type	Method	Description
String	incubatorBoundary()	Explains why this example uses a child process.
String	java25Idea()	Explains the Java 25 feature idea.
String	probeSource()	Source used by the child JVM to exercise the Java 25 incubator API.
String	problem()	Explains the problem that the Vector API addresses.
VectorApiTenthIncubatorExamples.VectorWorkflowResult	runVectorWorkflow(Path workspace)	Runs a real Java 25 Vector API workflow in a temporary workspace.
String	terminology()	Defines SIMD in plain English.
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

VectorApiTenthIncubatorExamples

public VectorApiTenthIncubatorExamples()

Method Details

runVectorWorkflow

public VectorApiTenthIncubatorExamples.VectorWorkflowResult runVectorWorkflow(Path workspace)
                                                                       throws IOException,
InterruptedException

Runs a real Java 25 Vector API workflow in a temporary workspace.

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 incubator API.

Returns:

generated Java source

problem

public String problem()

Explains the problem that the Vector API addresses.

Returns:

a short problem statement

java25Idea

public String java25Idea()

Explains the Java 25 feature idea.

Returns:

a short feature explanation

terminology

public String terminology()

Defines SIMD in plain English.

Returns:

a short terminology explanation

incubatorBoundary

public String incubatorBoundary()

Explains why this example uses a child process.

Returns:

the incubator-module boundary

testBoundary

public String testBoundary()

Explains what this executable example can and cannot prove.

Returns:

the test boundary