Package ru.vyarus.dropwizard.guice.test.jupiter.ext.stub

Class StubFieldsSupport

java.lang.Object

ru.vyarus.dropwizard.guice.test.jupiter.env.field.AnnotatedTestFieldSetup<StubBean,Object>

ru.vyarus.dropwizard.guice.test.jupiter.ext.stub.StubFieldsSupport

All Implemented Interfaces:

TestExecutionListener, TestEnvironmentSetup

public class StubFieldsSupport
extends AnnotatedTestFieldSetup<StubBean,Object>

StubBean test fields support implementation.

Annotated fields resolved in time of guicey extension initialization (beforeAll or beforeEach). Register override bindings for provided stubs (singletons!). Stub instances created by guice (to be able to use injections inside it). If stub field is initialized manually - this value would be bound into guice context (see debug report to be sure what value was actually used - field might be assigned too late).

In beforeAll injects static values, in beforeEach inject both (in case if beforeAll wasn't called).

For stub objects, implementing StubLifecycle before and after methods called on beforeEach and afterEach to perform cleanups.

Since:

07.02.2025

Field Summary

Fields inherited from class ru.vyarus.dropwizard.guice.test.jupiter.env.field.AnnotatedTestFieldSetup

appPerClass, FIELD_INJECTED, FIELD_MANUAL, fields, regTestClass, setupContext, setupContextName

Constructor Summary

Constructors

Constructor	Description
StubFieldsSupport()	Create support.

Method Summary

Modifier and Type	Method	Description
protected void	afterTest(EventContext context, AnnotatedField<StubBean,Object> field, Object value)	Called after each test to post-process field value (if required).
protected void	beforeTest(EventContext context, AnnotatedField<StubBean,Object> field, Object value)	Called before each test to pre-process field value (if required).
protected void	beforeValueInjection(EventContext context, AnnotatedField<StubBean,Object> field)	Called after application startup and before field value injection.
protected void	fieldDetected(org.junit.jupiter.api.extension.ExtensionContext context, AnnotatedField<StubBean,Object> field)	Validate resolved field, if required.
protected <K> void	initializeField(AnnotatedField<StubBean,Object> field, Object userValue)	Configure application for a field (user value might be provided).
protected Object	injectFieldValue(EventContext context, AnnotatedField<StubBean,Object> field)	Get test field value (would be immediately injected into the test field).
protected void	registerHooks(TestExtension extension)	Called to register additional guicey hooks, if required.
protected void	report(EventContext context, List<AnnotatedField<StubBean,Object>> fields)	Called when debug is enabled on guicey extension to report registered fields.

Methods inherited from class ru.vyarus.dropwizard.guice.test.jupiter.env.field.AnnotatedTestFieldSetup

afterEach, beforeAll, beforeEach, failIfInstanceFieldInitialized, getClassContext, getDeclarationErrorPrefix, getOwnFields, getParentFields, getStore, injectValues, isInstanceBinding, lookupFields, setup, started, starting, stopped, validateUnreachableFieldsInNestedTest, valueLifecycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface ru.vyarus.dropwizard.guice.test.jupiter.env.listen.TestExecutionListener

afterAll, stopping

Constructor Details

StubFieldsSupport

public StubFieldsSupport()

Create support.

Method Details

fieldDetected

protected void fieldDetected(org.junit.jupiter.api.extension.ExtensionContext context,
 AnnotatedField<StubBean,Object> field)

Description copied from class: AnnotatedTestFieldSetup

Validate resolved field, if required. Note that some validations are performed automatically like checking field type with provided required type or unreachable annotated fields reporting. This method should be used for validations, which are not possible to perform automatically (e.g., there is a class, declared in annotation that must comply with a field type (base class know nothing about annotation and can't check that).

Called only for current test class own fields: in case of nested test, root test fields would already be validated. Also, if guice context started per each test method, validation would be called only for the first test method because fields would be searched just once - no need to validate each time.

Specified by:

fieldDetected in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - junit context

field - annotated fields

registerHooks

protected void registerHooks(TestExtension extension)

Description copied from class: AnnotatedTestFieldSetup

Called to register additional guicey hooks, if required. Called only when at least one annotated field is detected.

Specified by:

registerHooks in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

extension - extension configuration object

initializeField

protected <K> void initializeField(AnnotatedField<StubBean,Object> field,
 Object userValue)

Description copied from class: AnnotatedTestFieldSetup

Configure application for a field (user value might be provided). There might be field object instance creation (e.g. mocks initialization), guice overrides registration, etc. The main initialization point.

NOTE: If user-provided values are not allowed, throw an exception here

Specified by:

initializeField in class AnnotatedTestFieldSetup<StubBean,Object>

Type Parameters:

K - type for aligning a binding key with value types (cheating on guice type checks)

Parameters:

field - annotated field

userValue - user-provided field value (pre-initialized)

beforeValueInjection

protected void beforeValueInjection(EventContext context,
 AnnotatedField<StubBean,Object> field)

Description copied from class: AnnotatedTestFieldSetup

Called after application startup and before field value injection. Useful for additional validations, which can't be performed before, like binding correctness validation (requiring the created injector): for example, to detect instance bindings when extension relies on AOP and so would not work. Such validation is impossible to do before (in time of binding overrides).

Called before AnnotatedTestFieldSetup.injectFieldValue(ru.vyarus.dropwizard.guice.test.jupiter.env.listen.EventContext, AnnotatedField). At this point, non-static fields could be resolved (test instance present).

Important: method called for all fields, even initialized by user! Inject value method might not be called after it!

Specified by:

beforeValueInjection in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - event context

field - annotated field

injectFieldValue

protected Object injectFieldValue(EventContext context,
 AnnotatedField<StubBean,Object> field)

Description copied from class: AnnotatedTestFieldSetup

Get test field value (would be immediately injected into the test field). Called only if field was not initialized by user (not a manual value). For example, implementation might simply get bean instance from guice context (if guice was re-configured with module overrides).

Warning: not called for manually initialized fields (because value already set)! To validate binding use AnnotatedTestFieldSetup.beforeValueInjection(ru.vyarus.dropwizard.guice.test.jupiter.env.listen.EventContext, AnnotatedField) method instead (which is called for all fields).

Application already completely started and test extension initialized at this moment (beforeEach test phase).

Specified by:

injectFieldValue in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - event context

field - annotated field

Returns:

created field value

report

protected void report(EventContext context,
 List<AnnotatedField<StubBean,Object>> fields)

Description copied from class: AnnotatedTestFieldSetup

Called when debug is enabled on guicey extension to report registered fields. Note: there might be fields from multiple test classes in case of nested tests.

Report called after application startup because at this point all fields were processed (in configure guice method) and so all required fields data collected. Called only if at least one field is detected.

Special custom data markers used in field objects (AnnotatedField.getCustomData(String)):

• AnnotatedTestFieldSetup.FIELD_MANUAL field value was initialized by user, otherwise automatic
• AnnotatedTestFieldSetup.FIELD_INJECTED field injection instance (test instance)

Specified by:

report in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - event context, IMPORTANT - this would be setup context and not current

fields - fields to report

beforeTest

protected void beforeTest(EventContext context,
 AnnotatedField<StubBean,Object> field,
 Object value)

Description copied from class: AnnotatedTestFieldSetup

Called before each test to pre-process field value (if required).

Specified by:

beforeTest in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - event context

field - filed descriptor

value - value instance

afterTest

protected void afterTest(EventContext context,
 AnnotatedField<StubBean,Object> field,
 Object value)

Description copied from class: AnnotatedTestFieldSetup

Called after each test to post-process field value (if required).

Specified by:

afterTest in class AnnotatedTestFieldSetup<StubBean,Object>

Parameters:

context - event context

field - filed descriptor

value - value instance