Swagger 多文件配置：引用 JSON 文件及其他格式配置

对于 Swagger 多文件配置，可以使用 $ref 关键字来引用其他的 JSON 文件。例如，假设有一个 user.json 文件：

{
  'type': 'object',
  'properties': {
    'id': {
      'type': 'integer'
    },
    'name': {
      'type': 'string'
    }
  }
}

然后可以在另一个主文件中使用 $ref 引用该文件：

{
  'swagger': '2.0',
  'info': {
    'title': 'My API',
    'version': '1.0.0'
  },
  'paths': {
    '/users': {
      'get': {
        'summary': 'Get a list of users',
        'responses': {
          '200': {
            'description': 'OK',
            'schema': {
              '$ref': 'user.json'
            }
          }
        }
      }
    }
  }
}

这样，Swagger 会自动读取 user.json 文件，并将其内容作为响应的 schema。

其他配置文件格式

对于其他配置文件格式，Swagger 支持多种格式，包括 YAML、XML 等。具体使用哪种格式取决于个人喜好和项目需求。在主文件中使用 $ref 引用其他文件时，只需指定文件的路径和文件名即可。例如：

{
  '$ref': 'definitions.yaml#/User'
}

被引用的 JSON 文件内容

被引用的文件通常包含一些定义，例如 Swagger 的 definitions、parameters、responses 等。这些定义可以在主文件中被引用，并在 API 的路径和操作中使用。被引用的文件可以是 JSON、YAML 或 XML 格式的，具体使用哪种格式取决于个人喜好和项目需求。在被引用的文件中，可以定义多个对象或参数，这些定义可以在主文件中被引用和组合使用，从而实现更加灵活和可维护的 API 设计。

以下是一个简单的被引用的 JSON 文件示例：

{
  'definitions': {
    'User': {
      'type': 'object',
      'properties': {
        'id': {
          'type': 'integer'
        },
        'name': {
          'type': 'string'
        }
      }
    }
  }
}

该文件定义了一个 User 对象，包括 id 和 name 两个属性。在主文件中使用 $ref 引用时，可以指定该文件的路径和文件名，例如：

{
  'swagger': '2.0',
  'info': {
    'title': 'My API',
    'version': '1.0.0'
  },
  'paths': {
    '/users': {
      'get': {
        'summary': 'Get a list of users',
        'responses': {
          '200': {
            'description': 'OK',
            'schema': {
              '$ref': 'user.json#/definitions/User'
            }
          }
        }
      }
    }
  }
}

这里使用了 user.json 文件中定义的 User 对象作为响应的 schema。注意，在 $ref 中需要指定被引用对象的路径，以及该对象在文件中的名称。