Adds a configuration change listener. @param key the configuration key to listen for, or null for all keys @param listener the change listener

Adds a metric to the trace. @param key the metric key @param value the metric value

Adds a pointcut to the composite with the specified operation. @param pointcut the pointcut to add @param isAnd true for AND operation, false for

Adds multiple random objects with their corresponding probabilities to the utility class. @param objectProbabilityMap Map of objects and their probab

Invoked after processing a class. @param clazz the class that was processed @throws Exception the exception

Called after successful method execution @param context the aspect context @param result the execution result @param executionTime the a

Performs cleanup operations after test execution. <p>Subclasses can override this method to implement module-specific cleanup logic such as releasing

Continues the chain to add another task. <p>Since all previous tasks have already been executed immediately when {@link ExecutionBuilder#execute(Obje

Applies a validation rule to a configuration value. @param key the configuration key @param value the value to validate @param rule the validation

Invoked before processing a class. @param clazz the class to be processed @throws Exception the exception

Called before a method execution to prepare for potential timeout @param context the aspect context @param timeout the configured timeout @para

Performs setup operations before test execution. <p>Subclasses can override this method to implement module-specific setup logic such as initializing

Begins a nested distributed transaction. @param parentContext the parent transaction context @param annotation the distributed transaction annotat

Builds the final TaskChain with all configured and executed tasks. <p>All tasks will have been started immediately when their respective {@link Execu

Calculates and returns derived metrics. @return a new TestMetrics instance with calculated fields

Calculates the delay before the next retry. @param attemptNumber the attempt number (0-based) @return the delay in milliseconds

Calculates the wait time until the next available slot. @return the wait time in milliseconds

Checks rate limiting for the method invocation. @param secured the security annotation @param context the security context @throws SecurityException

Clears all exported spans.

Clears all registered participants.

Clears all timer data (both active and completed).

Clears all caches maintained by this aspect.

Clears all collected metrics.

Clears all test results.

Closes the MongoDB client connection, releasing any resources held by the client.

Phase 2: Commit all participants. @param context the transaction context @return a CompletableFuture that completes when all participants are committ

Executes the compensation logic. @param participant the participant to compensate @param context the transaction context @throws CompensationExce

Completes a trace with the specified status. @param context the trace context @param status the completion status

Completes a trace with an error. @param context the trace context @param error the error that occurred

Converts a Java {@link List} into an {@link Any} containing a custom {@code taskscheduler.ListValue}. <p>Each element in the list is recursively conve

Converts a Java {@link Map} with String keys into an {@link Any} containing a custom {@code taskscheduler.MapValue}. <p>Each value in the map is recur

Converts various result types to CompletableFuture for unified handling. <p>Handles {@link CompletableFuture}, {@link Future}, and synchronous result

Counts the number of entities that have a specific relationship with a target entity. @param relationshipType the type of relationship to count @para

Counts the number of relationships of a specific type. @param relationshipType the type of relationship to count @return the number of relationships

Creates a test runner instance using dependency injection. @return the configured test runner

Creates a new transaction context with a generated transaction ID. @param name the transaction name @param timeout the transaction timeout in se

Creates a test runner instance using dependency injection. @return the configured test runner

Creates a test runner instance. @return the configured test runner

Create Player module test runner

Creates an authorization failure exception. @param secured the security annotation @param cause the original exception @return the authorization fa

Creates a bidirectional relationship between two entities. @param entity1Uuid the UUID of the first entity @param entity2Uuid the UUID of

Creates a new transaction context with a generated transaction ID and parent. @param parentTransactionId the parent transaction ID @param name

Creates a child span context. @param operationName the child operation name @return the child trace context

Creates a child span of the current trace. @param operationName the child operation name @return the child trace context

Creates a pattern to match class names including package wildcards. <p>This method handles various wildcard patterns: <ul> <li>{@literal ..} - matc

Creates a resilient wrapper with conservative retry configuration (longer delays, fewer attempts). <p>This configuration is suitable for handling err

Creates a custom resilient wrapper with specified retry policy and compensation action. <p>This method provides maximum flexibility for configuring r

Creates a {@link CustomCacheService} with the specified cache implementation. @param cache the underlying cache implementation @param <V> the cache

Creates a resilient wrapper with fast retry configuration (short delays, more attempts). <p>This configuration is suitable for handling transient err

Creates a {@link GroovyEngine}. @return a new {@link GroovyEngine} instance @see GroovyEngine

Creates a hybrid retry counter with pattern-based selection. <p>Keys matching the pattern will use distributed counting, others will use local. @par

Creates a hybrid retry counter with prefix-based selection. <p>Keys starting with any of the specified prefixes will use distributed counting. @para

Creates a pattern to match method names. @return a Pattern for matching method names

Creates a pattern to match method modifiers based on the parsed expression. @return a Pattern for matching modifiers, or null to match any modifier

Creates a resilient wrapper that never retries but logs failures. <p>This configuration is useful when you want to monitor failures without automatic

Creates a pattern to match method parameters. <p>Currently supports: <ul> <li>{@code (..)} - matches any parameters</li> <li>{@code ()} - matches

Creates a string representation of parameter types including generic information. @param paramTypes the parameter types @param genericParamTyp

Creates a pattern to match method return types. @return a Pattern for matching return types

Creates a security context for the method invocation. @param context the aspect context @param invocation the method invocation @param provider

Creates a regex pattern for a type including generic parameters. @param typeStr the type string (e.g., "List<String>") @return regex pattern

Creates a validator instance. @param validatorClass the validator class @return the validator instance

Creates a hybrid counter with a simple key-pattern based selection. <p>Keys matching the pattern will use distributed counting, others will use local

Creates a hybrid counter that uses distributed counting for specified prefixes. <p>This factory method is useful when certain operation types (identi

Creates a new LocalRetryCounter without automatic cleanup. <p>Use this factory method when you want to manage cleanup manually or when TTL support is

Customizes the shared GsonBuilder and updates the Gson instance. <p>The customization is performed in a thread-safe manner using {@link ReentrantLock

Shuts down the shared scheduled executor service gracefully. <p><b>Important:</b> This method uses blocking operations ({@code awaitTermination}) tha

Shuts down the shared virtual thread executor gracefully. <p><b>Important:</b> This method uses blocking operations ({@code awaitTermination}) that w