v0.1.0 to v0.1.0

---

name: coding-java

version: 0.1.0

description: Java naming conventions, exception hierarchy, import patterns, and quality overrides for ECHO Protocol.

---

# Java Coding Standards

<!-- Load this when protocol.config.yaml has language: "java" -->

## Naming Conventions

| Element | Convention | Example |

|---------|-----------|---------|

| Classes | PascalCase | `UserProfile`, `GameState` |

| Interfaces | PascalCase | `Serializable`, `Renderable` |

| Methods | camelCase | `calculateDistance`, `spawnUnit` |

| Variables | camelCase | `playerCount`, `isValid` |

| Constants | UPPER_SNAKE_CASE | `MAX_PLAYERS`, `TILE_SIZE` |

| Enums | PascalCase (class), UPPER_SNAKE_CASE (values) | `TileType.GRASSLAND` |

| Packages | lowercase, reversed domain | `com.example.gameengine` |

| Files | PascalCase.java (match class name) | `UserProfile.java` |

## Patterns

### Error Handling

- Use custom exception hierarchy extending `Exception`

- Catch specific exceptions, never bare `Exception`

- Use try-with-resources for AutoCloseable

- Log at catch points with context

### Concurrency

- Prefer `ExecutorService` over raw threads

- Use `synchronized` or `ReentrantLock` for shared state

- Immutable objects preferred over synchronization

- Use `CompletableFuture` for async composition

### Imports

- Group: java → javax → external → internal

- No wildcard imports

- Use IDE auto-import management

## File Structure

```text

src/main/java/com/example/

├── Application.java # Entry point

├── config/

│ └── AppConfig.java # Configuration

├── exception/

│ └── AppException.java # Custom exceptions

├── model/

│ └── [Domain].java # Data classes

├── service/

│ └── [Domain]Service.java # Business logic

src/test/java/

└── [Mirror structure]

```

## Anti-Patterns to Flag

- [ ] Bare `catch (Exception e)`

- [ ] Mutable static fields

- [ ] Deep inheritance hierarchies (>3 levels)

- [ ] `null` returns instead of Optional

- [ ] Magic numbers (extract to constants)