mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 23:03:06 +08:00
docs: add native Japanese translation of ECC documentation (ja-JP)
Translate everything-claude-code repository to Japanese including: - 17 root documentation files - 60 agent documentation files - 80 command documentation files - 99 rule files across 18 language directories (common, angular, arkts, cpp, csharp, dart, fsharp, golang, java, kotlin, perl, php, python, ruby, rust, swift, typescript, web) - 199 skill documentation files Total: 455 files translated to Japanese with: - Consistent terminology glossary applied throughout - YAML field names preserved in English (name, description, etc.) - Code blocks and examples untouched (comments translated) - Markdown structure and relative links preserved - Professional translation maintaining technical accuracy This translation expands ECC accessibility to Japanese-speaking developers and teams. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
133
docs/ja-JP/rules/java/testing.md
Normal file
133
docs/ja-JP/rules/java/testing.md
Normal file
@@ -0,0 +1,133 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.java"
|
||||
---
|
||||
# Java テスト
|
||||
|
||||
> このファイルは [common/testing.md](../common/testing.md) を Java 固有のコンテンツで拡張します。
|
||||
|
||||
## テストフレームワーク
|
||||
|
||||
- **JUnit 5**(`@Test`、`@ParameterizedTest`、`@Nested`、`@DisplayName`)
|
||||
- **AssertJ** — 流暢なアサーション(`assertThat(result).isEqualTo(expected)`)
|
||||
- **Mockito** — 依存関係のモック
|
||||
- **Testcontainers** — データベースやサービスを必要とする統合テスト
|
||||
|
||||
## テストの構成
|
||||
|
||||
```
|
||||
src/test/java/com/example/app/
|
||||
service/ # サービス層のユニットテスト
|
||||
controller/ # Web 層 / API テスト
|
||||
repository/ # データアクセステスト
|
||||
integration/ # クロスレイヤー統合テスト
|
||||
```
|
||||
|
||||
`src/main/java` のパッケージ構造を `src/test/java` にミラーリングする。
|
||||
|
||||
## ユニットテストパターン
|
||||
|
||||
```java
|
||||
@ExtendWith(MockitoExtension.class)
|
||||
class OrderServiceTest {
|
||||
|
||||
@Mock
|
||||
private OrderRepository orderRepository;
|
||||
|
||||
private OrderService orderService;
|
||||
|
||||
@BeforeEach
|
||||
void setUp() {
|
||||
orderService = new OrderService(orderRepository);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("findById returns order when exists")
|
||||
void findById_existingOrder_returnsOrder() {
|
||||
var order = new Order(1L, "Alice", BigDecimal.TEN);
|
||||
when(orderRepository.findById(1L)).thenReturn(Optional.of(order));
|
||||
|
||||
var result = orderService.findById(1L);
|
||||
|
||||
assertThat(result.customerName()).isEqualTo("Alice");
|
||||
verify(orderRepository).findById(1L);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("findById throws when order not found")
|
||||
void findById_missingOrder_throws() {
|
||||
when(orderRepository.findById(99L)).thenReturn(Optional.empty());
|
||||
|
||||
assertThatThrownBy(() -> orderService.findById(99L))
|
||||
.isInstanceOf(OrderNotFoundException.class)
|
||||
.hasMessageContaining("99");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## パラメータ化テスト
|
||||
|
||||
```java
|
||||
@ParameterizedTest
|
||||
@CsvSource({
|
||||
"100.00, 10, 90.00",
|
||||
"50.00, 0, 50.00",
|
||||
"200.00, 25, 150.00"
|
||||
})
|
||||
@DisplayName("discount applied correctly")
|
||||
void applyDiscount(BigDecimal price, int pct, BigDecimal expected) {
|
||||
assertThat(PricingUtils.discount(price, pct)).isEqualByComparingTo(expected);
|
||||
}
|
||||
```
|
||||
|
||||
## 統合テスト
|
||||
|
||||
Testcontainers を使用した実データベース統合:
|
||||
|
||||
```java
|
||||
@Testcontainers
|
||||
class OrderRepositoryIT {
|
||||
|
||||
@Container
|
||||
static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16");
|
||||
|
||||
private OrderRepository repository;
|
||||
|
||||
@BeforeEach
|
||||
void setUp() {
|
||||
var dataSource = new PGSimpleDataSource();
|
||||
dataSource.setUrl(postgres.getJdbcUrl());
|
||||
dataSource.setUser(postgres.getUsername());
|
||||
dataSource.setPassword(postgres.getPassword());
|
||||
repository = new JdbcOrderRepository(dataSource);
|
||||
}
|
||||
|
||||
@Test
|
||||
void save_and_findById() {
|
||||
var saved = repository.save(new Order(null, "Bob", BigDecimal.ONE));
|
||||
var found = repository.findById(saved.getId());
|
||||
assertThat(found).isPresent();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Spring Boot 統合テストについては、スキル: `springboot-tdd` を参照してください。
|
||||
Quarkus 統合テストについては、スキル: `quarkus-tdd` を参照してください。
|
||||
|
||||
## テスト命名
|
||||
|
||||
`@DisplayName` を使った説明的な名前:
|
||||
- メソッド名には `methodName_scenario_expectedBehavior()`
|
||||
- レポート用に `@DisplayName("人間が読める説明")`
|
||||
|
||||
## カバレッジ
|
||||
|
||||
- 行カバレッジ 80% 以上を目標
|
||||
- カバレッジレポートには JaCoCo を使用
|
||||
- サービスとドメインロジックに集中する — 自明な getter/設定クラスはスキップ
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `springboot-tdd` で MockMvc と Testcontainers を使った Spring Boot TDD パターンを参照してください。
|
||||
スキル: `quarkus-tdd` で REST Assured と Dev Services を使った Quarkus TDD パターンを参照してください。
|
||||
スキル: `java-coding-standards` でテスト要件を参照してください。
|
||||
Reference in New Issue
Block a user