Android 使用 HTTP 访问网络

使用 HttpURLConnection

在过去，Android 上发送 HTTP 请求一般有两种方式：HttpURLConnection 和 HttpClient，不过在 Android 6.0 系统中，HttpClient 被完全移除了，因此推荐使用 HttpURLConnection

// 创建一个 URL 对象，并传入目标网络地址
val url = URL("https://www.baidu.com")
// 调用 openConnection() 方法即可获取 HttpURLConnection 实例
val connection = url.openConnection() as HttpURLConnection
// 设置 HTTP 请求所使用的方法
connection.requestMethod = "GET"
// 连接超时毫秒数
connection.connectTimeout = 8000
// 读取超时毫秒数
connection.readTimeout = 8000
// 获取服务器返回的输入流
val input = connection.inputStream
// 关闭 HTTP 连接
connection.disconnection()

另外，还需要声明网络权限，修改 AndroidManifest.xml 中的代码

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.networktest">
    
    <uses-permission android:name="android.permission.INTERNET" />
    ...
</manifest>

如果想要提交数据给服务器，只需将 HTTP 请求的方法改成 POST，并在获取输入流之前把要提交的数据写出即可。每条数据都要以键值对的形式存在，数据与数据之前用 & 符号隔开

connection.requestMethod = "POST"
val output = DataOutputStream(connection.outputStream)
output.writeBytes("username=admin&password=123")

使用 OkHttp

OkHttp 是由大名鼎鼎的 Square 公司开发的，在接口封装上做得简单易用，足以替代原生的 HttpURLConnection

在使用 OkHttp 之前，我们需要先在项目中添加 OkHttp 库的依赖，编辑 app/build.gradle 文件，在 dependencies 闭包中添加如下内容：

dependencies {
    ...
    implementation 'com.squareup.okhttp3:okhttp:4.1.0'
}

看一下 OkHttp 的用法

// 创建 OkHttpClient 实例
val client = OkHttpClient()
// 创建 Request 对象
val request = Request.Builder()
				.url("https://www.baidu.com")
				.build()
// 调用 newCall() 方法创建 Call 对象，并调用 execute() 方法发送请求并获取响应
val response = client.newCall(request).execute()
// 得到具体的返回内容
val responseData = response.body?.string()

如果是发起一条 POST 请求，会比 GET 请求稍微复杂一点

// 构建一个 RequestBody 对象存放待提交的参数
val requestBody = FormBody.Builder()
					.add("username", "admin")
					.add("password", "123")
					.build()
// 调用 post 方法，并将 RequestBody 对象传入
val request = Request.Builder()
					.url("https://www.baidu.com")
					.post(requestBody)
					.build()

网络请求回调

在获取到服务器响应的数据后，我们就需要对它进行解析和处理。OkHttp 提供了一个自带的回调接口，它会帮助我们开启一个子线程，然后在子线程中执行 HTTP 请求，并将最终的请求结果回调到 okhttp3.Callback

object HttpUtil {
    ...
    fun sendOkHttpRequest(address: String, callback: okhttp3.Callback) {
    	val client = OkHttpClient()
    	val request = Request.Builder()
    					.url(address)
    					.build()
    	client.newCall(request).enqueue(callback)
	}
}

我们在调用 sendOkHttpRequest() 方法的时候就可以这么写

HttpUtil.sendOkHttpRequest(address, object : Callback {
    // 得到服务器返回的具体内容
    override fun onResponse(call: Call, response: Response) {
        ...
    }
    // 对异常情况进行处理
    override fun onFailure(call: Call, e: IOException) {
        ...
    }
})