-
0 votesanswersviews
swagger-codegen不为引用的json文件中定义的模式生成类
我无法获得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", &... -
6 votesanswersviews
如何为OpenAPI 3.0.0运行swagger-codegen
看起来像官方swagger openapi规范V3支持接近发布https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/,并且swagger-codegen开发了3.0.0支持并在 3.0.0 分支上传递了一些级别的测试https://github.com/swagger-api/swagger-codegen 我有一个swagge... -
0 votesanswersviews
使用URI Swagger外部文件$ ref
技术与版本: Swagger 2.0(使用json,而不是yaml) JSON.NET架构(Newtonsoft.Json:10.0.0.2,Newtonsoft.Json.Schema:3.0.4) 需求: 使用Swagger进行“深层嵌套引用” . 作为最终结果,我想要一个主要的swagger文件,$ ref一个外部文件用于路径参数/响应定义,然后外部文件应该能够$ ref同一文件... -
3 votesanswersviews
SWAGGER swagger-codegen配置
在我的新工作中,我遇到了一个招摇配置文件,如下所示: { "modelPackage": "aa", "apiPackage": "aa.model", "invokerPackage": "aa.model", "bigDecimalAsString": t... -
4 votesanswersviews
将Swagger与JAX-RS和JAXB集成在一起需要帮助
我正在使用JAX-RS和JAXB开发REST Api . 我也想用Swagger为api生成文档 . 我按照这里的例子https://github.com/wordnik/swagger-core/wiki/java-jax-rs . 所以我在com.xml中添加了com.wordnik.swagger.jaxrs.listing到init参数,如下所示: <init-param> ... -
2 votesanswersviews
如何在没有招摇注释的情况下进行swagger服务器集成?
我可以将CXF jax-rs与swagger注释集成(@ Api,@ ApiOperation,@ ApiResponses,@ ApiParam) 但我想在没有@ Api,@ ApiOperation,@ ApiResponses,@ ApiParam的情况下进行整合 . 我看了下面的代码 - https://github.com/wordnik/swagger-core/tree/maste... -
3 votesanswersviews
使用JAX-RS Jersey 2和Grizzly的Swagger文档
我使用JAX-RS实现了Rest Web服务(该功能不相关) . 现在我想使用Swagger生成其文档 . 我遵循了以下步骤: 1)在 build.gradle 中,我得到了我需要的所有依赖项: compile 'org.glassfish.jersey.media:jersey-media-moxy:2.13' 2)我用Swagger注释记录我的代码 3)我在我的Application子类中连接... -
2 votesanswersviews
不能大摇大摆地工作(wildfly 9)
我找到了招摇和摇摆的ui,我喜欢这种方法 . 我已经设法让它至少在Spring启动时工作 . 现在我想将swagger集成到在wildfly 9上运行的Java EE应用程序中 . 不幸的是,这根本不起作用 . Swagger记载的确很差 . 有什么必要让它工作?我按照https://github.com/swagger-api/swagger-core/wiki/Swagger-Core-JA... -
0 votesanswersviews
Xamarin Forms部署失败
我正在Visual Studio 2017中使用Xamarin Forms应用程序 . 我想将应用程序部署到android模拟器 . 我尝试部署它的调试模式 . 我将android项目设置为启动项目 当我部署我得到这个警告 No Address and User has been specified in order to establish a connection to a Mac Serve... -
1 votesanswersviews
从现有REST API生成Swagger文档
鉴于现有的JAX-RS注释API接受并返回带有jackson-annotated类型的json,有没有办法可以生成一些YAML Swagger文档?我的计划B是编写一些使用反射来查找REST注释类型的代码,创建其参数和返回的哈希映射,然后为Jackson注释抓取这些类,并以这种方式生成文档 . 我更愿意使用已经存在的解决方案来编写一次性的东西 . 我发现这个Swagger模块声称它可以解析Jack... -
12 votesanswersviews
使用外部枚举定义从JAX-RS endpoints 生成Swagger
我想通过外部枚举定义从JAX-RS endpoints 生成一个招摇,但生成的swagger直接包含枚举到模型的定义中 . 这意味着不会生成枚举文档,而是在客户端复制相同的枚举 . 我使用 swagger-jaxrs 依赖项来扫描我的 endpoints 并生成swagger json文件 . 此GitHub repository可用于重现该问题 . 我还在swagger-core存储库上创建了一... -
0 votesanswersviews
问题--WAS 8.5中的Swagger Jax-rs
嗨,我正在尝试使用Swagger和我的jax-rs休息服务 . 我运行mvn build时没有看到生成的代码 . 尝试访问时获取404 . http://localhost:9080/swagger-jaxrs/api/swagger.json或 这是代码 - 的pom.xml <dependency> <groupId>io.swagger</groupId&g... -
0 votesanswersviews
带注释的Swagger参数验证
此示例方法使用 allowableValues 架构参数进行批注,但是在运行此示例时,可以传入其他值而不会出现任何验证错误 . 是否有任何支持在swagger-core或其他地方启用基于这些注释的验证?或者它们仅用于装饰和模式生成? @GET @Path("/findByStatus") public List<Pet> findPetsByStatus( @P... -
20 votesanswersviews
500在asp .net CORE / MVC 6应用程序中设置Swagger时出错
我正在尝试在新的asp .net CORE / MVC 6项目中设置一个基本的swagger API文档,并从swagger UI接收500错误: 500 : http://localhost:4405/swagger/v1/swagger.json 我的启动类中包含以下代码: using Swashbuckle.SwaggerGen; using Swashbuckle.SwaggerGen.X... -
3 votesanswersviews
.net核心web api / swashbuckle basepath和路径问题
我的.net核心Web API项目包含控制器的 [Route("/api/v1/members")] 属性和方法 GetMemberById 的 [HttpGet("{id}")] 由swashbuckle生成的swagger描述如下: "basePath":"/","paths":{"/... -
0 votesanswersviews
如何让Swagger Swashbuckle显示 endpoints ?
我试图将swagger swashbuckle添加到我的ASP.NET Core项目中 . 我可以启动并运行Swagger UI,但它完全是空的 . 我试着四处寻找并在https://github.com/domaindrivendev/Swashbuckle/issues/1058发现了类似的问题 . 这让我觉得可能路由是问题所以我尝试使用 [Route("testroute"... -
3 votesanswersviews
具有传统路由的Web API文档
我只是尝试将Swagger与ASP.Net Core Web API项目一起使用,但它没有找到任何我的控制器/操作 . 原来Swagger不支持传统路由(如此处所述https://github.com/domaindrivendev/Swashbuckle.AspNetCore) . 我的所有路由都是使用routeBuilder.MapRoute()在一个函数内的代码中生成的 . 我有150个控制... -
0 votesanswersviews
在ASP.Net Core中避免“请求匹配多个操作导致歧义”错误
我正在尝试做一些简单而微不足道的事 - 或者至少我认为 . 我正在尝试编写一个可以由我启动的每个微服务项目继承的基类 . 这个基类的重点是测试从HTTP到SQL的连接 . 它未在PROD中启用 . 这是(更简单的)基类之一: public class DevTestControllerBase: ApiControllerBase { public DevTestControllerBas... -
2 votesanswersviews
控制器中的多个HttpPost方法可防止swagger .json生成
我在示例C#ASP.NET Core 2.0 Api中有一个Authors控制器,我使用Swashbuckle生成Swagger .json . 当我在AuthorsController中包含以下两个方法时,.json不会生成 [HttpPost(Name = "CreateAuthor")] public IActionResult CreateAuthor([Fr... -
1 votesanswersviews
我在子文件夹上部署时出现Swashbuckle root错误
我从Swashbuckle开始,我使用Swashbuckle在.NET Core中创建一个Web API . 我需要在IIS站点的子应用程序中部署我的API IIS基础结构 IIS站点(站点) myApi(subApplication) http://ip:80/myApi 我想通过这个url访问swagger UI: http://ip:80/myApi/swagger 我希望通过... -
1 votesanswersviews
swashbuckle中自动生成的swagger.json应该在swagger编辑器中有效吗?
我有一个.NET核心2.1 Web API,它使用Swashbuckle.AspNetCore v3.0.0来生成swagger文档 . 我可以从API中访问swagger UI,它可以很好地工作,从API中使用它时不会收到任何错误 . 但是,我不能使用swagger.json将此API发布到Azure API Management . 当我在swagger编辑器中加载swagger.json进行... -
0 votesanswersviews
swagger无法找到从ASP NET CORE项目中的程序集加载的控制器
我有一个asp .net核心控制台项目,它使用ApplicationPart加载API程序集 . 我需要添加swagger以暴露API,但是当我将Swashbuckle安装到控制台项目并在启动类中配置Swagger时,如果我导航到swagger ui,则无法找到任何内容 . 它返回401错误 . 在ConfigureServices方法中: services.AddMvc .AddApplicat... -
1 votesanswersviews
swagger codegen中的授权信息
我开始使用Swagger为我的 REST APIs . 主要目标是从Swagger定义为Nancy endpoints 生成服务器文件 . 我下载了源代码并使用 api.moustache 文件将Nancy生成的文件修改为我的需要 . 一切正常但一方面:一些 endpoints 受到保护,而另一些 endpoints 则没有 . 在swagger格式的文档中,我发现每个 endpoints 都可... -
1 votesanswersviews
Swagger Codegen Angular 5
有没有办法让swagger codegen专门使用更新的HTTPClientModule更改为Angular 5生成文件?目前我可以't even get a version of the codegen to run and the online editor won'为https://esi.tech.ccp.is/latest/swagger.json返回codegen,即使它确实如此,我认... -
1 votesanswersviews
如何用Swagger Codegen排除某些操作/ HTTP动词?
我正在使用带有AWS API Gateway的Swagger . 为了完全支持CORS,我的swagger文件中有几个OPTIONS方法;它们的存在只是为了告诉API网关返回CORS标头,以便我的Angular应用程序的预检请求成功 . 但是,当我使用Swagger codegen生成API时,所有这些OPTIONS方法都在我的服务中作为真正的方法出现 . 我不希望这种情况发生 . 如何告诉Swa... -
6 votesanswersviews
Swagger-codegen生成的模型反序列化问题 - 无法识别的字段“@id”
我试图使用swagger-codegen生成的代码来使用我的REST服务,这是在我的swagger.json中定义的(由服务器端由springfox 2.9.0提供) 我正在生成api,模型和支持文件 .但每次我尝试使用GET api时,都会发生错误: avax.ws.rs.client.ResponseProcessingException: Problem with reading the d... -
2 votesanswersviews
Angular 5 Swagger Codegen &&严格空检查
在我的angular-cli(最新)项目(ng v5 LTS)的tsconfig.json中,我设置了(并且必须保留它) "strictNullChecks": true, 我使用Swagger Codegen(Maven v2.3.1)来生成api客户端模型 . 该命令正在使用这些选项: `-jar ${jarPath} generate -i ${apiPath} -l ... -
0 votesanswersviews
为什么Swagger Codegen在从java运行时给出配置类不加载错误?
我试图在java代码中使用Swagger Codegen在Spring中自动构建一个API,如下所示: String[] args = new String[4]; args[0] = "generate"; args[1] = "-i swagger.json"; args[2] = "-l spring"; args[3] = &qu... -
9 votesanswersviews
如何从laravel服务?
我正在尝试使用带有laravel的swagger来自动记录我们的RESTful API . 目标是在laravel控制器中保持swagger注释,然后swagger解析注释并生成相关的.json / .php文件 . 理想情况下,我希望laravel项目能够提供swagger文件,以便将所有内容保存在同一个引擎盖下并保持同步 . 为了实现这一点,我在laravel项目的根目录中创建了一个docs目... -
0 votesanswersviews
我真的需要创建swagger.json和swagger.yaml才能将Swagger用于文档休息应用程序
我花了一整天的时间按照Swagger的指导,基本上告知在添加了swagger依赖并部署/启动它后,我会根据Swagger注释(例如@Api)使用两个文件来描述我的休息服务 . 首先,目前尚不清楚这两个文件是在编译后还是在某个特定阶段(部署到服务器,任何特定的maven阶段或目标,或容器启动)时创建的 . 好吧,如果我能够完成并运行,这根本不是问题(请参阅我的困难I can't get swagge...