安卓封装okhttp

### 封装 OkHttp 的最佳实践 为了简化 Android 应用中的网络请求操作，可以创建一个通用的 `OkHttpClient` 实例并封装常用的请求方法。这不仅提高了代码的可维护性和重用率，还使得错误处理更加集中化。 #### 创建全局 OkHttpClient 单例实例 通过定义一个应用程序级别的类来保存单例模式下的 `OkHttpClient` 对象，可以在整个应用生命周期内重复利用这个对象而无需每次都重新初始化它[^3]： ```java // MyApp.java package com.example.myapp; import android.app.Application; import okhttp3.OkHttpClient; public class MyApp extends Application { private static OkHttpClient okHttpClient; @Override public void onCreate() { super.onCreate(); // 初始化 OkHttpClient 并设置默认配置项 okHttpClient = new OkHttpClient.Builder() .connectTimeout(15, java.util.concurrent.TimeUnit.SECONDS) .readTimeout(15, java.util.concurrent.TimeUnit.SECONDS) .writeTimeout(15, java.util.concurrent.TimeUnit.SECONDS) .build(); } public static OkHttpClient getOkHttpClient(){ return okHttpClient; } } ``` #### 构建统一接口服务层 接着构建一个用于发起各种类型的 HTTP 请求的服务类，比如 GET 和 POST 方法。这里展示了一个简单的实现方式，其中包含了同步和异步两种调用形式[^1]： ```java // HttpService.java package com.example.myapp.network; import android.os.AsyncTask; import androidx.annotation.NonNull; import okhttp3.Call; import okhttp3.Callback; import okhttp3.Request; import okhttp3.Response; import org.json.JSONObject; import java.io.IOException; public final class HttpService { /** * 发起GET请求 (异步) */ public static void doGetAsync(@NonNull String url, Callback callback){ Request request = new Request.Builder().url(url).build(); Call call = MyApp.getOkHttpClient().newCall(request); call.enqueue(callback); // 异步执行 } /** * 发起POST请求 (带JSON参数) (异步) */ public static void doPostJsonAsync(@NonNull String url, JSONObject jsonParams, Callback callback)throws Exception{ // ... 设置RequestBody ... // 使用jsonParams构建post body... RequestBody requestBody = RequestBody.create( MediaType.parse("application/json; charset=utf-8"), jsonParams.toString()); Request request = new Request.Builder() .url(url) .post(requestBody) .build(); Call call = MyApp.getOkHttpClient().newCall(request); call.enqueue(callback); // 异步执行 } /** * 同步获取数据的方法可用于某些特定场景下， * 如在子线程中直接阻塞等待响应结果而不影响主线程体验。 */ public static Response doGetSync(String url) throws IOException { Request request = new Request.Builder().url(url).build(); try(Response response = MyApp.getOkHttpClient().newCall(request).execute()){ if (!response.isSuccessful()) throw new RuntimeException("Unexpected code " + response); return response; } } // 更多其他HTTP动词的支持... } ``` 上述代码片段展示了如何基于 OkHttp 进行基本功能的封装，包括但不限于发送 GET/POST 请求以及处理相应的回调逻辑。对于更复杂的应用需求，则可以根据实际情况进一步扩展此框架的功能集。 #### 错误与异常处理机制设计 考虑到网络环境不稳定等因素，在封装过程中应当充分考虑可能出现的各种异常情况，并提供合理的反馈给上层业务模块。通常做法是在每个 API 调用处捕获可能发生的 IO 或者解析失败等问题，并将其转换成易于理解的消息传递出去[^2]。 例如，在上面的例子中可以通过自定义 `Callback` 接口的方式向外部暴露成功与否的状态信息；而在同步版本里则可以直接抛出受检异常让调用方自行决定后续动作。 ---