非SpringBoot的Azure Java Functions生成Swagger UI方法咨询

因为你没用到SpringBoot，没法直接用SpringDoc这类自动生成工具，推荐两种可行方案：

方案一：手动编写OpenAPI规范后生成UI #

这是最直接的方式，步骤如下：

• 编写符合OpenAPI 3.0/2.0规范的YAML或JSON文件，定义所有函数接口（包括容器复制、生成SAS令牌等）
• 将规范导入Swagger Editor，编辑器会自动生成对应的Swagger UI界面
• 可以把生成的UI部署到静态服务，或者直接用Swagger Editor的预览功能供团队使用

方案二：用swagger-core注解生成规范文件 #

如果不想手动写规范，可用swagger-core库给Java函数代码加注解自动生成OpenAPI规范：

• 在Azure Functions项目中引入swagger-core相关依赖（比如io.swagger.core.v3:swagger-core、io.swagger.core.v3:swagger-annotations）
• 在HTTP触发器方法上添加OpenAPI注解，比如@Operation定义接口描述，@Parameter定义参数，@ApiResponse定义响应
• 编写额外的HTTP函数，用来暴露生成的OpenAPI规范文件（返回JSON格式内容）
• 把规范文件导入Swagger Editor生成UI

针对你提供的http://functionappname.net/api/functionname?file=filename接口，按以下步骤操作：

1. 打开Swagger Editor后清空默认示例内容
2. 粘贴以下OpenAPI 3.0 YAML规范（可根据实际功能修改描述、响应等）：

openapi: 3.0.0
info:
  title: Azure Java Functions API
  version: 1.0.0
servers:
  - url: http://functionappname.net/api
paths:
  /functionname:
    get:
      summary: 你的接口功能描述（比如"Blob容器间文件复制/生成SAS令牌"）
      parameters:
        - name: file
          in: query
          required: true
          description: 目标文件名
          schema:
            type: string
      responses:
        '200':
          description: 操作成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: string
                    description: 操作结果（例如SAS令牌或复制成功提示）
        '400':
          description: 参数错误
        '500':
          description: 服务器内部错误

3. 编辑器会实时在右侧生成Swagger UI预览，可点击"Try it out"按钮测试接口
4. 若需添加其他函数接口，直接在paths节点下新增对应路由定义即可

内容的提问来源于stack exchange，提问作者Venkatesh