OpenAPITools/openapi-generator

[Server] support interface and implementation classes for API controllers

开放

#426 创建于 2018年7月1日

 (11 条评论) (20 个反应) (0 位负责人)Java (7,516 个派生)batch import
HacktoberfestServer: AdaServer: C++Server: C-SharpServer: CeylonServer: EiffelServer: ElixirServer: ErlangServer: GoServer: HaskellServer: JavaServer: KotlinServer: NodejsServer: PHPServer: PerlServer: PythonServer: RubyServer: ScalaServer: Springhelp wanted

仓库指标

星标
 (26,243 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

Description

For auto-generated server code, we want to generate 2 files for each API controller file:

  1. an interface, which will be overwritten by code generation
  2. an implementation class, which will not be overwritten by code generation

Java Spring has already implemented this: https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/resources/JavaSpring/api.mustache https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/resources/JavaSpring/apiController.mustache

The goal is to avoid application/business logic being overwritten by code generation so that there's less overhead when adding/deleting/updating endpoint definition.

Other server generators should leverage similar design.

openapi-generator version

Latest master

Related issues/PRs

https://github.com/swagger-api/swagger-codegen/issues/5431

Suggest a fix/enhancement

If anyone wants to contribute the enhancement, please reply to let us know.

贡献者指南