// Help write tests for JUDO applications using judo-runtime-core-guice-testkit. Use when writing interceptor tests, setting up JudoRuntimeFixture, or troubleshooting testkit issues.
Comprehensive guide to the JUDO authentication pipeline. Use when you need to understand how authentication works, debug auth issues, configure OAuth2/OpenID Connect, or integrate with identity providers like Keycloak.
Add Claude skill packages and agent-docs to a JUDO Runtime Core module. Use when making a module self-contained with embedded documentation, creating skills for interceptors/extensions, or packaging agent docs in JARs.
Comprehensive guide to JUDO Access Manager API interfaces. Use when you need to understand operation authorization, implement custom authentication interceptors, work with signed identifiers, or integrate access control into your application.
Comprehensive guide to configuring access control rules in JUDO Runtime. Use when you need to understand actor-based authorization, configure public vs authenticated access, set up exposedBy annotations, or implement custom authentication interceptors.
Detailed guide to the JUDO permission checking flow for CRUD operations. Use when you need to understand how CREATE, UPDATE, DELETE permissions work, debug authorization failures, or implement custom authorizers.
Understand JUDO DAO Core interface patterns including payload processors, statement types, instance collectors, and validation. Use when working with data access operations, implementing custom processors, or understanding the DAO architecture.
| name | judo-runtime:testkit |
| description | Help write tests for JUDO applications using judo-runtime-core-guice-testkit. Use when writing interceptor tests, setting up JudoRuntimeFixture, or troubleshooting testkit issues. |
| license | EPL-2.0 |
| compatibility | Requires judo-runtime-core-guice-testkit dependency. |
| metadata | {"author":"BlackBelt Technology","version":"1.0.0"} |
Help write tests for JUDO applications using judo-runtime-core-guice-testkit.
Use this skill when:
Read the agent documentation from the testkit JAR for detailed patterns:
Location: ~/.m2/repository/hu/blackbelt/judo/runtime/judo-runtime-core-guice-testkit/{version}/judo-runtime-core-guice-testkit-{version}.jar!/agent-docs/
Files:
README.md - Quick patterns and decision treeinterceptor-testing.md - Full interceptor testing guideapi-reference.md - Key classes referencetroubleshooting.md - Common errors and fixesTEST-CONFIGURATION.md - Test setup and dependenciesTesting interceptor?
├─► Unit test (test preCall/postCall directly)
│ └─► ReferenceInjector.createAndInject(MyInterceptor.class, injector)
│
├─► Integration test (interceptor invoked by dispatcher)
│ ├─► Annotation-based (recommended)
│ │ └─► @JudoTest(interceptors = {MyInterceptor.class})
│ └─► Programmatic
│ └─► fixture.addInterceptor(MyInterceptor.class) // before init()
│
└─► Model-based test (with real JUDO model)
└─► JudoModelLoader.loadFromDirectory(name, dir, dialect, false)
| Class | Purpose |
|---|---|
JudoRuntimeFixture | Main test fixture |
@JudoTest | Annotation for declarative tests |
ReferenceInjector | Inject deps into objects |
TestOperationCallInterceptorProvider | Mutable interceptor provider |
JudoModelLoader | Load JUDO models |
import hu.blackbelt.judo.runtime.core.guice.testkit.fixture.JudoTest;
import hu.blackbelt.judo.runtime.core.guice.testkit.fixture.JudoRuntimeFixture;
@JudoTest(interceptors = {MyInterceptor.class})
void testInterceptor(JudoRuntimeFixture fixture) {
Dispatcher dispatcher = fixture.getInjector().getInstance(Dispatcher.class);
// MyInterceptor automatically registered and invoked
dispatcher.callOperation("model.Entity.operation", payload);
}
JudoRuntimeFixture fixture = new JudoRuntimeFixture();
fixture.prepare("modelName", dataSource, "hsqldb");
fixture.addInterceptor(MyInterceptor.class); // MUST be before init()
fixture.init(new AbstractModule() {}, null);
@JudoTest
void testLogic(JudoRuntimeFixture fixture) {
MyInterceptor interceptor = ReferenceInjector.createAndInject(
MyInterceptor.class, fixture.getInjector());
Object result = interceptor.preCall(operation, payload);
// Assert directly
}
| Constraint | Details |
|---|---|
addInterceptor() | MUST call before init() |
| Interceptor constructor | MUST have no-arg constructor |
getInterceptorProvider() | MUST call after init() |
| Transaction default | AUTO_ROLLBACK |
| Error | Fix |
|---|---|
IllegalStateException: already initialized | Move addInterceptor() before init() |
NoSuchMethodException | Add no-arg constructor to interceptor |
NullPointerException in interceptor | Ensure using @JudoTest or calling init() |
<dependency>
<groupId>hu.blackbelt.judo.runtime</groupId>
<artifactId>judo-runtime-core-guice-testkit</artifactId>
<version>${judo-runtime-core-version}</version>
<scope>test</scope>
</dependency>