java-standards
Java service standards for Bitso projects. Covers tech stack requirements, project organization, code review guidelines, MapStruct usage, and build verification practices. Use when creating new Java services or reviewing existing code.
安装与使用
请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。
查看来源 ↗使用指南技能说明
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 (L24-L31)
- Tech Stack (L53-L66)
- Project Organization (L67-L82)
- Build Verification (L83-L96)
- References (L97-L104)
- Related Rules (L105-L110)
- Related Skills (L111-L117)
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
-
.cursor/rules/java-services-standards.mdc- Full service standards -
.cursor/rules/java-code-review-standards.mdc- Code review guidelines -
.cursor/rules/java-run-build-after-changes.mdc- Build verification
Related Skills
| Skill | Purpose |
|---|---|
| gradle-standards | Gradle configuration |
| grpc-standards | gRPC service implementation |
| database-integration | jOOQ and Flyway |
使用示例
查看来源仓库中的使用示例与配置说明。
查看来源 ↗来源历史
- 收录时间
- 2026-01-20
- 索引更新时间
- 2026-01-28
- Branch
- main
收录与同步日期属于本站记录。源码修改历史请查看来源仓库。
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!