首页 文章
  • 0 votes
     answers
     views

    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 votes
     answers
     views

    如何为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 votes
     answers
     views

    使用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 votes
     answers
     views

    SWAGGER swagger-codegen配置

    在我的新工作中,我遇到了一个招摇配置文件,如下所示: { "modelPackage": "aa", "apiPackage": "aa.model", "invokerPackage": "aa.model", "bigDecimalAsString": t...
  • 4 votes
     answers
     views

    将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 votes
     answers
     views

    如何在没有招摇注释的情况下进行swagger服务器集成?

    我可以将CXF jax-rs与swagger注释集成(@ Api,@ ApiOperation,@ ApiResponses,@ ApiParam) 但我想在没有@ Api,@ ApiOperation,@ ApiResponses,@ ApiParam的情况下进行整合 . 我看了下面的代码 - https://github.com/wordnik/swagger-core/tree/maste...
  • 3 votes
     answers
     views

    使用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 votes
     answers
     views

    不能大摇大摆地工作(wildfly 9)

    我找到了招摇和摇摆的ui,我喜欢这种方法 . 我已经设法让它至少在Spring启动时工作 . 现在我想将swagger集成到在wildfly 9上运行的Java EE应用程序中 . 不幸的是,这根本不起作用 . Swagger记载的确很差 . 有什么必要让它工作?我按照https://github.com/swagger-api/swagger-core/wiki/Swagger-Core-JA...
  • 0 votes
     answers
     views

    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 votes
     answers
     views

    从现有REST API生成Swagger文档

    鉴于现有的JAX-RS注释API接受并返回带有jackson-annotated类型的json,有没有办法可以生成一些YAML Swagger文档?我的计划B是编写一些使用反射来查找REST注释类型的代码,创建其参数和返回的哈希映射,然后为Jackson注释抓取这些类,并以这种方式生成文档 . 我更愿意使用已经存在的解决方案来编写一次性的东西 . 我发现这个Swagger模块声称它可以解析Jack...
  • 12 votes
     answers
     views

    使用外部枚举定义从JAX-RS endpoints 生成Swagger

    我想通过外部枚举定义从JAX-RS endpoints 生成一个招摇,但生成的swagger直接包含枚举到模型的定义中 . 这意味着不会生成枚举文档,而是在客户端复制相同的枚举 . 我使用 swagger-jaxrs 依赖项来扫描我的 endpoints 并生成swagger json文件 . 此GitHub repository可用于重现该问题 . 我还在swagger-core存储库上创建了一...
  • 0 votes
     answers
     views

    问题--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 votes
     answers
     views

    带注释的Swagger参数验证

    此示例方法使用 allowableValues 架构参数进行批注,但是在运行此示例时,可以传入其他值而不会出现任何验证错误 . 是否有任何支持在swagger-core或其他地方启用基于这些注释的验证?或者它们仅用于装饰和模式生成? @GET @Path("/findByStatus") public List<Pet> findPetsByStatus( @P...
  • 20 votes
     answers
     views

    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 votes
     answers
     views

    .net核心web api / swashbuckle basepath和路径问题

    我的.net核心Web API项目包含控制器的 [Route("/api/v1/members")] 属性和方法 GetMemberById 的 [HttpGet("{id}")] 由swashbuckle生成的swagger描述如下: "basePath":"/","paths":{"/...
  • 0 votes
     answers
     views

    如何让Swagger Swashbuckle显示 endpoints ?

    我试图将swagger swashbuckle添加到我的ASP.NET Core项目中 . 我可以启动并运行Swagger UI,但它完全是空的 . 我试着四处寻找并在https://github.com/domaindrivendev/Swashbuckle/issues/1058发现了类似的问题 . 这让我觉得可能路由是问题所以我尝试使用 [Route("testroute&quot...
  • 3 votes
     answers
     views

    具有传统路由的Web API文档

    我只是尝试将Swagger与ASP.Net Core Web API项目一起使用,但它没有找到任何我的控制器/操作 . 原来Swagger不支持传统路由(如此处所述https://github.com/domaindrivendev/Swashbuckle.AspNetCore) . 我的所有路由都是使用routeBuilder.MapRoute()在一个函数内的代码中生成的 . 我有150个控制...
  • 0 votes
     answers
     views

    在ASP.Net Core中避免“请求匹配多个操作导致歧义”错误

    我正在尝试做一些简单而微不足道的事 - 或者至少我认为 . 我正在尝试编写一个可以由我启动的每个微服务项目继承的基类 . 这个基类的重点是测试从HTTP到SQL的连接 . 它未在PROD中启用 . 这是(更简单的)基类之一: public class DevTestControllerBase: ApiControllerBase { public DevTestControllerBas...
  • 2 votes
     answers
     views

    控制器中的多个HttpPost方法可防止swagger .json生成

    我在示例C#ASP.NET Core 2.0 Api中有一个Authors控制器,我使用Swashbuckle生成Swagger .json . 当我在AuthorsController中包含以下两个方法时,.json不会生成 [HttpPost(Name = "CreateAuthor")] public IActionResult CreateAuthor([Fr...
  • 1 votes
     answers
     views

    我在子文件夹上部署时出现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 votes
     answers
     views

    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 votes
     answers
     views

    swagger无法找到从ASP NET CORE项目中的程序集加载的控制器

    我有一个asp .net核心控制台项目,它使用ApplicationPart加载API程序集 . 我需要添加swagger以暴露API,但是当我将Swashbuckle安装到控制台项目并在启动类中配置Swagger时,如果我导航到swagger ui,则无法找到任何内容 . 它返回401错误 . 在ConfigureServices方法中: services.AddMvc .AddApplicat...
  • 1 votes
     answers
     views

    swagger codegen中的授权信息

    我开始使用Swagger为我的 REST APIs . 主要目标是从Swagger定义为Nancy endpoints 生成服务器文件 . 我下载了源代码并使用 api.moustache 文件将Nancy生成的文件修改为我的需要 . 一切正常但一方面:一些 endpoints 受到保护,而另一些 endpoints 则没有 . 在swagger格式的文档中,我发现每个 endpoints 都可...
  • 1 votes
     answers
     views

    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 votes
     answers
     views

    如何用Swagger Codegen排除某些操作/ HTTP动词?

    我正在使用带有AWS API Gateway的Swagger . 为了完全支持CORS,我的swagger文件中有几个OPTIONS方法;它们的存在只是为了告诉API网关返回CORS标头,以便我的Angular应用程序的预检请求成功 . 但是,当我使用Swagger codegen生成API时,所有这些OPTIONS方法都在我的服务中作为真正的方法出现 . 我不希望这种情况发生 . 如何告诉Swa...
  • 6 votes
     answers
     views

    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 votes
     answers
     views

    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 votes
     answers
     views

    为什么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 votes
     answers
     views

    如何从laravel服务?

    我正在尝试使用带有laravel的swagger来自动记录我们的RESTful API . 目标是在laravel控制器中保持swagger注释,然后swagger解析注释并生成相关的.json / .php文件 . 理想情况下,我希望laravel项目能够提供swagger文件,以便将所有内容保存在同一个引擎盖下并保持同步 . 为了实现这一点,我在laravel项目的根目录中创建了一个docs目...
  • 0 votes
     answers
     views

    我真的需要创建swagger.json和swagger.yaml才能将Swagger用于文档休息应用程序

    我花了一整天的时间按照Swagger的指导,基本上告知在添加了swagger依赖并部署/启动它后,我会根据Swagger注释(例如@Api)使用两个文件来描述我的休息服务 . 首先,目前尚不清楚这两个文件是在编译后还是在某个特定阶段(部署到服务器,任何特定的maven阶段或目标,或容器启动)时创建的 . 好吧,如果我能够完成并运行,这根本不是问题(请参阅我的困难I can't get swagge...

热门问题