注解与支持的模式

用于修正源解析器推断的注解和稳定分析的代码形状。

已选择的注释

@SelectedRequestParam

query parameter의 key, defaultValue, required, nullable, type override

@SelectedRequestPath

path variable의 key, defaultValue, required, nullable, type override

@SelectedResponseBody

method/local/parameter中的响应类型和可空覆盖

注释目标

SelectedRequestParam

LOCAL_VARIABLE, PARAMETER

SelectedRequestPath

LOCAL_VARIABLE, PARAMETER

SelectedResponseBody

LOCAL_VARIABLE, PARAMETER, METHOD

推荐的路由形状

java

return route()
    .nest(path("/api/member"), builder -> builder
        .nest(path("/search"), search -> search
            .GET("/get-list", accept(MediaType.APPLICATION_JSON), handler::getList)
            .GET("/get-detail/{id}", handler::getDetail))
        .POST("/create", handler::create))
    .build();

推荐的处理程序形状

java

public Mono<ServerResponse> getDetail(ServerRequest request) {
  String id = request.pathVariable("id");
  Mono<MemberResponse> response = service.getDetail(id);

  return ServerResponse.ok()
      .contentType(MediaType.APPLICATION_JSON)
      .body(response, MemberResponse.class);
}

支持范围

生成器不是编译器

结合JavaParser/Spoon无类路径分析和有限的符号解析。如果未推断出对端契约重要的类型，请使用注解覆盖、sourceClasspath、反编译jar或customTypeMapper。