接口统一封装，让前端开发更轻松

在中大型项目中，接口数量众多，如果每个接口都单独管理，很容易导致代码混乱和难以维护。因此，我们需要对接口进行统一管理，以便于查找、调用和维护。

接口统一封装是一种将接口请求代码集中管理的方法。通过接口统一封装，我们可以将所有的接口请求代码放到一起，并对这些代码进行统一的管理和维护。这样，当我们需要调用某个接口时，只需要在统一封装的代码中找到对应的接口，然后调用即可。

接口统一封装可以带来许多好处，包括：

• 提高代码复用率。通过接口统一封装，我们可以将相同的接口请求代码复用在多个地方，从而减少代码冗余。
• 提高代码质量。通过接口统一封装，我们可以对接口请求代码进行统一的规范和管理，从而提高代码质量。
• 提高开发效率。通过接口统一封装，我们可以减少重复的代码编写工作，从而提高开发效率。
• 方便代码维护。通过接口统一封装，我们可以将所有的接口请求代码集中管理，从而方便代码维护。

接下来，我们介绍一下接口统一封装的思路和代码实现。

接口统一封装的思路

接口统一封装的思路很简单，就是将所有的接口请求代码放到一起，并对这些代码进行统一的管理和维护。我们可以创建一个接口封装类，将所有的接口请求代码都放到这个类中。然后，当我们需要调用某个接口时，只需要在接口封装类中找到对应的接口，然后调用即可。

接口统一封装的代码实现

以下是一个接口统一封装的代码示例：

public class ApiRequest {

    private String url;
    private String method;
    private Map<String, String> headers;
    private Map<String, String> params;
    private String body;

    public ApiRequest(String url, String method, Map<String, String> headers, Map<String, String> params, String body) {
        this.url = url;
        this.method = method;
        this.headers = headers;
        this.params = params;
        this.body = body;
    }

    public String getUrl() {
        return url;
    }

    public String getMethod() {
        return method;
    }

    public Map<String, String> getHeaders() {
        return headers;
    }

    public Map<String, String> getParams() {
        return params;
    }

    public String getBody() {
        return body;
    }

    public static ApiRequest get(String url) {
        return new ApiRequest(url, "GET", null, null, null);
    }

    public static ApiRequest post(String url) {
        return new ApiRequest(url, "POST", null, null, null);
    }

    public static ApiRequest put(String url) {
        return new ApiRequest(url, "PUT", null, null, null);
    }

    public static ApiRequest delete(String url) {
        return new ApiRequest(url, "DELETE", null, null, null);
    }

    public ApiRequest header(String key, String value) {
        if (headers == null) {
            headers = new HashMap<>();
        }
        headers.put(key, value);
        return this;
    }

    public ApiRequest param(String key, String value) {
        if (params == null) {
            params = new HashMap<>();
        }
        params.put(key, value);
        return this;
    }

    public ApiRequest body(String body) {
        this.body = body;
        return this;
    }

    public <T> T execute() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setRequestMethod(method);
            if (headers != null) {
                for (Map.Entry<String, String> entry : headers.entrySet()) {
                    connection.setRequestProperty(entry.getKey(), entry.getValue());
                }
            }
            if (params != null) {
                String paramString = params.entrySet().stream()
                        .map(entry -> entry.getKey() + "=" + entry.getValue())
                        .collect(Collectors.joining("&"));
                connection.setDoOutput(true);
                connection.getOutputStream().write(paramString.getBytes());
            }
            if (body != null) {
                connection.setDoOutput(true);
                connection.getOutputStream().write(body.getBytes());
            }
            int responseCode = connection.getResponseCode();
            if (responseCode >= 200 && responseCode < 300) {
                return (T) new ObjectMapper().readValue(connection.getInputStream(), Object.class);
            } else {
                throw new RuntimeException("请求失败，错误码：" + responseCode);
            }
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

}

这个接口封装类的使用非常简单，我们只需要创建一个ApiRequest对象，然后设置url、method、headers、params和body等属性，最后调用execute()方法即可。例如：

ApiRequest apiRequest = ApiRequest.get("https://example.com/api/v1/users")
        .header("Authorization", "Bearer 123456")
        .param("name", "John Doe")
        .param("email", "john.doe@example.com");

List<User> users = apiRequest.execute();

这段代码将向https://example.com/api/v1/users发送一个GET请求，并在请求头中设置Authorization字段为Bearer 123456，并在查询参数中设置name字段为John Doe和email字段为john.doe@example.com。然后，该代码将把从服务器返回的JSON数据解析为一个List对象。

接口统一封装可以帮助我们更轻松地管理和使用后端接口，从而提高开发效率和代码质量。在中大型项目中，强烈建议使用接口统一封装来管理接口请求代码。