swagger标签说明

x-ref-external可以为yaml里的数据结构指定一个已有的数据类，例如：

PageVO:
    x-ref-external: com.lee.PageVO
    properties:
      totalRows:
        type: string
        description: 总条数
      curPage:
        type: string
        description: 当前页
      pageSize:
        type: string
        description: 页大小

指定了x-ref-external的数据结构里的properties只是起到一个方便阅读的作用，并不会根据properties真的生成属性。
然后，注意在引用的时候要x-imports：

MyResponse:
    type: object
    properties:
      data:
        items:
          $ref: '#/definitions/DataInfo'
        description: 返回业务数据
        type: array
      code:
        type: string
        description: 错误码
      message:
        type: string
        description: 错误提示
      pageVO:
        description: 分页信息
        $ref: '#/definitions/PageVO'
    description: 查询响应类
    x-imports:
      - com.lee.PageVO