小编Hel*_*len的帖子

Swagger 2.0是否支持JAX-RS规范的矩阵参数？

JAX-RS 规范有矩阵参数支持。

我的应用程序中存在一些矩阵参数，例如/map/color;lat=50;long=20;scale=32000. 我想为矩阵参数导出 Swagger。我使用http://editor.swagger.io；但我无法在编辑器中得到任何帮助。谁能帮我？

Swagger 2.0支持矩阵参数吗？

与矩阵参数相关的其他链接：

• https://www.w3.org/DesignIssues/MatrixURIs.html
• https://www.safaribooksonline.com/library/view/restful-java-with/9780596809300/ch05s03.html

我想在我的API描述中放一个Markdown代码块，但是Swagger UI似乎正在读取，好像它是一个单行代码片段一样。我目前有：

description: |
    This API was created to allow interaction with the Image Status Database (ISD)

    ## Requests

    ## Responses
    In the case of a successful response, you will always receive a `data` key
    that contains your data.
    ```
    {
        "meta": {
            "code": 200
        },
        "data": {
            ...
        },
        "pagination": {
            "next_url": "...",
            "next_max_id": "13872296"
        }
    }
    ```

显示为：

但是，Swagger编辑器显示正确的代码块：

Swagger UI不支持此功能吗？

我正在使用 Swagger Codegen 3.0.19，还尝试了 OpenAPI Generator 4.0.3。

Java环境：

Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

跑步者：

java -jar ./libs/openapi-generator-cli-4.3.0.jar  generate \
       -i pet.yaml \
       -g spring \
       -o ./OUTPUT/api/

这是我的 OpenAPI 架构：

Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

输出是：

java -jar ./libs/openapi-generator-cli-4.3.0.jar  generate \
       -i pet.yaml \
       -g spring \
       -o ./OUTPUT/api/

为什么代码生成器将 ON/OFF 枚举转换为 TRUE/FALSE？当我使用 Swagger Editor GUI 生成时，它不会执行此操作。

我的招摇方案中有一个枚举，如下所示：

- name: shipmentType
      in: query
      required: false
      type: integer
      format: int32
      enum:
        - 0
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6

使用 swagger codegen (2.4.17) 生成 typescript-Angular 客户端后，生成的枚举如下图所示：

有没有办法让生成器使用打字稿枚举类型而不是创建自定义对象？

我正在尝试实现一个简单的IEqulityComparer以与LINQ集合一起使用。我编写了以下代码，出于讨论目的，这些代码简化为最简单的形式...

Public Structure bob
    Dim SiteID As Integer
    Dim fred As String
End Structure

Public Class insCompare
    Implements System.Collections.Generic.IEqualityComparer(Of bob)

    Public Function Equals(ByVal x As bob, ByVal y As bob) As Boolean
        Return IIf(x.SiteID = y.SiteID, True, False)

    End Function

    Public Function GetHashCode(ByVal x As bob) As Integer
        Return x.SiteID.GetHashCode()

    End Function

End Class

我的问题是两个函数都抛出编译器警告“函数'getHashCode'（或'Equals'）在基类'Object'中遮盖了可覆盖的方法。要覆盖基类方法，必须将该方法声明为'Overrides '。”

但是，如果我将它们声明为Overrides，则会出现错误“函数'GetHashCode'无法声明为Overrides，因为它没有覆盖基类中的函数。”！

我还在“ Implements”行上收到编译器错误，以至于我必须实现“ getHashCode”，但我认为这是第一个问题的结果。

我所有的研究都表明我应该没事-有人知道了吗？

在哪里可以找到Windows XP/Vista/7中使用的所有系统图标？可能吗？

我尝试使用SHGetStockIconInfo(),但它只返回一些图标.

流行的漫画xkcd提出了将时间完成转换为日期的等式:

我一直试图在JavaScript中做同样的事情,尽管我一直在努力-Infinity.这是代码:

var p = 5; // Percent Complete 
var today = new Date(); 
today = today.getTime(); 
var t;
t = (today) - (Math.pow(Math.E, (20.3444 * Math.pow(p,3))) -
Math.pow(Math.E,3));
document.write(t + " years");

时间将返回一个巨大的数字(毫秒),我知道这个等式并不意味着处理毫秒 - 那么如何使用JavaScript进行高级日期等式？

我正在尝试为此multipart/form-data请求创建 OpenAPI 定义：

curl -X POST \
  http://localhost:1234/api/v1/Submit \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'sessionkey: kjYgfORsZ0GeiCls0FcR7w==' \
  -F item1=abc \
  -F item2=def
  -F item3=ghi
  ...

我的API定义是这样的：

curl -X POST \
  http://localhost:1234/api/v1/Submit \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'sessionkey: kjYgfORsZ0GeiCls0FcR7w==' \
  -F item1=abc \
  -F item2=def
  -F item3=ghi
  ...

它适用于 formData 中的固定字段。

但是，我的表单数据将是动态的，我需要能够发送任意键和值。

我尝试更改表单参数以使用数组 and additionalProperties，但它没有产生所需的结果：

post:
  consumes:
    - multipart/form-data
  produces:
    - application/json
  parameters:
    - in: formData
      name: …

如何pattern使用 Swagger Node.js 注释正确定义以下正则表达式？

 *       reviews_ratings_description:\n *         type: string\n *         minimum: 10\n *         maximum: 50\n *         pattern: "^[ a-zA-Z0-9](?!,.*?[^\\na-zA-Z0-9!\xe2\x80\x9d$%&~^&#<>.?:"\'\xe2\x80\x99=@()*\\+,\\/;\\[\\\\\\]\\-^_`{|}~]{1}).*?[a-zA-Z0-9!\xe2\x80\x9d$%&~^&#<>.?:"\'\xe2\x80\x99=@()*\\+,\\/;\\\\\\\\]\\-^_`{|}~]$"    \n

运行上面的代码会产生以下错误：

{"error":{},"level":"error","message":"uncaughtException: YAMLException: can not read an implicit mapping pair; a colon is missed at line 42, column 159:\\n     ... \\"\'\xe2\x80\x99=@()*\\\\+,\\\\/;\\\\[\\\\\\\\\\\\]\\\\-^_`{|}~]$\'\\n\n

字符串是否pattern需要以某种方式转义？

我注意到在 Swagger UI v3 和 OAS3 中，我们现在支持称为“链接”的东西

但我真的不知道是否可以将这个功能与 Swashbuckle 一起使用，如果是……那么如何？一直在网上搜索，并没有找到任何关于这个的东西..

任何人都能够使用与 Swashbuckle 的链接？