Android HttpURLConnection用法详解

HttpURLConnection 是 Android 进行网络请求的一个轻量级 HTTP 客户端,适用于简单的 GET 和 POST 请求。以下是 HttpURLConnection 的基本使用方法。


使用步骤

  1. 创建 URL 对象
  2. 打开连接并配置请求
  3. 发送请求
  4. 读取响应
  5. 关闭连接

示例代码

1. GET 请求

kotlin 复制代码
import java.net.HttpURLConnection
import java.net.URL
​
fun sendGetRequest(urlString: String): String? {
    var connection: HttpURLConnection? = null
    try {
        val url = URL(urlString)
        connection = url.openConnection() as HttpURLConnection
        connection.requestMethod = "GET"
        connection.connectTimeout = 5000  // 超时时间
        connection.readTimeout = 5000
        connection.doInput = true  // 允许输入流
​
        if (connection.responseCode == HttpURLConnection.HTTP_OK) {
            return connection.inputStream.bufferedReader().use { it.readText() }
        }
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        connection?.disconnect()  // 断开连接
    }
    return null
}
​
// 使用
val response = sendGetRequest("https://api.example.com/data")
println(response)

2. POST 请求

kotlin 复制代码
import java.io.OutputStream
import java.net.HttpURLConnection
import java.net.URL
​
fun sendPostRequest(urlString: String, postData: String): String? {
    var connection: HttpURLConnection? = null
    try {
        val url = URL(urlString)
        connection = url.openConnection() as HttpURLConnection
        connection.requestMethod = "POST"
        connection.connectTimeout = 5000
        connection.readTimeout = 5000
        connection.doOutput = true  // 允许输出流
        connection.setRequestProperty("Content-Type", "application/json") // 发送 JSON 数据
​
        // 发送数据
        connection.outputStream.use { os: OutputStream ->
            os.write(postData.toByteArray())
            os.flush()
        }
​
        if (connection.responseCode == HttpURLConnection.HTTP_OK) {
            return connection.inputStream.bufferedReader().use { it.readText() }
        }
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        connection?.disconnect()
    }
    return null
}
​
// 使用
val jsonBody = """{"username":"test","password":"123456"}"""
val postResponse = sendPostRequest("https://api.example.com/login", jsonBody)
println(postResponse)

注意事项

  1. 网络请求必须在子线程执行

    • 在 Android 9 及以上,主线程访问网络会抛出 NetworkOnMainThreadException
    • 可以使用 CoroutineThread 处理。

    使用 Coroutine 进行网络请求

    kotlin 复制代码
    kotlinx.coroutines.Dispatchers
    import kotlinx.coroutines.withContext
    ​
    suspend fun fetchData(): String? {
        return withContext(Dispatchers.IO) { 
            sendGetRequest("https://api.example.com/data") 
        }
    }

    使用 fetchData()

    不能在主线程直接调用 fetchData(),需要在协程中调用,例如:

    kotlin 复制代码
    import kotlinx.coroutines.*
    ​
    fun main() {
        GlobalScope.launch {
            val result = fetchData()
            println(result)
        }
        Thread.sleep(6000) // 等待协程执行(仅示例用,实际开发不推荐)
    }
  2. 权限

    • AndroidManifest.xml 中添加权限:
    ini 复制代码
    <uses-permission android:name="android.permission.INTERNET"/>
  3. 超时设置

    • connectTimeoutreadTimeout 防止请求长时间挂起。

替代方案

在 Android 现代开发中,建议使用 OkHttpRetrofit 进行网络请求,HttpURLConnection 适用于轻量级请求或对库依赖要求较高的项目。

🔄 对比:HttpURLConnection vs OkHttp vs Retrofit

特性 HttpURLConnection OkHttp Retrofit
原生支持 ❌(需导入库) ❌(需依赖 OkHttp)
简洁性 ✅✅
请求配置 繁琐 简单 非常简单(注解)
自动解析 JSON ❌(需手动) ✅(配合 Gson/Moshi)
拦截器支持
相关推荐
武子康4 小时前
Java-80 深入浅出 RPC Dubbo 动态服务降级:从雪崩防护到配置中心秒级生效
java·分布式·后端·spring·微服务·rpc·dubbo
舒一笑5 小时前
我的开源项目-PandaCoder迎来史诗级大更新啦
后端·程序员·intellij idea
灵感__idea5 小时前
JavaScript高级程序设计(第5版):好的编程就是掌控感
前端·javascript·程序员
烛阴6 小时前
Mix
前端·webgl
@昵称不存在6 小时前
Flask input 和datalist结合
后端·python·flask
代码续发6 小时前
前端组件梳理
前端
zhuyasen6 小时前
Go 分布式任务和定时任务太难?sasynq 让异步任务从未如此简单
后端·go
东林牧之7 小时前
Django+celery异步:拿来即用,可移植性高
后端·python·django
试图让你心动7 小时前
原生input添加删除图标类似vue里面移入显示删除[jquery]
前端·vue.js·jquery
陈不知代码7 小时前
uniapp创建vue3+ts+pinia+sass项目
前端·uni-app·sass