Package org.junit.jupiter.engine.extension

Class TempDirectory

java.lang.Object

org.junit.jupiter.engine.extension.TempDirectory

All Implemented Interfaces:

BeforeAllCallback, BeforeEachCallback, Extension, ParameterResolver

class TempDirectory
extends Object
implements BeforeAllCallback, BeforeEachCallback, ParameterResolver

TempDirectory is a JUnit Jupiter extension that creates and cleans up temporary directories if field in a test class or a parameter in a lifecycle method or test method is annotated with @TempDir.

Consult the Javadoc for TempDir for details on the contract.

Since:

5.4

See Also:

• TempDir
• Files.createTempDirectory(java.nio.file.Path, java.lang.String, java.nio.file.attribute.FileAttribute<?>...)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	TempDirectory.CloseablePath
(package private) static interface	TempDirectory.FileOperations
(package private) static enum	TempDirectory.Scope

Field Summary

Fields

Modifier and Type	Field	Description
private final JupiterConfiguration	configuration
(package private) static final String	FILE_OPERATIONS_KEY
private static final String	KEY
(package private) static final ExtensionContext.Namespace	NAMESPACE
private static final String	TEMP_DIR_PREFIX

Constructor Summary

Constructors

Constructor	Description
TempDirectory(JupiterConfiguration configuration)

Method Summary

Modifier and Type	Method	Description
private void	assertNonFinalField(Field field)
private void	assertSupportedType(String target, Class<?> type)
void	beforeAll(ExtensionContext context)	Perform field injection for non-private, static fields (i.e., class fields) of type Path or File that are annotated with @TempDir.
void	beforeEach(ExtensionContext context)	Perform field injection for non-private, non-static fields (i.e., instance fields) of type Path or File that are annotated with @TempDir.
(package private) static TempDirectory.CloseablePath	createTempDir(CleanupMode cleanupMode, ExtensionContext executionContext)
private CleanupMode	determineCleanupMode(TempDir tempDir)
private CleanupMode	determineCleanupModeForField(Field field)
private CleanupMode	determineCleanupModeForParameter(ParameterContext parameterContext)
private Object	getPathOrFile(AnnotatedElement sourceElement, Class<?> type, CleanupMode cleanupMode, ExtensionContext extensionContext)
private TempDirectory.Scope	getScope(ExtensionContext context)
private void	injectFields(ExtensionContext context, Object testInstance, Class<?> testClass, Predicate<Field> predicate)
private void	injectInstanceFields(ExtensionContext context, Object instance)
private void	injectStaticFields(ExtensionContext context, Class<?> testClass)
Object	resolveParameter(ParameterContext parameterContext, ExtensionContext extensionContext)	Resolve the current temporary directory for the Parameter in the supplied ParameterContext.
boolean	supportsParameter(ParameterContext parameterContext, ExtensionContext extensionContext)	Determine if the Parameter in the supplied ParameterContext is annotated with @TempDir.

Methods inherited from class java.lang.Object

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

Field Details

NAMESPACE

static final ExtensionContext.Namespace NAMESPACE

KEY

private static final String KEY

See Also:

• Constant Field Values

TEMP_DIR_PREFIX

private static final String TEMP_DIR_PREFIX

See Also:

• Constant Field Values

FILE_OPERATIONS_KEY

static final String FILE_OPERATIONS_KEY

See Also:

• Constant Field Values

configuration

private final JupiterConfiguration configuration

Constructor Details

TempDirectory

public TempDirectory(JupiterConfiguration configuration)

Method Details

beforeAll

public void beforeAll(ExtensionContext context)

Perform field injection for non-private, static fields (i.e., class fields) of type Path or File that are annotated with @TempDir.

Specified by:

beforeAll in interface BeforeAllCallback

Parameters:

context - the current extension context; never null

beforeEach

public void beforeEach(ExtensionContext context)

Perform field injection for non-private, non-static fields (i.e., instance fields) of type Path or File that are annotated with @TempDir.

Specified by:

beforeEach in interface BeforeEachCallback

Parameters:

context - the current extension context; never null

injectStaticFields

private void injectStaticFields(ExtensionContext context,
 Class<?> testClass)

injectInstanceFields

private void injectInstanceFields(ExtensionContext context,
 Object instance)

injectFields

private void injectFields(ExtensionContext context,
 Object testInstance,
 Class<?> testClass,
 Predicate<Field> predicate)

supportsParameter

public boolean supportsParameter(ParameterContext parameterContext,
 ExtensionContext extensionContext)

Determine if the Parameter in the supplied ParameterContext is annotated with @TempDir.

Specified by:

supportsParameter in interface ParameterResolver

Parameters:

parameterContext - the context for the parameter for which an argument should be resolved; never null

extensionContext - the extension context for the Executable about to be invoked; never null

Returns:

true if this resolver can resolve an argument for the parameter

See Also:

• ParameterResolver.resolveParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext)
• ParameterContext

resolveParameter

public Object resolveParameter(ParameterContext parameterContext,
 ExtensionContext extensionContext)

Resolve the current temporary directory for the Parameter in the supplied ParameterContext.

Specified by:

resolveParameter in interface ParameterResolver

Parameters:

parameterContext - the context for the parameter for which an argument should be resolved; never null

extensionContext - the extension context for the Executable about to be invoked; never null

Returns:

the resolved argument for the parameter; may only be null if the parameter type is not a primitive

See Also:

• ParameterResolver.supportsParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext)
• ParameterContext

determineCleanupModeForField

private CleanupMode determineCleanupModeForField(Field field)

determineCleanupModeForParameter

private CleanupMode determineCleanupModeForParameter(ParameterContext parameterContext)

determineCleanupMode

private CleanupMode determineCleanupMode(TempDir tempDir)

assertNonFinalField

private void assertNonFinalField(Field field)

assertSupportedType

private void assertSupportedType(String target,
 Class<?> type)

getPathOrFile

private Object getPathOrFile(AnnotatedElement sourceElement,
 Class<?> type,
 CleanupMode cleanupMode,
 ExtensionContext extensionContext)

getScope

private TempDirectory.Scope getScope(ExtensionContext context)

createTempDir

static TempDirectory.CloseablePath createTempDir(CleanupMode cleanupMode,
 ExtensionContext executionContext)