我无法让swagger-codegen为在独立于主API定义文件的文件中定义的json模式生成类。我使用的命令是:
$ java -jar swagger-codegen-cli-2.2.2.jar generate -i api.json -l java -o gen -v
这是api.json的样子:
{
"swagger": "2.0",
"info": {
"version": "1.0.0",
"title": "Simple API",
"description": "A simple API to learn how to write OpenAPI Specification"
},
"schemes": [
"https"
],
"host": "simple.api",
"basePath": "/openapi101",
"paths": {
"/persons": {
"get": {
"summary": "Gets some persons",
"description": "Returns a list containing all persons.",
"responses": {
"200": {
"description": "A list of Person",
"schema": {
"$ref" : "person.json#/definitions/person"
}
}
}
}
}
}
}
这里引用的person.json文件与api.json并存(即在同一级别),并包含以下内容:
{"definitions": {
“person”: {
"type": "object",
"description": "",
"properties": {
"requestId": {
"type": "string",
"example": "1234"
}
}
}}}
我期望代码生成会生成一个名为Person.java的类--但它没有--事实上它不会生成任何模型类。此外,详细日志记录一开始就记录了以下内容,这让我认为它错误地解释了引用,并且出于某种原因在$ref中添加了#定义。
主要信息io.swagger.parser.Swagger20Parser -从api.json读取
{
"swagger" : "2.0",
"info" : {
"description" : "A simple API to learn how to write OpenAPI Specification",
"version" : "1.0.0",
"title" : "Simple API"
},
"host" : "simple.api",
"basePath" : "/openapi101",
"schemes" : [ "https" ],
"paths" : {
"/persons" : {
"get" : {
"summary" : "Gets some persons",
"description" : "Returns a list containing all persons.",
"parameters" : [ ],
"responses" : {
"200" : {
"description" : "A list of Person",
"schema" : {
"$ref" : "#/definitions/person.json#/definitions/person"
}
}
}
}
}
}
}
有人知道这里发生了什么吗?引用本地文件中的模式定义的正确方法是什么?
发布于 2017-05-24 14:45:10
将./添加到$ref中可以使其正常工作。
./person.json#/definitions/person
https://stackoverflow.com/questions/44143163
复制相似问题