Package io.quarkus.test.component

Annotation Interface QuarkusComponentTest

@Experimental("This feature is experimental and the API may change in the future")
@ExtendWith(QuarkusComponentTestExtension.class)
@Retention(RUNTIME)
@Target(TYPE)
public @interface QuarkusComponentTest

Registers the QuarkusComponentTestExtension that makes it easy to test Quarkus components.

See Also:

• InjectMock
• TestConfigProperty

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
boolean	addNestedClassesAsComponents	If set to true then all static nested classes are considered additional components under test.
Class<? extends AnnotationsTransformer>[]	annotationsTransformers	The additional annotation transformers.
int	configSourceOrdinal	The ordinal of the config source used for all test config properties.
boolean	useDefaultConfigProperties	Indicates that the default values should be used for missing config properties.
Class<?>[]	value	The set of additional components under test.

Element Details

value

Class<?>[] value

The set of additional components under test.

The initial set of components is derived from the test class. The types of all fields annotated with Inject are considered the component types. Furthermore, all types of parameters of test methods that are not annotated with InjectMock or SkipInject are also considered the component types.

Returns:

the components under test

Default:

{}

useDefaultConfigProperties

boolean useDefaultConfigProperties

Indicates that the default values should be used for missing config properties.

If not used then a missing config property results in a test failure.

For primitives the default values as defined in the JLS are used. For any other type null is injected.

See Also:

• QuarkusComponentTestExtensionBuilder.useDefaultConfigProperties()

Default:

false

addNestedClassesAsComponents

boolean addNestedClassesAsComponents

If set to true then all static nested classes are considered additional components under test.

See Also:

• value()

Default:

true

configSourceOrdinal

int configSourceOrdinal

The ordinal of the config source used for all test config properties.

See Also:

• QuarkusComponentTestExtensionBuilder.setConfigSourceOrdinal(int)

Default:

500

annotationsTransformers

Class<? extends AnnotationsTransformer>[] annotationsTransformers

The additional annotation transformers.

The initial set includes the JaxrsSingletonTransformer.

See Also:

• AnnotationsTransformer
• QuarkusComponentTestExtensionBuilder.addAnnotationsTransformer(AnnotationsTransformer)

Default:

{}