Retrofit2的使用-創(chuàng)新互聯(lián)

Retrofit2

Android常用的網(wǎng)絡(luò)訪問(wèn)HttpClient, HttpUrlConnection，OkHttp（okgo）,xUtils, Volley等. Android4.4之后使用OkHttp作為HttpUrlConnection底層實(shí)現(xiàn)。這次講一下Retrofit2怎么使用。

成都創(chuàng)新互聯(lián)公司-專業(yè)網(wǎng)站定制、快速模板網(wǎng)站建設(shè)、高性價(jià)比隴西網(wǎng)站開(kāi)發(fā)、企業(yè)建站全套包干低至880元,成熟完善的模板庫(kù),直接使用。一站式隴西網(wǎng)站制作公司更省心,省錢,快速模板網(wǎng)站建設(shè)找我們，業(yè)務(wù)覆蓋隴西地區(qū)。費(fèi)用合理售后完善，十年實(shí)體公司更值得信賴。

Retrofit2實(shí)際上是通過(guò)注解的方式對(duì)okhttp又一次封裝。

在AndroidStudio項(xiàng)目中，添加Retrofit2的依賴。
compile 'com.squareup.retrofit2:retrofit:2.3.0'

程序構(gòu)建成功后，查看項(xiàng)目具體依賴了多少jar包。

com.squareup.okhttp3:okhttp:3.8.0
com.squareup.okio:okio:1.13.0
com.squareup.retrofit2:retrofit:2.3.0

retrofit2 強(qiáng)制依賴了okhttp3的相關(guān)庫(kù)。這也說(shuō)明了retrofit2底層是okhttp3具體實(shí)現(xiàn)的。okhttp3是用來(lái)具體訪問(wèn)網(wǎng)絡(luò)的，okio是squareup對(duì)Java的io/nio的補(bǔ)充，使其更容易訪問(wèn)，存儲(chǔ)和處理數(shù)據(jù)。okio主要功能封裝到了ByteString和Buffer里面了。

簡(jiǎn)單的網(wǎng)絡(luò)訪問(wèn)（以https://suggest.taobao.com/sug?code=utf-8&q=java&callback=cb為例）。

2.1. 首先實(shí)例化okhttp

OkHttpClient client = new OkHttpClient.Builder().build();
//實(shí)例化OkHttpClient的時(shí)候，還可以設(shè)置攔截器，緩存，認(rèn)證信息，網(wǎng)絡(luò)攔截器，連接池，超時(shí)時(shí)間等信息。

2.2. 其次實(shí)例化retrofit，并將實(shí)例化好的okhttp3關(guān)聯(lián)到retrofit2。

Retrofit retrofit = new Retrofit.Builder().client(client).baseUrl("https://suggest.taobao.com/").build();

2.2.1 ...build()方法：

public Retrofit build() {
  if (baseUrl == null) {
    throw new IllegalStateException("Base URL required.");
  }

  okhttp3.Call.Factory callFactory = this.callFactory;
  if (callFactory == null) {
    callFactory = new OkHttpClient();
  }

  Executor callbackExecutor = this.callbackExecutor;
  if (callbackExecutor == null) {
    callbackExecutor = platform.defaultCallbackExecutor();
  }

  // Make a defensive copy of the adapters and add the default Call adapter.
  List<CallAdapter.Factory> adapterFactories = new ArrayList<>(this.adapterFactories);
  adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));

  // Make a defensive copy of the converters.
  List<Converter.Factory> converterFactories = new ArrayList<>(this.converterFactories);

  return new Retrofit(callFactory, baseUrl, converterFactories, adapterFactories,
      callbackExecutor, validateEagerly);
}

從這個(gè)方法里面可以看出，在實(shí)例化Retrofit的時(shí)候，baseUrl這個(gè)變量是必須要設(shè)置的，否則直接拋出IllegalStateException；而其余的一些信息如果不進(jìn)行，程序里面會(huì)給設(shè)置一個(gè)默認(rèn)的信息.默認(rèn)給設(shè)置了OkHttpClient實(shí)例，OkHttp3連接池、解析工廠、CallAdapter等信息；然后返回了一個(gè)retrofit2實(shí)例。

2.3. 定義接口文件ApiService。

interface ApiService{
    @GET("sug?code=utf-8&q=java&callback=cb")
    Call<ResponseBody> getGithubApi();
}

定義一個(gè)接口信息。Retrofit2中訪問(wèn)的一個(gè)網(wǎng)絡(luò)接口，返回的都是一個(gè)Call<ResponseBody> 實(shí)例，準(zhǔn)確的說(shuō)是Call<T>實(shí)例，但是這個(gè)實(shí)例中并沒(méi)有在實(shí)例化Retrofit2中設(shè)置addConverterFactory方法，如果需要解析成具體的JavaBean，則又需要依賴 'com.squareup.retrofit2:converter-gson:2.0.2'， 'com.google.code.gson:gson:2.3.1'。當(dāng)然再配合rxjava，rxandroid來(lái)使用的話，將是Android平臺(tái)很流行的網(wǎng)絡(luò)訪問(wèn)框架，三者的整合封裝本文不講。

Retrofit2中支持多種注解來(lái)定義http網(wǎng)絡(luò)訪問(wèn),比如：POST,GET,DELETE,PUT；還支持多種標(biāo)記注解FormUrlEncoded(使用到的注解都放到了retrofit2.http包下)

已2.3 ApiService接口為例。這個(gè)接口中定義了一個(gè)getGithubApi方法，該方法使用get方式提交，具體的路徑則寫到@GET("sug?code=utf-8&q=java&callback=cb"),我們知道get方式提交參數(shù)是直接將參數(shù)拼接到url地址后面。同樣也可以使用POST注解，表示該表單使用POST方式提交參數(shù)，要提交的參數(shù)則需要傳入到方法里面了，該方法就應(yīng)該這么定義getGithubApi(@Field("code") String code,@Field("q") String q,@Field("callback") String callback)或者getGithubApi(@FieldMap Map<String, String> params)//其中params的key作為參數(shù)名，value作為參數(shù)的值。

常用的注解表格

標(biāo)記在方法名之上序號(hào)	名稱	備注
1	GET	表示該方法使用GET方式提交參數(shù)。
2	POST	表示該方法使用POST方式提交參數(shù),這個(gè)經(jīng)常和參數(shù)標(biāo)記@Field和@FieldMap組合使用，也配合方法標(biāo)記@FormUrlEncoded使用。
3	PUT
4	DELETE
5	PATCH
6	HEAD
7	OPTIONS
8	HTTP	更加靈活的標(biāo)記，這個(gè)標(biāo)記里面可以指定，提交方式，path值，是否有body。
9	Streaming	返回流數(shù)據(jù)，當(dāng)服務(wù)器返回的數(shù)據(jù)過(guò)大時(shí)使用

比如：使用HTTP注解

@HTTP(method = "get", path = "zzhhz/{id}", hasBody = false)
Call<ResponseBody> getBlog(@Path("id") int id);

這里面指定了提交方式，path路徑，是否有body體。在這個(gè)地方path="zzhhz/{id}"，id是不確定的，又要當(dāng)一個(gè)參數(shù)傳進(jìn)去，用{}標(biāo)記變量，然后使用Path注解標(biāo)記在方法形參前。

標(biāo)記在形參之前：

序號(hào)	名稱	備注
1	Field/FieldMap	這個(gè)參數(shù)注解經(jīng)常配合POST注解使用，因?yàn)镻OST是隱式提交參數(shù)。
2	Part/PartMap	這個(gè)經(jīng)常是表示提交文件，又和Multipart，POST注解配合使用。
3	Path	url路徑，如上邊HTTP注解示例
4	Query/QueryMap/QueryName	查詢參數(shù)，通常配合GET注解使用

2.4. 訪問(wèn)數(shù)據(jù)。

ApiService githubService = retrofit.create(ApiService.class);
Call<ResponseBody> githubApi = githubService.getGithubApi();
Response<ResponseBody> execute = githubApi.execute();
if (execute != null && execute.isSuccessful()){
    String string = execute.body().string();
    System.out.println(string);
} else {
    System.out.println("訪問(wèn)失敗");
}

之前說(shuō)過(guò)Retrofit2強(qiáng)制依賴了OkHttp3, 在2.2實(shí)例化Retrofit2的時(shí)候，將已實(shí)例化的OkHttpClient傳入進(jìn)Retrofit2里，供其進(jìn)行網(wǎng)絡(luò)訪問(wèn)。

Retrofit2和OkHttp3實(shí)例化過(guò)程中使用到了建造者模式（不贅述涉及模式）。

完整的網(wǎng)絡(luò)訪問(wèn)設(shè)置：添加上攔截器（基于Java項(xiàng)目，開(kāi)發(fā)工具IDEA）。

@Test
public void testRetrofit() throws IOException {
//https://suggest.taobao.com/sug?code=utf-8&q=java&callback=cb

OkHttpClient client = new OkHttpClient.Builder().addInterceptor((chain) -> {
    Request request = chain.request();
    return chain.proceed(request);
}).readTimeout(60, TimeUnit.SECONDS).writeTimeout(60, TimeUnit.SECONDS).build();

Retrofit retrofit = new Retrofit.Builder().client(client).baseUrl("https://suggest.taobao.com/").build();

ApiService githubService = retrofit.create(ApiService.class);
Call<ResponseBody> githubApi = githubService.getGithubApi();
Response<ResponseBody> execute = githubApi.execute();
if (execute != null && execute.isSuccessful()) {
    String string = execute.body().string();
    System.out.println(string);
} else {
    System.out.println("訪問(wèn)失敗");
}

}

interface ApiService {@GET("sug?code=utf-8&q=java&callback=cb")
br/>@GET("sug?code=utf-8&q=java&callback=cb")
}

到此Retrofit2講解完畢。語(yǔ)言組織的不好，有什么問(wèn)題大家可以留言，相互學(xué)習(xí)。

另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)scvps.cn，海內(nèi)外云服務(wù)器15元起步，三天無(wú)理由+7*72小時(shí)售后在線，公司持有idc許可證，提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國(guó)服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案，具有“安全穩(wěn)定、簡(jiǎn)單易用、服務(wù)可用性高、性價(jià)比高”等特點(diǎn)與優(yōu)勢(shì)，專為企業(yè)上云打造定制，能夠滿足用戶豐富、多元化的應(yīng)用場(chǎng)景需求。

名稱欄目：Retrofit2的使用-創(chuàng)新互聯(lián)
本文鏈接：http://muchs.cn/article48/cociep.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供微信公眾號(hào)、ChatGPT、App開(kāi)發(fā)、定制網(wǎng)站、網(wǎng)站收錄、網(wǎng)頁(yè)設(shè)計(jì)公司

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源：創(chuàng)新互聯(lián)

猜你還喜歡下面的內(nèi)容