### 使用 `FormBody.Builder()` 发送 POST 请求 在 Android 中使用 OkHttp 库发送带有表单数据的 POST 请求时，`FormBody.Builder()` 是一种常用的方法来构建请求体。下面是一个完整的例子展示如何利用 `FormBody.Builder()` 构建并发送包含用户名和密码字段的登录请求。 #### 创建 OkHttpClient 实例 首先需要创建一个 OkHttpClient 的实例，这个客户端负责管理所有的 HTTP 连接操作： ```java OkHttpClient client = new OkHttpClient(); ``` #### 构造 FormBody 并添加参数 接着通过 `FormBody.Builder()` 来构造表单形式的请求体，并向其中加入必要的键值对作为参数： ```java FormBody formBody = new FormBody.Builder() .add("username", "exampleUser") // 添加用户名 .add("password", "securePassword") // 添加密码 .build(); ``` 此处 `.add()` 方法允许连续调用来追加多个键值对到同一个请求体内[^3]。 #### 组装 Request 对象 有了准备好的请求体之后，就可以将其封装进一个新的 `Request` 对象里去了，指定目标 URL 和所使用的 HTTP 动词（这里是 POST），以及之前建立起来的 `formBody`: ```java Request request = new Request.Builder() .url("https://api.example.com/login") .post(formBody) .build(); ``` #### 执行异步请求 最后一步就是执行实际的网络通信了，在这里选择以非阻塞的方式来进行——即发起一次异步调用。这可以通过 `client.newCall(request).enqueue(callback)` 完成，其中 callback 参数代表了一个实现了 `Callback` 接口的对象，它会在服务器响应到达的时候被触发： ```java client.newCall(request).enqueue(new Callback() { @Override public void onFailure(Call call, IOException e) { Log.e("TAG", "Failed to execute request"); } @Override public void onResponse(Call call, Response response) throws IOException { if (!response.isSuccessful()) throw new IOException("Unexpected code " + response); // 处理返回的结果... String responseData = response.body().string(); Log.d("TAG", responseData); } }); ``` 上述代码片段展示了如何在一个典型的 Android 应用程序环境中运用 `FormBody.Builder()` 来组装并发出携带简单文本型表单项的 POST 请求[^1]。