Anotasi & Pola yang Didukung

Anotasi yang memperbaiki inferensi parser sumber dan bentuk kode yang dianalisis secara stabil.

Anotasi yang dipilih

@SelectedRequestParam

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

@SelectedRequestPath

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

@SelectedResponseBody

tipe respons dan nullable override pada method/local/parameter

Target anotasi

SelectedRequestParam

LOCAL_VARIABLE, PARAMETER

SelectedRequestPath

LOCAL_VARIABLE, PARAMETER

SelectedResponseBody

LOCAL_VARIABLE, PARAMETER, METHOD

Bentuk route yang disarankan

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();

Bentuk handler yang disarankan

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);
}

Ruang lingkup dukungan

Generator bukanlah compiler.

Menggabungkan analisis JavaParser/Spoon no-classpath dan resolusi simbol terbatas. Jika tipe penting untuk kontrak endpoint tidak dapat disimpulkan, gunakan annotation override, sourceClasspath, decompile jar, atau customTypeMapper.