Jooby项目中的APT处理器优化：默认关闭Route.setReturnType并标记为弃用

在最新版本的Jooby框架中，开发团队对APT（Annotation Processing Tool）处理器进行了一项重要优化，旨在简化生成的代码并提高编译效率。这项变更主要影响了MVC控制器方法的代码生成方式。

变更背景

在之前的版本中，当开发者使用MVC风格编写控制器方法时，APT处理器会自动生成包含setReturnType和setMvcMethod调用的路由代码。例如，对于以下简单的控制器方法：

public class MyController {
  @GET
  public String hello() {
    return "Hello";
  }
}

处理器会生成如下路由注册代码：

app.get("/", this::hello)
  .setReturnType(String.class)
  .setMvcMethod(MyController.class.getMethod("hello"));

这种生成方式虽然提供了方法返回类型和反射方法信息，但在大多数情况下并非必需，反而增加了代码复杂性和编译负担。

优化内容

从新版本开始，Jooby团队决定：

1. 默认关闭setReturnType和setMvcMethod的自动生成
2. 将这些方法标记为弃用状态
3. 提供编译选项供需要这些功能的开发者显式启用

优化后，上述示例生成的代码将简化为：

app.get("/", this::hello);

技术考量

这项变更基于以下几个技术考量：

1. 编译性能：简化生成的代码可以减少编译器的工作量，特别是在大型项目中
2. 代码可读性：生成的代码更加简洁明了
3. 反射优化：减少对反射方法的依赖，符合现代Java框架的趋势
4. 实用性：大多数应用场景并不需要这些额外信息

兼容性处理

对于确实需要这些功能的项目，Jooby提供了两个处理器选项：

1. jooby.mvcMethod：控制是否生成setMvcMethod调用
2. jooby.returnType：控制是否生成setReturnType调用

开发者可以通过配置这些选项来保持原有行为。不过团队建议新项目采用默认的简化模式，除非有特殊需求。

对开发者的影响

这项变更属于破坏性变更(breaking change)，但影响范围有限：

1. 依赖这些方法信息的监控、日志等切面逻辑需要调整
2. 使用反射方法信息的自定义扩展需要迁移
3. 项目构建配置可能需要更新以保持原有行为

团队建议开发者评估项目对这些特性的依赖程度，逐步迁移到更简洁的代码生成模式。

未来方向

Jooby团队正在考虑引入更轻量级的替代方案，如自定义的MvcMethod类型，来替代反射方法的使用，同时保持框架的灵活性和扩展性。这将进一步优化性能并提高与GraalVM等技术的兼容性。