剛接觸Retrofit2,簡(jiǎn)單的實(shí)現(xiàn)一下如何獲取網(wǎng)頁代碼吧,算是最最最基本的使用~
第1步【轉(zhuǎn)換HTTP API為Java接口】
public interface GitHubService {
@GET("users/{owner}/repos")
Call<ResponseBody> call(
@Path("owner") String owner
);
}
- @GET
注解之一,意思為從網(wǎng)絡(luò)獲取數(shù)據(jù)。
Get和Post區(qū)別,請(qǐng)?zhí)D(zhuǎn)post和get的區(qū)別?
- ("")
跟著baseUrl后面的網(wǎng)址,比如我們要請(qǐng)求的完整Url為
https://api.github.com/users/yjm/repos
其中
https://api.github.com/
就是baseUrl,而users/yjm/repos 就是跟著baseUrl后面的網(wǎng)址,當(dāng)然了,其中yjm正是我們要?jiǎng)討B(tài)更改的部位,可以用{owner}代替,然后在@path中完成傳入
- Call<ResponseBody> call
Call是固定寫法;
ResponseBody是<T>類型的
也就是說要傳入一個(gè)實(shí)體;call是方法名,可隨意自定義
- @Path("owner") String owner
以插值的方式拼接url。
("owner")對(duì)應(yīng){owner};
String owner表明所傳入插值的數(shù)據(jù)類型
當(dāng)然也可以是Integer之類的,看具體的api接口的類型
【4月6日】補(bǔ)充!!!
Path中的傳入的字符默認(rèn)是要轉(zhuǎn)換成16進(jìn)制ASCII編碼的
比如傳入"John+Doe",插入的值默認(rèn)的是"John%2BDoe"
反之,如果@Path(value="name", encoded=true) 中把encoded設(shè)置為ture,則會(huì)取消編碼轉(zhuǎn)換,傳的啥就是啥
那么則插入的值則變成是"John+Doe"
第2步【Retrofit實(shí)例化對(duì)象完成對(duì)GitHubService的實(shí)現(xiàn)】
Retrofit retrofit = new Retrofit
.Builder()
.baseUrl("https://api.github.com/")
.build();
GitHubService mGitHubService =
retrofit.create(GitHubService.class);
- Retrofit
這玩意中文意思是改造,類似實(shí)例化了一個(gè)事件一個(gè)任務(wù),描述內(nèi)容包括人物+地點(diǎn)+干了什么+怎么干。那么下面就是這些具體內(nèi)容。
- .Builder()
誰who。建造者,主角不能少。
- .baseUrl("")
怎么干howToDo。設(shè)置主地址,也稱作絕對(duì)地址、根地址,可以根據(jù)自己的理解方式記憶~~
- .build()
干Do。
- GitHubService
眼熟吧,就是第1步中自定義的接口類。
類實(shí)例化對(duì)象*mGitHubService *,沒毛病
- retrofit.create(GitHubService.class)
大劇本(例如《還珠格格》)已經(jīng)編好,就等著執(zhí)行了
第3步【調(diào)用GitHubServcie的實(shí)例完成發(fā)送請(qǐng)求】
Call<ResponseBody> call =
mGitHubService.call("yjm");
- Call<ResponseBody>
就是第1步里接口類定義的Call<ResponseBody> 方法在接口類中,可以自行定義多個(gè)方法,名字可以相同,只要方法名不同即可,比如call、call1,到底用哪一個(gè)?
- mGitHubService.call("yjm")
mGitHubService就是第2步中實(shí)例化接口類生成的;
.call()決定了用的方法名,里面?zhèn)魅氲?步中String owner定義的參數(shù),所以,最終請(qǐng)求的
Url為https://api.github.com/users/yjm/repo
第4步【異步執(zhí)行發(fā)送請(qǐng)求,并處理數(shù)據(jù)】
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call,
Response<ResponseBody> response) {
try {
toString.setText(response.toString());
message.setText(response.message());
bodyString.setText(response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Call<ResponseBody> call,
Throwable t) {
}
});
- call.enqueue(new Callback<ResponseBody>() {});
好理解,看成是我們熟悉的
btn.setOnClickLitsener(new View.OnClickLitsener(){}); 對(duì)號(hào)入座即可。
在AS上寫完這句,后面的就自動(dòng)補(bǔ)齊了,所以根本不要擔(dān)心后面一大串代碼參數(shù)
- onResponse()
請(qǐng)求成功時(shí)回調(diào)。可以處理數(shù)據(jù),其中
response.toString() 指請(qǐng)求狀態(tài);
response.message() 指請(qǐng)求成功與否;
response.body().string() 就是我們真正要得到的數(shù)據(jù);
- onFailure()
請(qǐng)求失敗時(shí)的回調(diào),斷網(wǎng)直接讓吐司吐出來t.toString(),如圖
源碼
https://git.coding.net/Aku/RetrofitTest.git