Package rife.bld.extension.testing

Class RandomStringResolver

java.lang.Object

rife.bld.extension.testing.RandomStringResolver

All Implemented Interfaces:

Extension, ParameterResolver, TestInstancePostProcessor, TestInstantiationAwareExtension

public class RandomStringResolver
extends Object
implements ParameterResolver, TestInstancePostProcessor

Parameter and field resolver for the RandomString annotation.

This resolver automatically injects random string values into test method parameters that are annotated with @RandomString or are part of test methods annotated with @RandomString at the method level.

Supported Types:

• String - single random string (when size = 0)
• List<String> - list of random strings (when size > 0)
• Set<String> - set of unique random strings (when size > 0)

Resolution Priority:

Parameter-level annotation takes precedence over method-level.

Security:

Uses SecureRandom for cryptographically strong random number generation.

Default Configuration:

• Length: 10 characters
• Character Set: Alphanumeric (A-Z, a-z, 0-9)
• Size: 0 (single string)

Since:

1.0

Author:

Erik C. Thauvin

See Also:

• ParameterResolver
• RandomString
• TestInstancePostProcessor

Nested Class Summary

Nested classes/interfaces inherited from interface org.junit.jupiter.api.extension.TestInstantiationAwareExtension

TestInstantiationAwareExtension.ExtensionContextScope

Constructor Summary

Constructors

Constructor	Description
RandomStringResolver()

Method Summary

Modifier and Type	Method	Description
void	postProcessTestInstance(Object testInstance, ExtensionContext context)	Processes fields of the test instance annotated with RandomString.
Object	resolveParameter(ParameterContext parameterContext, ExtensionContext extensionContext)	Resolves the parameter by generating a random string, list, or set based on annotation configuration.
boolean	supportsParameter(ParameterContext parameterContext, ExtensionContext extensionContext)	Determines if this resolver can resolve a parameter.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.junit.jupiter.api.extension.TestInstantiationAwareExtension

getTestInstantiationExtensionContextScope

Constructor Details

RandomStringResolver

public RandomStringResolver()

Method Details

postProcessTestInstance

public void postProcessTestInstance(Object testInstance,
 ExtensionContext context)
                             throws Exception

Processes fields of the test instance annotated with RandomString.

Enables field injection for random strings. Field must be of type String, List<String>, or Set<String>. Fields of unsupported types annotated with @RandomString will cause an IllegalArgumentException to be thrown.

Specified by:

postProcessTestInstance in interface TestInstancePostProcessor

Parameters:

testInstance - the test class instance

context - the current extension context

Throws:

IllegalArgumentException - if a @RandomString-annotated field has an unsupported type

Exception

supportsParameter

public boolean supportsParameter(ParameterContext parameterContext,
 ExtensionContext extensionContext)

Determines if this resolver can resolve a parameter.

Specified by:

supportsParameter in interface ParameterResolver

Parameters:

parameterContext - information about the parameter to be resolved

extensionContext - the current extension context

Returns:

true if the parameter can be resolved by this extension, false otherwise

resolveParameter

public Object resolveParameter(ParameterContext parameterContext,
 ExtensionContext extensionContext)

Resolves the parameter by generating a random string, list, or set based on annotation configuration.

Priority: Parameter-level > Method-level > Default (10, alphanumeric, size 0).

Note: The type has already been validated by supportsParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext), so the final branch in generateValue(java.lang.Class<?>, int, int, java.lang.String) is a defensive guard that should not be reachable in normal usage.

Specified by:

resolveParameter in interface ParameterResolver

Parameters:

parameterContext - information about the parameter to be resolved

extensionContext - the current extension context

Returns:

a randomly generated string, list, or set matching the annotation specifications

Throws:

IllegalArgumentException - if the annotation specifies invalid parameters