Android网络访问之Retrofit使用教程

目录

• 一、概念
• 二、使用
• 2.1HttpURLConnection
• 2.2OKHttp
• 2.3Retrofit
• 2.3.1 定义实体类
• 2.3.2 定义API接口
• 2.3.3 构建Retrofit对象
• 2.3.4 创建API接口实例并调用访问函数
• 2.3.5 优化

一、概念

HttpClient	Android 6中移除（API数量多扩展困难）。
HttpURLConnection	目前官方集成的。
OKHttp	Square公司出品，底层通讯的实现。
Retrofit	Square公司出品，上层接口的封装，更方便使用面向对象思维进行网络操作。

二、使用

Android 9开始默认只允许使用 HTTPS 类型的网络请求，HTTP明文传输因为有安全隐患不再支持。坚持使用的话需要配置：右键res目录→New→Directory→创建一个xml目录，右键xml目录→New→File→创建一个network_config.xml文件，修改内容如下：

Manifest {
    //添加网络访问权限
   
    //允许HTTP访问
            android:networkSecurityConfig="@xml/network_config"
   
}

2.1HttpURLConnection

thread {
    var connection: HttpURLConnection? = null
    try {
        val response = StringBuilder()
        val url = URL("https://www.baidu.com")
        connection = url.openConnection() as HttpURLConnection
        connection.connectTimeout = 8000
        connection.readTimeout = 8000
        //GET请求
        val input = connection.inputStream
        val reader = BufferedReader(InputStreamReader(input))
        reader.useLines { response.append(it) }
        print(response.toString())
        //POST请求
        connection.requestMethod = "POST"
        val output = DataOutputStream(connection.outputStream)
        output.writeBytes("username=admin&password=123456")
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        connection?.disconnect()
    }
}

2.2OKHttp

传送门

2.3Retrofit

查看最新版本

implementation 'com.squareup.retrofit2:retrofit:2.9.0'    //会连带下载 OkHttp和Okio
implementation 'com.squareup.retrofit2:converter-gson:2.k6.1'    //会连带下载 GSON

2.3.1 定义实体类

根据 JSON 内容，编写对应的实体类。

data class Person(var name: String, var age: Int)

2.3.2 定义API接口

根据 API 接口，编写对应的访问文件。命名通常以功能名称开头+Service结尾。

@GET	从服务器获取数据
@POST	向服务器提交数据
@PUT @PATCH	修改服务器上的数据
@DELETE	删除服务器上的数据

interface PersonService {
    //接口1：https://www.baidu.com/person.json
    @GET("person.json")    //表示发起的是GET请求，传入请求的地址（相对路径，重复根路径在后面配置）
    fun getPerson(): Call>    //返回值必须声明成Retrofit内置的Call类型，通过泛型指定服务器返回的具体数据类型
    //接口2：https://www.baidu.com//person.json
    @GET("{page}/get_data.json")    //使用 {page} 占位
    fun getData(@Path("page") page: Int): Call    //使用 @Path("page")注解来声明对应参数
    //接口3：https://www.baidu.com/person.json?u=&t=
    @GET("person.json")
    fun getData(@Query("u") user: String, @Query("t") token: String): Call
    //接口4：https://api.caiyunapp.com/v2/place?query=北京&token={token}&lang=zh_CN
    @GET("v2/place?token=${GlobalApplication.TOKEN}&lang=zh_CN")    //不变的参数固定写在GET里
    fun searchPlaces(@Query("query") query: String): Call
    //接口5：https://www.baidu.com/data/
    @DELETE("data/{id}")
    fun deleteData(@Path("id") id: String): Call    //该泛型表示能接受任意类型切不会进行解析
    //接口6：https://www.baidu.com/data/create{"id": 1, "content": "The description for this data."}
    @POST("data/create")
    fun createData(@Body data: Data): Call    //将Data对象中的数据转换成JSON格式的文本，并放到HTTP请求的body部分
    //接口7：http://example.com/get_data.json
    //      User-Agent: okhttp    //header参数就是键值对
    //      Cache-Control: max-age=0
    //静态声明
    @Headers("User-Agent: okhttp", "Cache-Control: max-age=0")
    @GET("get_data.json")
    fun getData(): Call
    //动态声明
    @GET("get_data.json")
    fun getData(@Header("User-Agent") userAgent: String, @Header("Cache-Control") cacheControl: String): Call
}

2.3.3 构建Retrofit对象

val retrofit = Retrofit.Builder()
    .baseUrl("https://www.baidu.com/")    //配置重复的根路径
    .addConverterFactory(GsonConverterFactory.create())    //指定解析数据使用的转换库（这里是Gson）
    .build()

2.3.4 创建API接口实例并调用访问函数

//创建动态代理对象
val personService = retrofit.create(PersonService::class.java)
//调用访问函数
personService.getPerson().enqueue(object : Call> {    //根据注解中配置的地址进行网络请求
    override fun onResponse(call: Call>, response: Response>) {
        val list = response.body()    //得到解析后的对象
    }
    override fun onFailure(call: Call>, t: Trouble) {
        t.printStackTrace()
    }
})

2.3.5 优化

object GlobalRetrofit {
    private const val BASE_URL = "www.baidu.com/"
    val retrofit: Retrofit = Retrofit.Builder()
        .baseUrl(BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build()
    //fun  create(serviceClass: Class): T = retrofit.create(serviceClass)
    inline fun  create(): T = create(T::class.java)
}
//使用
val personService = GlobalRetrofit.create()

到此这篇关于Android网络访问之Retrofit使用教程的文章就介绍到这了,更多相关Android Retrofit内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！