This is an automated email from the ASF dual-hosted git repository. hboutemy pushed a commit to branch menu in repository https://gitbox.apache.org/repos/asf/maven-surefire.git
commit c5d9e0839fc33f980b93684eadffe893114dd72b Author: Hervé Boutemy <[email protected]> AuthorDate: Mon Mar 2 22:11:45 2026 +0100 extract forking menu from examples --- .../src/site/apt/examples/process-communication.apt.vm | 10 ++++++---- maven-surefire-plugin/src/site/site.xml | 10 ++++++---- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/maven-surefire-plugin/src/site/apt/examples/process-communication.apt.vm b/maven-surefire-plugin/src/site/apt/examples/process-communication.apt.vm index eaba32c5b..1c21c58b5 100644 --- a/maven-surefire-plugin/src/site/apt/examples/process-communication.apt.vm +++ b/maven-surefire-plugin/src/site/apt/examples/process-communication.apt.vm @@ -36,13 +36,15 @@ Communication Channels used between the Maven Process and Surefire Process * forkNode - The configuration is done by using only one configuration parameter <<<forkNode>>>. + The configuration is done by using only one configuration {{{../test-mojo.html#forkNode}parameter <<<forkNode>>>}}. * The TCP/IP communication channel The ${thisPlugin} plugin uses process pipes by default. The implementation class for default configuration - is <<<org.apache.maven.plugin.surefire.extensions.LegacyForkNodeFactory>>> and it does not have to be specified. - The TCP/IP channel can be selected as follows and the implementation class has to be specified: + is {{{../../maven-surefire-common/apidocs/org/apache/maven/plugin/surefire/extensions/LegacyForkNodeFactory.html}<<<org.apache.maven.plugin.surefire.extensions.LegacyForkNodeFactory>>>}} + and it does not have to be specified. + The TCP/IP channel can be selected as follows and the implementation class has to be specified + {{{../../maven-surefire-common/apidocs/org/apache/maven/plugin/surefire/extensions/SurefireForkNodeFactory.html}as <<<SurefireForkNodeFactory>>>}}: +---+ <project> @@ -68,7 +70,7 @@ Communication Channels used between the Maven Process and Surefire Process * Custom implementation The custom implementation involves two implementations. The first is used by the Maven process and there you - should implement the interface <<<org.apache.maven.surefire.extensions.ForkNodeFactory>>>, use the implementation + should implement the {{{../../surefire-extensions-api/apidocs/org/apache/maven/surefire/extensions/ForkNodeFactory.html}interface <<<org.apache.maven.surefire.extensions.ForkNodeFactory>>>}}, use the implementation in a dependency <<<your-extension-api-impl-artifactid>>> declared below the plugin and configuration should specify fully qualified class name of your custom <<<ForkNodeFactory>>> in the attribute <<<implementation>>>. diff --git a/maven-surefire-plugin/src/site/site.xml b/maven-surefire-plugin/src/site/site.xml index 17b92a0d8..2a183378f 100644 --- a/maven-surefire-plugin/src/site/site.xml +++ b/maven-surefire-plugin/src/site/site.xml @@ -38,7 +38,6 @@ </menu> <menu name="Examples"> <item name="Java Modularity (JPMS) in Tests" href="examples/jpms.html"/> - <item name="TCP/IP Communication between Forks" href="examples/process-communication.html"/> <item name="Using TestNG" href="examples/testng.html"/> <item name="Using JUnit" href="examples/junit.html"/> <item name="Using JUnit 5 Platform" href="examples/junit-platform.html"/> @@ -51,19 +50,22 @@ <item name="Inclusions and Exclusions of Tests" href="examples/inclusion-exclusion.html"/> <item name="Running a Single Test" href="examples/single-test.html"/> <item name="Re-run Failing Tests" href="examples/rerun-failing-tests.html"/> - <item name="Class Loading and Forking" href="examples/class-loading.html"/> <item name="Debugging Tests" href="examples/debugging.html"/> <item name="Using System Properties" href="examples/system-properties.html"/> <item name="Configuring the Classpath" href="examples/configuring-classpath.html"/> <item name="Selecting Providers" href="examples/providers.html"/> <item name="New Error Summary" href="newerrorsummary.html"/> <item name="Multi-lined Exception Messages" href="multilineexceptions.html"/> - <item name="Fork Options and Parallel Test Execution" href="examples/fork-options-and-parallel-execution.html"/> <item name="Using Console Logs" href="examples/logging.html"/> - <item name="Shutdown of Forked JVM" href="examples/shutdown.html"/> <item name="Run tests with Java 9" href="java9.html"/> <item name="Run tests in Docker" href="docker.html"/> <item name="Run tests in a different JVM using toolchains" href="examples/toolchains.html"/> </menu> + <menu name="Forking"> + <item name="TCP/IP Communication between Forks" href="examples/process-communication.html"/> + <item name="Class Loading and Forking" href="examples/class-loading.html"/> + <item name="Fork Options and Parallel Test Execution" href="examples/fork-options-and-parallel-execution.html"/> + <item name="Shutdown of Forked JVM" href="examples/shutdown.html"/> + </menu> </body> </site>
