Java Standards
Java service standards for Bitso projects.
When to use this skill
-
Creating new Java services or modules
-
Understanding project organization patterns
-
Reviewing Java code for standards compliance
-
Configuring MapStruct for object mapping
-
Verifying builds after code changes
Skill Contents
Sections
-
When to use this skill
-
Tech Stack
-
Project Organization
-
Build Verification
-
References
-
Related Rules
-
Related Skills
Available Resources
📚 references/ - Detailed documentation
-
build verification
-
code review
-
mapstruct spring
-
services
Tech Stack
Component Version Notes
Java 21 (LTS) Current LTS version
Gradle 9.2.1 Recommended for all projects
Spring Boot 3.5.9 Latest (min 3.5.9) - preparing for Spring Boot 4
Database Access jOOQ For accessing PostgreSQL
Databases PostgreSQL, Redis Primary data stores
Inter-service Communication gRPC Standard protocol
Object Mapping MapStruct For DTO/domain mapping
For Spring Boot upgrades, use /upgrade-to-recommended-versions .
Project Organization
Projects should be organized with domain-based modules:
root-project/ ├── build.gradle ├── settings.gradle ├── docs/ # Documentation ├── bitso-libs/ # Library modules │ ├── <subdomain>/ # Domain logic │ └── <subdomain-proto>/ # Protobuf definitions └── bitso-services/ # Service modules └── <domain>/ # Spring Boot application
Build Verification
After updating Java or Groovy code, verify changes:
Run tests to verify changes
./gradlew test 2>&1 | grep -E "FAILED|Error" || echo "All tests passed"
Or run full build with tests
./gradlew build 2>&1 | grep -E "FAILED|Error" || echo "Build successful"
If problems are found, fix them before committing.
References
Reference Description
references/services.md Tech stack, project structure, dependency management, MapStruct
references/code-review.md Java 21 standards, coding style, var keyword usage
references/build-verification.md Build commands and verification practices
Related Rules
-
java-services-standards - Full-service standards
-
java-code-review-standards - Code review guidelines
-
java-run-build-after-changes - Build verification
Related Skills
Skill Purpose
gradle-standards Gradle configuration
grpc-services-rfc-33 gRPC service implementation
database-integration jOOQ and Flyway