Java现代代码转换器

技能文档

---
name: modern-java-converter
description: |
  将遗留Java代码转换为现代Java惯用写法，支持Java 8到Java 25的版本迁移。当用户需要升级Java版本、将POJO转为Record、将for循环转为Stream、将匿名类转为Lambda、优化并发模型时使用。触发词：Java现代化、Java升级、Record转换、虚拟线程、Stream重构、Lambda优化、Java迁移、代码现代化。
---

# Java 现代代码转换器

将遗留 Java 代码自动转换为现代 Java 惯用写法，支持 Java 8 到 Java 25 的版本感知转换。

## 版本感知策略

### 自动检测

1. 扫描项目配置文件（pom.xml / build.gradle）
2. 识别当前 Java 版本
3. 确定目标 Java 版本（默认最新 LTS）
4. 生成版本迁移路径

### 转换规则矩阵

| 旧写法 | 新写法 | 最低版本 |
|--------|--------|---------|
| POJO + Getter/Setter | Record | Java 16 |
| 匿名内部类 | Lambda 表达式 | Java 8 |
| for 循环 + 条件 | Stream API | Java 8 |
| Thread | Virtual Thread | Java 21 |
| synchronized | ReentrantLock / Virtual Thread | Java 21 |
| Optional.get() | Optional.orElseThrow() | Java 10 |
| String 拼接 | String.formatted() / Text Block | Java 15 |
| instanceof + 强转 | Pattern Matching instanceof | Java 16 |
| switch + break | switch 表达式 | Java 14 |
| 嵌套 if-else | 模式匹配 switch | Java 21 |
| try-with-resources 嵌套 | 多资源 try-with-resources | Java 9 |
| Collections.unmodifiableList() | List.of() | Java 9 |
| new HashMap<>() {{ put() }} | Map.of() / Map.ofEntries() | Java 9 |

## 转换流程

### 第一步：代码扫描

```
扫描范围：
├── src/main/java/       # 主代码
├── src/test/java/       # 测试代码
└── 配置文件             # Java 版本检测
```

识别以下模式：
- 可自动转换的安全模式
- 需要人工确认的半自动模式
- 需要架构决策的手动模式

### 第二步：安全转换

**Record 转换示例：**

```java
// 转换前
public class UserDTO {
    private final String name;
    private final int age;
    private final String email;

    public UserDTO(String name, int age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }

    public String getName() { return name; }
    public int getAge() { return age; }
    public String getEmail() { return email; }

    @Override
    public boolean equals(Object o) { ... }
    @Override
    public int hashCode() { ... }
    @Override
    public String toString() { ... }
}

// 转换后
public record UserDTO(String name, int age, String email) {
    // 紧凑构造器可用于验证
    public UserDTO {
        if (age < 0) throw new IllegalArgumentException("age < 0");
    }
}
```

**Stream 转换示例：**

```java
// 转换前
List<String> result = new ArrayList<>();
for (User user : users) {
    if (user.getAge() > 18) {
        result.add(user.getName().toUpperCase());
    }
}
Collections.sort(result);

// 转换后
List<String> result = users.stream()
    .filter(user -> user.age() > 18)
    .map(user -> user.name().toUpperCase())
    .sorted()
    .toList();
```

**虚拟线程转换示例：**

```java
// 转换前
ExecutorService executor = Executors.newFixedThreadPool(100);
for (Task task : tasks) {
    executor.submit(() -> process(task));
}

// 转换后
try (var executor = Executors.newVirtualThreadPerTaskExecutor()) {
    tasks.forEach(task -> executor.submit(() -> process(task)));
}
```

### 第三步：验证与测试

1. 编译检查：确保转换后代码编译通过
2. 单元测试：运行现有测试验证行为一致性
3. 性能对比：关键路径性能基准测试
4. 代码审查：标记需要人工确认的转换

## 安全规则

- **不改变外部行为**：所有转换保持功能等价
- **保留注释**：原有业务注释完整保留
- **渐进式迁移**：支持混合版本共存
- **回滚能力**：每次转换生成 diff，可快速回滚

## 框架适配

支持的框架自动适配：
- Spring Boot 2.x → 3.x（Jakarta EE 迁移）
- Hibernate 5 → 6（API 变更处理）
- Maven → Gradle（构建脚本转换）

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。