Android網(wǎng)絡(luò)訪問之Retrofit使用教程
一、概念
| HttpClient | Android 6中移除(API數(shù)量多擴展困難)。 |
| HttpURLConnection | 目前官方集成的。 |
| OKHttp | Square公司出品,底層通訊的實現(xiàn)。 |
| Retrofit | Square公司出品,上層接口的封裝,更方便使用面向?qū)ο笏季S進行網(wǎng)絡(luò)操作。 |
二、使用
Android 9開始默認只允許使用 HTTPS 類型的網(wǎng)絡(luò)請求,HTTP明文傳輸因為有安全隱患不再支持。堅持使用的話需要配置:右鍵res目錄→New→Directory→創(chuàng)建一個xml目錄,右鍵xml目錄→New→File→創(chuàng)建一個network_config.xml文件,修改內(nèi)容如下:
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true">
<trust-anchors>
<certificates src="system" />
</trust-anchors>
</base-config>
</network-security-config>Manifest {
//添加網(wǎng)絡(luò)訪問權(quán)限
<uses-permission android:name="android.permission.INTERNET" />
//允許HTTP訪問
<application
android:networkSecurityConfig="@xml/network_config"
</application>
}
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 定義實體類
根據(jù) JSON 內(nèi)容,編寫對應(yīng)的實體類。
data class Person(var name: String, var age: Int)
2.3.2 定義API接口
根據(jù) API 接口,編寫對應(yīng)的訪問文件。命名通常以功能名稱開頭+Service結(jié)尾。
| @GET | 從服務(wù)器獲取數(shù)據(jù) |
| @POST | 向服務(wù)器提交數(shù)據(jù) |
| @PUT @PATCH | 修改服務(wù)器上的數(shù)據(jù) |
| @DELETE | 刪除服務(wù)器上的數(shù)據(jù) |
interface PersonService {
//接口1:https://www.baidu.com/person.json
@GET("person.json") //表示發(fā)起的是GET請求,傳入請求的地址(相對路徑,重復(fù)根路徑在后面配置)
fun getPerson(): Call<list<Person>> //返回值必須聲明成Retrofit內(nèi)置的Call類型,通過泛型指定服務(wù)器返回的具體數(shù)據(jù)類型
//接口2:https://www.baidu.com/<page>/person.json
@GET("{page}/get_data.json") //使用 {page} 占位
fun getData(@Path("page") page: Int): Call<Data> //使用 @Path("page")注解來聲明對應(yīng)參數(shù)
//接口3:https://www.baidu.com/person.json?u=<user>&t=<token>
@GET("person.json")
fun getData(@Query("u") user: String, @Query("t") token: String): Call<Data>
//接口4:https://api.caiyunapp.com/v2/place?query=北京&token={token}&lang=zh_CN
@GET("v2/place?token=${GlobalApplication.TOKEN}&lang=zh_CN") //不變的參數(shù)固定寫在GET里
fun searchPlaces(@Query("query") query: String): Call<PlaceResponse>
//接口5:https://www.baidu.com/data/<id>
@DELETE("data/{id}")
fun deleteData(@Path("id") id: String): Call<ResponseBody> //該泛型表示能接受任意類型切不會進行解析
//接口6:https://www.baidu.com/data/create{"id": 1, "content": "The description for this data."}
@POST("data/create")
fun createData(@Body data: Data): Call<ResponseBody> //將Data對象中的數(shù)據(jù)轉(zhuǎn)換成JSON格式的文本,并放到HTTP請求的body部分
//接口7:http://example.com/get_data.json
// User-Agent: okhttp //header參數(shù)就是鍵值對
// Cache-Control: max-age=0
//靜態(tài)聲明
@Headers("User-Agent: okhttp", "Cache-Control: max-age=0")
@GET("get_data.json")
fun getData(): Call<Data>
//動態(tài)聲明
@GET("get_data.json")
fun getData(@Header("User-Agent") userAgent: String, @Header("Cache-Control") cacheControl: String): Call<Data>
}2.3.3 構(gòu)建Retrofit對象
val retrofit = Retrofit.Builder()
.baseUrl("https://www.baidu.com/") //配置重復(fù)的根路徑
.addConverterFactory(GsonConverterFactory.create()) //指定解析數(shù)據(jù)使用的轉(zhuǎn)換庫(這里是Gson)
.build()2.3.4 創(chuàng)建API接口實例并調(diào)用訪問函數(shù)
//創(chuàng)建動態(tài)代理對象
val personService = retrofit.create(PersonService::class.java)
//調(diào)用訪問函數(shù)
personService.getPerson().enqueue(object : Call<List<person>> { //根據(jù)注解中配置的地址進行網(wǎng)絡(luò)請求
override fun onResponse(call: Call<List<person>>, response: Response<List<person>>) {
val list = response.body() //得到解析后的對象
}
override fun onFailure(call: Call<List<person>>, t: Trouble) {
t.printStackTrace()
}
})2.3.5 優(yōu)化
object GlobalRetrofit {
private const val BASE_URL = "www.baidu.com/"
val retrofit: Retrofit = Retrofit.Builder()
.baseUrl(BASE_URL)
.addConverterFactory(GsonConverterFactory.create())
.build()
//fun <T> create(serviceClass: Class<T>): T = retrofit.create(serviceClass)
inline fun <reified T> create(): T = create(T::class.java)
}
//使用
val personService = GlobalRetrofit.create<PersonService>()到此這篇關(guān)于Android網(wǎng)絡(luò)訪問之Retrofit使用教程的文章就介紹到這了,更多相關(guān)Android Retrofit內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android編程實現(xiàn)將ButtonBar放在屏幕底部的方法
這篇文章主要介紹了Android編程實現(xiàn)將ButtonBar放在屏幕底部的方法,涉及Android界面設(shè)計與文本操作相關(guān)技巧,需要的朋友可以參考下2017-03-03
Android ContentProvider獲取手機聯(lián)系人實例
這篇文章主要介紹了Android ContentProvider獲取手機聯(lián)系人實例,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-02-02
快速關(guān)閉android studio的自動保存功能教程
這篇文章主要介紹了快速關(guān)閉android studio的自動保存功能教程,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-04-04
Android中傳值Intent與Bundle的區(qū)別小結(jié)
這篇文章主要給大家總結(jié)介紹了關(guān)于Android中傳值Intent與Bundle的區(qū)別,文中通過示例代碼以及圖文介紹的非常詳細,對各位Android開發(fā)者們具有一定的參考學(xué)習(xí)價值,需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03

