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

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

java-standards