Swagger 2.0是否支持矩陣參數？

Question

Swagger 2.0是否支持JAX-RS規範的矩陣參數？

JAX-RS specification有Matrix-Parameter支持。

我的應用程序中有一些矩陣參數，例如/map/color;lat=50;long=20;scale=32000。 我想推導矩陣參數的招搖。我使用http://editor.wsagger.io;但我在編輯中找不到任何幫助。誰能幫我？

Swagger 2.0是否支持矩陣參數？

ralted以矩陣PARAM其他鏈接：

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

Answer 1

Swagger 2.0 spec沒有提及JAX-RS矩陣參數什麼。

同樣看着swagger-jaxrs的實現，你可以看到在the class中@MatrixParam被忽略，負責掃描JAX-RS參數註釋。

Answer 2

OpenAPI/Swagger 2.0不支持矩陣參數，但它們將在OpenAPI規範3.0中得到支持。

在OpenAPI的3.0，你的例子：

/map/color;lat=50;long=20;scale=32000 

可以定義爲：

/map/color{params}: 
    get: 
    parameters: 
     - in: path 
     name: params 
     required: true 

     # Named matrix parameters are defined as object properties 
     schema: 
      type: object 
      properties: 
      lat: 
       type: integer 
       example: 50 
      long: 
       type: integer 
       example: 20 
      scale: 
       type: integer 
       example: 32000 

     # Serialize this object as ;prop1=value2;prop2=value2 etc 
     style: matrix 
     explode: true