@ApiOperation指定顺序展示

`@ApiOperation` 是 Springfox 的 Swagger 库中用于标记 API 接口的注解。它允许开发者自定义 API 的文档信息，例如描述、响应状态码等。通过 `@ApiOperation` 注解，可以使得 API 文档按照指定的方式进行展示。

### 使用示例：

import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class MyController {

    /**
     * 示例方法，演示如何使用 @ApiOperation 指定顺序展示。
     */
    @GetMapping("/example")
    @ApiOperation("这是一个示例API", value = "这是一个简单的API说明，展示了如何通过@ApiOperation注解定制API文档。", notes = "请注意，这个API是为了演示目的而创建的，并非实际功能的一部分。",
            response = String.class,
            tags = {"Example Tag"})
    public String getExample() {
        return "这是一个返回字符串的例子";
    }
}

在这个例子中：

- **value** 属性指定了 API 名称的主标题。
- **notes** 属性提供了关于此 API 功能更详细的解释文本。
- **response** 属性指定了 API 返回的数据类型。
- **tags** 属性将 API 分组到特定的主题下，有助于组织和查找 API。

### `@ApiOperation` 的重要性：

1. **提高易读性和理解度**：通过清晰地描述每个 API 的作用和预期行为，可以让消费者更容易理解和使用 API。

2. **增强文档质量**：提供丰富的 API 描述，包括输入输出参数的详细信息、响应状态码及其含义、以及可能的异常情况等，帮助开发者了解 API 的工作原理并正确使用。

3. **简化集成过程**：良好的 API 文档能加速下游系统的集成工作，减少误解和错误的实现。

4. **促进团队协作**：明确的 API 文档对于分布式团队协作尤为重要，因为它可以帮助团队成员快速上手新加入的模块或功能。

###