Android网络编程全解析：从HttpURLConnection到Retrofit2

1. Android网络编程实战：从基础到高阶框架全解析

作为一名在Android开发领域深耕多年的工程师，我深知网络请求是移动应用开发中最基础也最关键的技能之一。今天我将通过一个完整的项目案例，带大家从最底层的HttpURLConnection开始，逐步深入到OkHttp和Retrofit2等流行框架，同时详细讲解JSON数据处理的各种技巧。

这个教程特别适合有一定Android基础但想系统学习网络编程的开发者。我们将围绕用户信息查询（GET）和登录（POST）这两个典型场景，使用同一组API接口进行演示，这样你能更清晰地看到不同技术方案之间的差异和演进。

2. 网络协议基础：理解HTTP请求的底层原理

2.1 为什么需要了解网络协议

很多新手开发者容易陷入一个误区：认为网络请求就是简单地调用API发送数据。但实际上，理解底层协议对于调试网络问题、优化请求性能至关重要。我曾遇到过这样一个案例：一个看似简单的接口调用在弱网环境下频繁失败，最终发现是因为没有正确设置TCP超时参数。

网络协议本质上是一套通信规则，它规定了数据如何打包、传输、校验以及连接如何建立和关闭。在Android开发中，我们主要工作在应用层，但必须了解下层协议的工作机制。

2.2 TCP/IP模型详解

实际开发中最常用的是TCP/IP四层模型：

1. 网络接口层：负责物理传输，如Wi-Fi、4G等
2. 网络层：IP协议负责寻址和路由
3. 传输层：TCP/UDP协议保证数据传输
4. 应用层：HTTP、FTP等应用协议

对于移动开发者来说，最重要的是理解传输层和应用层的关系。当我们在代码中创建一个HTTP请求时，实际上是应用层协议在驱动下层的TCP连接。

2.3 TCP连接的生命周期

2.3.1 三次握手建立连接

TCP通过三次握手确保双方都能正常通信：

1. 客户端发送SYN包（同步序列编号）
2. 服务端回应SYN-ACK包
3. 客户端发送ACK确认

这个过程的超时设置会直接影响连接建立的效率。在OkHttp中，我们可以通过.connectTimeout()方法来配置。

2.3.2 四次挥手断开连接

连接终止时的四次挥手：

1. 主动方发送FIN包
2. 被动方回应ACK
3. 被动方发送FIN包
4. 主动方回应ACK

在代码中，我们必须确保及时关闭连接，否则会导致资源泄漏。HttpURLConnection的disconnect()方法就是用于此目的。

2.4 HTTP协议详解

2.4.1 请求方法

最常用的两种方法：

• GET：获取资源，参数在URL中
• POST：提交数据，参数在请求体中

2.4.2 请求结构

一个完整的HTTP请求包含：

• 请求行（方法、路径、协议版本）
• 请求头（Content-Type、Authorization等）
• 请求体（POST数据）

2.4.3 响应结构

HTTP响应包含：

• 状态行（状态码和描述）
• 响应头
• 响应体（通常是JSON数据）

3. Android网络请求基础配置

3.1 权限和配置

在AndroidManifest.xml中添加网络权限：

xml复制<uses-permission android:name="android.permission.INTERNET"/>

对于HTTP明文请求，需要配置网络安全策略：

xml复制<application
    android:usesCleartextTraffic="true">
</application>

或者为特定域名配置：

xml复制<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">yourdomain.com</domain>
    </domain-config>
</network-security-config>

4. HttpURLConnection实战

4.1 GET请求实现

java复制private void sendGetRequest() {
    new Thread(() -> {
        try {
            URL url = new URL("http://example.com/api?param=value");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");
            conn.setConnectTimeout(8000);
            
            InputStream in = conn.getInputStream();
            BufferedReader reader = new BufferedReader(new InputStreamReader(in));
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            
            runOnUiThread(() -> {
                // 更新UI
            });
            
            conn.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }).start();
}

关键点：

1. 必须在子线程中执行网络请求
2. 设置合理的超时时间
3. 记得关闭连接和流
4. 使用runOnUiThread更新UI

4.2 POST请求实现

java复制private void sendPostRequest() {
    new Thread(() -> {
        try {
            URL url = new URL("http://example.com/api/login");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setDoOutput(true);
            conn.setRequestProperty("Content-Type", "application/json");
            
            String jsonBody = "{\"username\":\"test\",\"password\":\"123\"}";
            OutputStream os = conn.getOutputStream();
            os.write(jsonBody.getBytes());
            os.flush();
            
            // 处理响应...
            
            conn.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }).start();
}

注意事项：

1. setDoOutput(true)表示要写入请求体
2. 必须设置正确的Content-Type
3. 记得flush和关闭输出流

5. JSON数据处理

5.1 使用JSONObject

创建JSON：

java复制JSONObject json = new JSONObject();
json.put("name", "张三");
json.put("age", 25);

JSONArray hobbies = new JSONArray();
hobbies.put("篮球");
hobbies.put("音乐");

json.put("hobbies", hobbies);

解析JSON：

java复制String jsonStr = "{\"name\":\"张三\",\"age\":25}";
JSONObject json = new JSONObject(jsonStr);
String name = json.getString("name");
int age = json.getInt("age");

5.2 使用Gson

添加依赖：

gradle复制implementation 'com.google.code.gson:gson:2.8.9'

对象转JSON：

java复制User user = new User("张三", 25);
Gson gson = new Gson();
String json = gson.toJson(user);

JSON转对象：

java复制String json = "{\"name\":\"张三\",\"age\":25}";
User user = gson.fromJson(json, User.class);

6. OkHttp实战

6.1 添加依赖

gradle复制implementation 'com.squareup.okhttp3:okhttp:4.9.3'

6.2 GET请求

java复制OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
    .url("http://example.com/api")
    .build();

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        // 处理失败
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (response.isSuccessful()) {
            String json = response.body().string();
            // 处理响应
        }
    }
});

6.3 POST请求

java复制MediaType JSON = MediaType.get("application/json; charset=utf-8");
String jsonBody = "{\"username\":\"test\"}";
RequestBody body = RequestBody.create(jsonBody, JSON);

Request request = new Request.Builder()
    .url("http://example.com/api")
    .post(body)
    .build();

client.newCall(request).enqueue(...);

6.4 拦截器应用

添加日志拦截器：

java复制HttpLoggingInterceptor logging = new HttpLoggingInterceptor();
logging.setLevel(HttpLoggingInterceptor.Level.BODY);

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(logging)
    .build();

自定义拦截器：

java复制class AuthInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request original = chain.request();
        Request request = original.newBuilder()
            .header("Authorization", "Bearer token")
            .build();
        return chain.proceed(request);
    }
}

7. Retrofit2实战

7.1 添加依赖

gradle复制implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

7.2 定义API接口

java复制public interface ApiService {
    @GET("user/info")
    Call<User> getUserInfo(@Query("user_id") int userId);
    
    @POST("user/login")
    Call<LoginResponse> login(@Body LoginRequest request);
}

7.3 创建Retrofit实例

java复制Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("http://example.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build();

ApiService api = retrofit.create(ApiService.class);

7.4 发起请求

java复制api.getUserInfo(123).enqueue(new Callback<User>() {
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful()) {
            User user = response.body();
            // 处理用户数据
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // 处理错误
    }
});

8. 文件上传下载

8.1 文件上传

使用OkHttp：

java复制File file = new File(path);
RequestBody fileBody = RequestBody.create(file, MediaType.parse("image/*"));
RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.getName(), fileBody)
    .build();

Request request = new Request.Builder()
    .url(url)
    .post(body)
    .build();

使用Retrofit：

java复制@Multipart
@POST("upload")
Call<ResponseBody> uploadFile(@Part MultipartBody.Part file);

8.2 文件下载

使用OkHttp：

java复制Request request = new Request.Builder().url(url).build();
client.newCall(request).enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) throws IOException {
        try (InputStream is = response.body().byteStream();
             FileOutputStream fos = new FileOutputStream(file)) {
            byte[] buf = new byte[8192];
            int len;
            while ((len = is.read(buf)) > 0) {
                fos.write(buf, 0, len);
            }
        }
    }
});

9. 最佳实践与性能优化

1. 使用连接池：OkHttp默认已经实现了连接池，可以复用TCP连接
2. 合理设置超时：

   java复制new OkHttpClient.Builder()
       .connectTimeout(10, TimeUnit.SECONDS)
       .readTimeout(30, TimeUnit.SECONDS)
       .writeTimeout(30, TimeUnit.SECONDS)
   

3. 缓存策略：配置缓存减少网络请求

   java复制Cache cache = new Cache(cacheDir, cacheSize);
   client.cache(cache);
   

4. 请求优先级：重要请求可以设置更高的优先级
5. 压缩请求：使用gzip压缩减少传输数据量

10. 常见问题排查

1. 主线程网络请求：确保网络请求在子线程执行
2. HTTPS证书问题：配置自定义TrustManager处理自签名证书
3. JSON解析错误：确保模型类字段与JSON键名匹配
4. 内存泄漏：注意取消未完成的请求，特别是在Activity销毁时
5. ANR问题：设置合理的超时时间，避免长时间阻塞

11. 技术选型建议

1. 简单请求：直接使用HttpURLConnection
2. 中等复杂度项目：OkHttp + Gson
3. 大型项目：Retrofit2 + OkHttp + Gson
4. 特殊需求：
   • 需要更灵活的数据处理：考虑Moshi
   • 需要更高效的序列化：考虑Protobuf

在实际项目中，我通常会根据以下因素选择技术方案：

• 项目规模和复杂度
• 团队熟悉程度
• 性能要求
• 维护成本

从个人经验来看，Retrofit2+OkHttp的组合在大多数场景下都是最佳选择，它提供了良好的抽象和扩展性，同时保持了足够的灵活性。