* fix(template): prepare extension scaffold for QQQ 4.0 * fix(ci): avoid interactive package restart prompts * docs: align guides and examples with QQQ 4.0 * docs(release): finalize QQQ 4.0 template instructions Refs QRun-IO/qqq#631.
1.3 KiB
1.3 KiB
QBit Template: Extension
Template repository for creating QQQ Extension QBits - infrastructure extensions, customizers, and action handlers.
What is an Extension QBit?
Extension QBits extend or enhance how QQQ operates at the infrastructure/framework level. They provide:
- New backend implementations
- Authentication mechanisms
- Audit capabilities
- Table customizers
- Action handlers
Quick Start
Requires Java 21, Maven 3.8+, and QQQ 4.0.0. Create your repository, customize its Maven coordinates and Java package/classes, implement the table customizer, then run mvn clean verify. See Getting Started.
Structure
src/main/java/com/kingsrook/qbits/example/
├── ExampleExtensionQBitConfig.java # Configuration
├── ExampleExtensionQBitProducer.java # Entry point
└── customizers/
└── ExampleTableCustomizer.java # Table customization
Key Characteristics
- No QAppSection - Pure infrastructure
- No user-facing tables (or minimal operational)
- Wraps existing tables/processes with new behavior
- Validates dependencies on other QQQ components