Goswagger 没有创建适当的 json 规范文件

Question

我正在尝试为 go implementation of petstore example 创建规范文件.我在包含 doc.go 的目录中尝试了 go generate 但它什么也没做。在进一步阅读时，我意识到应该有

//go:generate swagger generate spec -o swagger.json

在 doc.go 中。当我添加它时，它会创建一个规范文件，但它不包含整个规范。这是在 go generate

上创建的 .json 文件

{
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "schemes": [
    "http",
    "https"
  ],
  "swagger": "2.0",
  "info": {
    "description": "the purpose of this application is to provide an application\nthat is using plain go code to define an API\n\nThis should demonstrate all the possible comment annotations\nthat are available to turn go code into a fully compliant swagger 2.0 spec",
    "title": "Petstore API.",
    "termsOfService": "there are no TOS at this moment, use at your own risk we take no responsibility\ngo:generate swagger generate spec -o swagger.json",
    "contact": {
      "name": "John Doe",
      "url": "http://john.doe.com",
      "email": "john.doe@example.com"
    },
    "license": {
      "name": "MIT",
      "url": "http://opensource.org/licenses/MIT"
    },
    "version": "0.0.1"
  },
  "host": "localhost",
  "basePath": "/v2",
  "paths": {}
}

规范文件中没有提到任何路由/参数/模型。这应该是这样吗？这是来自 goswagger repo 的官方示例，所以我怀疑代码有误。我应该更改什么才能使其正常工作？

Answer 1

您要记录的代码需要可以从您的主包访问。这意味着需要从主包中检测到它的使用情况。因此，如果您有一个未通过某种反射方式连接的工作服务器，它将生成正确的规范。