Module org.junit.platform.launcher

Package org.junit.platform.launcher

Interface LauncherSession

All Superinterfaces:

AutoCloseable

@API(status=STABLE,
     since="1.10")
public interface LauncherSession
extends AutoCloseable

The LauncherSession API is the main entry point for client code that wishes to repeatedly discover and execute tests using one or more test engines.

Since:

1.8

See Also:

• Launcher
• LauncherSessionListener
• LauncherFactory

Method Summary

Modifier and Type	Method	Description
void	close()	Close this session and notify all registered LauncherSessionListeners.
Launcher	getLauncher()	Get the Launcher associated with this session.
NamespacedHierarchicalStore<Namespace>	getStore()	Get the NamespacedHierarchicalStore associated with this session.

Method Details

getLauncher

Launcher getLauncher()

Get the Launcher associated with this session.

Any call to the launcher returned by this method after the session has been closed will throw an exception.

close

void close()

Close this session and notify all registered LauncherSessionListeners.

Specified by:

close in interface AutoCloseable

API Note:

The behavior of calling this method concurrently with any call to the Launcher returned by getLauncher() is currently undefined.

getStore

@API(status=EXPERIMENTAL,
     since="1.13")
NamespacedHierarchicalStore<Namespace> getStore()

Get the NamespacedHierarchicalStore associated with this session.

All stored values that implement AutoCloseable are notified by invoking their close() methods when this session is closed.

Any call to the store returned by this method after the session has been closed will throw an exception.

Since:

1.13

See Also:

• NamespacedHierarchicalStore