我们的后台项目是使用Restful格式的Web Api接口,(可以使用Java或C#开发)
而前端是采用的Winform开发,这就需要前后端互相调用,所有才有了swagger中间层。
这里使用的是swagger-codegen-cli-2.3.1.jar(自行下载)来生成C#代码的,需要先为swagger-codegen-cli-2.3.1.jar运行时的参数配置文件。如下:
csharp_config.json
{ "packageName": "Car.Swagger", "targetFramework": "v4.6.1", "sortParamsByRequiredFlag": "false" }
然后在同目录中创建运行的bat文件,如下:
GenerateCode.bat
java -jar swagger-codegen-cli-2.3.1.jar generate -i http://127.0.0.1:8080/v2/api-docs -l csharp -c csharp_config.json -o SwaggerProject pause
参数说明:
-i:是指的Restful格式api路径,这个不明白的可参考我前面的文章说明
-l:是指的生成的代码的语言,这里我们使用csharp
-c:是指运行时使用的配置文件,就是上的我们为项目配置好的json文件
-o:是指生成的代码文件的输出目录,这里是输出当前目录下的SwaggerProject文件夹中
其他更多的参数和使用说明,可参考官方说明文档。