2017-09-03 150 views
0

我正在检查出摇摆的节点。这似乎是基本的东西,所以我很难相信它是一个错误。

我使用swagger project create hello-world创建示例swagger hello world project,如swagger-node git页面上所示。

我使用一个$ref到具有相对路径的外部文件,但它无法打开文件。使用控制台我可以看到它尝试请求,但有一个404错误。这看起来swagger编辑器只能访问swagger.yaml文件,但没有别的。

的测试中,我引用的hello.yaml文件复制到项目的每一个文件夹,并仍然得到Reference could not be resolved: hello.yaml

swagger.yaml

swagger: "2.0" 
info: 
    version: "0.0.1" 
    title: Hello World App 
# during dev, should point to your local machine 
host: localhost:10010 
# basePath prefixes all resource paths 
basePath:/
# 
schemes: 
    # tip: remove http to make production-grade 
    - http 
    - https 
# format of bodies a client can send (Content-Type) 
consumes: 
    - application/json 
# format of the responses to the client (Accepts) 
produces: 
    - application/json 
paths: 
    /hello: 
    $ref: hello.yaml 
    /swagger: 
    x-swagger-pipe: swagger_raw 
# complex objects have schema definitions 
definitions: 
    HelloWorldResponse: 
    required: 
     - message 
    properties: 
     message: 
     type: string 
    ErrorResponse: 
    required: 
     - message 
    properties: 
     message: 
     type: string 

hello.yaml

# binds a127 app logic to a route 
x-swagger-router-controller: hello_world 
get: 
    description: Returns 'Hello' to the caller 
    # used as the method name of the controller 
    operationId: hello 
    parameters: 
    - name: name 
     in: query 
     description: The name of the person to whom to say hello 
     required: false 
     type: string 
    responses: 
    "200": 
     description: Success 
     schema: 
     # a pointer to a definition 
     $ref: "#/definitions/HelloWorldResponse" 
    # responses may fall through to errors 
    default: 
     description: Error 
     schema: 
     $ref: "#/definitions/ErrorResponse" 

回答

1

我遇到同样的问题,我发现这是一个招摇即是的编辑器错误。 请在Known Issues找到描述。 它会给出信息Relative path support for external files is not implemented.