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

Class SpyFieldsSupport

java.lang.Object

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

ru.vyarus.dropwizard.guice.test.jupiter.ext.spy.SpyFieldsSupport

All Implemented Interfaces:

TestExecutionListener, TestEnvironmentSetup

public class SpyFieldsSupport
extends AnnotatedTestFieldSetup<SpyBean,Object>

SpyBean test fields support implementation.

Annotated fields resolved in time of guicey extension initialization (beforeAll or beforeEach). Register aop interceptor around target service to intercept all calls, and redirect all calls through spy object. This way, real bean becomes spied and still injected everywhere.

Manual values are not supported: @MockBean should be used instead.

In beforeAll injects static values, in beforeEach inject both (in case if beforeAll wasn't called). Calls spies reset after each test.

Since:

10.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
SpyFieldsSupport()	Create support.

Method Summary

Modifier and Type	Method	Description
protected void	afterTest(EventContext context, AnnotatedField<SpyBean,Object> field, Object value)	Called after each test to post-process field value (if required).
protected void	beforeTest(EventContext context, AnnotatedField<SpyBean,Object> field, Object value)	Called before each test to pre-process field value (if required).
protected void	beforeValueInjection(EventContext context, AnnotatedField<SpyBean,Object> field)	Called after application startup and before field value injection.
protected void	fieldDetected(org.junit.jupiter.api.extension.ExtensionContext context, AnnotatedField<SpyBean,Object> field)	Validate resolved field, if required.
protected <K> void	initializeField(AnnotatedField<SpyBean,Object> field, Object userValue)	Configure application for a field (user value might be provided).
protected Object	injectFieldValue(EventContext context, AnnotatedField<SpyBean,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<SpyBean,Object>> annotatedFields)	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

SpyFieldsSupport

public SpyFieldsSupport()

Create support.

Method Details

fieldDetected

protected void fieldDetected(org.junit.jupiter.api.extension.ExtensionContext context,
 AnnotatedField<SpyBean,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<SpyBean,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<SpyBean,Object>

Parameters:

extension - extension configuration object

initializeField

protected <K> void initializeField(AnnotatedField<SpyBean,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<SpyBean,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<SpyBean,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<SpyBean,Object>

Parameters:

context - event context

field - annotated field

injectFieldValue

protected Object injectFieldValue(EventContext context,
 AnnotatedField<SpyBean,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<SpyBean,Object>

Parameters:

context - event context

field - annotated field

Returns:

created field value

report

protected void report(EventContext context,
 List<AnnotatedField<SpyBean,Object>> annotatedFields)

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<SpyBean,Object>

Parameters:

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

annotatedFields - fields to report

beforeTest

protected void beforeTest(EventContext context,
 AnnotatedField<SpyBean,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<SpyBean,Object>

Parameters:

context - event context

field - filed descriptor

value - value instance

afterTest

protected void afterTest(EventContext context,
 AnnotatedField<SpyBean,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<SpyBean,Object>

Parameters:

context - event context

field - filed descriptor

value - value instance