Retrofit2入门级笔记（一）

刚接触Retrofit2，简单的实现一下如何获取网页代码吧，算是最最最基本的使用~

第1步【转换HTTP API为Java接口】

public interface GitHubService {

    @GET("users/{owner}/repos")
    Call call(
    @Path("owner") String owner
    );
    
}

• @GET

注解之一，意思为从网络获取数据。
Get和Post区别，请跳转post和get的区别？

• ("")

跟着baseUrl后面的网址，比如我们要请求的完整Url为
https://api.github.com/users/yjm/repos
其中
https://api.github.com/
就是baseUrl，而users/yjm/repos 就是跟着baseUrl后面的网址，当然了，其中yjm正是我们要动态更改的部位，可以用{owner}代替，然后在@path中完成传入

• Call call

Call是固定写法；
ResponseBody是类型的
也就是说要传入一个实体；call是方法名，可随意自定义

• @Path("owner") String owner

以插值的方式拼接url。
("owner")对应{owner}；
String owner表明所传入插值的数据类型
当然也可以是Integer之类的，看具体的api接口的类型
【4月6日】补充！！！
Path中的传入的字符默认是要转换成16进制ASCII编码的
比如传入"John+Doe"，插入的值默认的是"John%2BDoe"
反之，如果@Path(value="name", encoded=true) 中把encoded设置为ture，则会取消编码转换，传的啥就是啥
那么则插入的值则变成是"John+Doe"

第2步【Retrofit实例化对象完成对GitHubService的实现】

Retrofit retrofit = new Retrofit
  .Builder()
  .baseUrl("https://api.github.com/")
  .build();
    
GitHubService mGitHubService = 
retrofit.create(GitHubService.class);

• Retrofit

这玩意中文意思是改造，类似实例化了一个事件一个任务，描述内容包括人物+地点+干了什么+怎么干。那么下面就是这些具体内容。

• .Builder()

谁who。建造者，主角不能少。

• .baseUrl("")

怎么干howToDo。设置主地址，也称作绝对地址、根地址，可以根据自己的理解方式记忆~~

• .build()

干Do。

• GitHubService

眼熟吧，就是第1步中自定义的接口类。
类实例化对象*mGitHubService *，没毛病

• retrofit.create(GitHubService.class)

大剧本(例如《还珠格格》)已经编好，就等着执行了

第3步【调用GitHubServcie的实例完成发送请求】

Call call =
mGitHubService.call("yjm");

• Call

就是第1步里接口类定义的Call 方法在接口类中，可以自行定义多个方法，名字可以相同，只要方法名不同即可，比如call、call1，到底用哪一个？

• mGitHubService.call("yjm")

mGitHubService就是第2步中实例化接口类生成的;
.call()决定了用的方法名，里面传入第1步中String owner定义的参数，所以，最终请求的
Url为https://api.github.com/users/yjm/repo

第4步【异步执行发送请求，并处理数据】

call.enqueue(new Callback() {
    @Override
    public void onResponse(Call call,
    Response 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 call,
    Throwable t) {
            }
});

• call.enqueue(new Callback() {});

好理解，看成是我们熟悉的
btn.setOnClickLitsener(new View.OnClickLitsener(){}); 对号入座即可。
在AS上写完这句，后面的就自动补齐了，所以根本不要担心后面一大串代码参数

• onResponse()

请求成功时回调。可以处理数据，其中
response.toString() 指请求状态；
response.message() 指请求成功与否；
response.body().string() 就是我们真正要得到的数据；

device-2017-04-03-113721.png

• onFailure()

请求失败时的回调，断网直接让吐司吐出来t.toString()，如图

device-2017-04-03-114911.png

源码
https://git.coding.net/Aku/RetrofitTest.git