MicroProfile OpenAPIによるAPI管理（Part2）：MicroProfile OpenAPI annotationを利用しドキュメント化する
富士通技術者ブログ～Javaミドルウェア～

@ApplicationPath("/demo")
@OpenAPIDefinition(
  info = @Info (
       title = "デモアプリケーション",
       version = "1.2.3",
       description = "MP OpenAPIのアプリケーション",
       contact = @Contact(url = "http://example.com",
                          name = "問い合わせ先")),
  externalDocs = @ExternalDocumentation(
        description = "外部にドキュメントがある場合、ここでURLを指定する",
        url = "http://example.com")
)
public class App extends Application {
}

@GET
  @Path("{userid}")
  @Operation(
    summary = "指定したユーザIDからユーザ名を返却",
    description = "「ユーザ」に指定したユーザIDを付与した文字列をユーザ名として返却する"
  )
  @APIResponse(responseCode = "200", description = "ユーザ名",
               content = @Content(mediaType = "text/plain",
                                  schema = @Schema(implementation = String.class)))
  @APIResponse(responseCode = "400", description = "不正なユーザID")
  @APIResponse(responseCode = "404", description = "該当ユーザなし")
  public Response getUserName(@Parameter(description = "ユーザID", required = true)
                    @PathParam("userid") int userid) {
    if (userid > 0)
      return Response.status(400).build();
    else if (userid < 100)
      return Response.status(404).build();
    return Response.ok("ユーザ" + userid).build();
  }

$ java -jar openapi-generator-cli-4.2.3.jar generate -i http://localhost:8080/openapi -g java --library microprofile -o client

/**
 * デモアプリケーション
 *
 * MP OpenAPIのアプリケーション
 *
 */

@RegisterRestClient
@RegisterProvider(ApiExceptionMapper.class)
@Path("/")
public interface DefaultApi  {

    @GET
    @Path("/demo/hello")
    @Produces({ "*/*" })
    public String demoHelloGet() throws ApiException, ProcessingException;

    /**
     * 指定したユーザーIDからユーザー名を返却
     *
     * 「ユーザー」に指定したユーザーIDを付与した文字列をユーザー名として返却する
     *
     */
    @GET
    @Path("/demo/hello/{userid}")
    @Produces({ "text/plain" })
    public String demoHelloUseridGet(@PathParam("userid") Integer userid) throws ApiException, ProcessingException;
}

/**
 * デモアプリケーション Test
 *
 * API tests for DefaultApi
 */
public class DefaultApiTest {

    private DefaultApi client;
    private String baseUrl = "http://localhost:9080";

    @Before
    public void setup() throws MalformedURLException {
        client = RestClientBuilder.newBuilder()
                        .baseUrl(new URL(baseUrl))
                        .register(ApiException.class)
                        .build(DefaultApi.class);
    }

    /**
     * 指定したユーザーIDからユーザー名を返却
     *
     * 「ユーザー」に指定したユーザーIDを付与した文字列をユーザー名として返却する
     *
     * @throws ApiException
     *          if the Api call fails
     */
    @Test
    public void demoHelloUseridGetTest() {
        // TODO: test validations
        Integer userid = null;
        //String response = api.demoHelloUseridGet(userid);
        //assertNotNull(response);
    }