如何在Spring Boot Actuator中基于请求参数获取指标

以下是针对该接口的核心实现要点和使用说明：

• 请求规范

  • 采用GET请求方式，接口地址：/v1/api/location
  • 必填查询参数：country，需传入ISO 3166-1 alpha-2标准的国家代码（例如IN代表印度，US代表美国）

• 参数校验逻辑

  • 首先检查请求中是否携带country参数，若缺失直接返回400 Bad Request，响应信息："error": "country参数为必填项"
  • 校验country参数格式是否符合2位大写字母的标准，不符合则返回400 Bad Request，响应信息："error": "请输入有效的ISO 3166-1 alpha-2国家代码"

• 数据返回逻辑

  • 根据合法的country代码，从数据源（数据库、缓存或内部数据服务）中检索对应国家的指标数据
  • 成功获取数据时，返回200 OK，以JSON格式返回指标内容，示例响应：

    {
      "country_code": "US",
      "indicators": {
        "total_population": 334914895,
        "annual_gdp": 26854590,
        "urbanization_rate": 82
      }
    }
    

  • 若未找到对应国家的指标数据，返回404 Not Found，响应信息："error": "未查询到该国家的指标信息"

• 异常处理

  • 若服务器在处理请求时出现内部错误（如数据库连接失败），返回500 Internal Server Error，响应信息："error": "服务器内部错误，请稍后重试"

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