一、JSON接口调用前的准备工作

1.1 权限配置与网络库选择

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

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

现代Android开发推荐使用以下网络库：

• OkHttp：轻量级HTTP客户端，支持同步/异步请求
• Retrofit：基于OkHttp的声明式API库，简化接口调用
• Volley：Google官方库，适合简单请求场景

1.2 接口文档分析要点

正式开发前需确认：

• 请求方法（GET/POST/PUT/DELETE）
• 请求URL及参数格式（路径参数/查询参数/请求体）
• 响应数据结构（字段类型、嵌套层级）
• 认证方式（API Key/OAuth/JWT）
• 错误码定义（400/401/500等场景处理）

二、JSON接口调用实现方案

2.1 使用OkHttp实现基础调用

// 创建OkHttpClient实例
OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .readTimeout(10, TimeUnit.SECONDS)
    .build();
// 构建请求体（POST示例）
RequestBody requestBody = RequestBody.create(
    MediaType.parse("application/json"),
    "{\"username\":\"test\",\"password\":\"123456\"}"
);
// 创建请求对象
Request request = new Request.Builder()
    .url("https://api.example.com/login")
    .post(requestBody)
    .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 responseData = response.body().string();
            // 处理响应数据
        }
    }
});

2.2 使用Retrofit优化调用流程

2.2.1 定义API接口

public interface ApiService {
    @POST("user/login")
    Call<LoginResponse> login(@Body LoginRequest request);
    @GET("user/profile/{userId}")
    Call<UserProfile> getProfile(@Path("userId") String userId);
}

2.2.2 创建Retrofit实例

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .client(okHttpClient) // 可复用OkHttp实例
    .build();
ApiService apiService = retrofit.create(ApiService.class);

2.2.3 执行请求并处理响应

LoginRequest request = new LoginRequest("test", "123456");
apiService.login(request).enqueue(new Callback<LoginResponse>() {
    @Override
    public void onResponse(Call<LoginResponse> call, Response<LoginResponse> response) {
        if (response.isSuccessful()) {
            LoginResponse loginResponse = response.body();
            // 处理登录成功逻辑
        } else {
            // 处理业务错误（如401未授权）
        }
    }
    @Override
    public void onFailure(Call<LoginResponse> call, Throwable t) {
        // 处理网络错误
    }
});

2.3 JSON数据解析方案

2.3.1 原生JSONObject解析

try {
    JSONObject jsonObject = new JSONObject(responseString);
    String token = jsonObject.getString("token");
    int userId = jsonObject.getInt("user_id");
} catch (JSONException e) {
    e.printStackTrace();
}

2.3.2 Gson库解析（推荐）

定义数据模型类：

public class User {
    @SerializedName("user_id")
    private int id;
    private String name;
    private String email;
    // getters & setters
}

解析代码：

Gson gson = new Gson();
User user = gson.fromJson(jsonString, User.class);

三、JSON接口测试方法论

3.1 单元测试实现

使用Mockito模拟网络响应：

@Test
public void testLoginSuccess() {
    // 模拟Retrofit响应
    LoginResponse mockResponse = new LoginResponse("token123", 1);
    when(apiService.login(any(LoginRequest.class)))
        .thenReturn(Response.success(mockResponse));
    // 执行测试
    LoginRequest request = new LoginRequest("test", "123456");
    Call<LoginResponse> call = apiService.login(request);
    // 验证结果
    assertEquals(200, call.execute().code());
    assertEquals("token123", call.execute().body().getToken());
}

3.2 接口测试工具推荐

• Postman：可视化测试工具，支持环境变量管理
• Charles Proxy：网络抓包工具，可修改请求/响应
• MockServer：本地模拟API服务，支持动态响应

3.3 自动化测试方案

3.3.1 Espresso UI测试集成

@Test
public void testLoginFlow() {
    // 模拟成功的API响应
    mockWebServer.enqueue(new MockResponse()
        .setResponseCode(200)
        .setBody("{\"token\":\"test_token\"}"));
    // 执行UI操作
    onView(withId(R.id.et_username)).perform(typeText("test"));
    onView(withId(R.id.et_password)).perform(typeText("123456"));
    onView(withId(R.id.btn_login)).perform(click());
    // 验证结果
    onView(withText("登录成功")).check(matches(isDisplayed()));
}

3.3.2 接口测试用例设计

测试场景	输入数据	预期结果
正常登录	有效账号密码	返回200及token
密码错误	有效账号错误密码	返回401错误
参数缺失	缺少用户名	返回400错误
网络超时	模拟无网络	捕获SocketTimeoutException

四、常见问题解决方案

4.1 网络请求失败处理

// 添加重试机制
OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
            Request request = chain.request();
            Response response = null;
            int retryCount = 0;
            while (retryCount < MAX_RETRY && 
                  (response == null || !response.isSuccessful())) {
                response = chain.proceed(request);
                retryCount++;
            }
            return response;
        }
    })
    .build();

4.2 JSON解析异常处理

try {
    User user = gson.fromJson(jsonString, User.class);
} catch (JsonSyntaxException e) {
    Log.e("JSON_PARSE", "字段类型不匹配: " + e.getMessage());
} catch (IllegalStateException e) {
    Log.e("JSON_PARSE", "JSON结构错误: " + e.getMessage());
}

4.3 线程切换最佳实践

// 主线程发起请求
new Thread(() -> {
    try {
        String result = apiService.getData().execute().body().string();
        // 切换到主线程更新UI
        runOnUiThread(() -> {
            textView.setText(result);
        });
    } catch (IOException e) {
        e.printStackTrace();
    }
}).start();
// 或使用Retrofit的enqueue自动线程切换
apiService.getData().enqueue(new Callback<String>() {
    @Override
    public void onResponse(Call<String> call, Response<String> response) {
        // 自动在主线程执行
        textView.setText(response.body());
    }
});

五、性能优化建议

1. 连接池复用：配置OkHttp的connectionPool
2. 缓存策略：实现Cache-Control和Etag机制
3. 数据压缩：启用Gzip压缩
4. 请求合并：批量接口调用减少网络开销
5. ProGuard混淆：保护接口URL和模型类

六、安全注意事项

1. 敏感数据传输使用HTTPS
2. 避免在日志中打印完整响应
3. 实现接口签名验证
4. 设置合理的请求超时时间
5. 对用户输入进行校验过滤

通过系统掌握上述技术要点，开发者可以构建出稳定、高效的JSON接口调用模块。建议结合实际项目需求，从简单场景入手逐步实现复杂功能，同时重视测试环节确保接口可靠性。