向 Retrofit 打响第一炮

1,177 阅读8分钟
原文链接: www.jianshu.com

废话:
强行开启了Retrofit的学习模式,但是发现啊,我找到的一些入门文章,简直不要太坑,敲不出来demo不要紧啊,你得讲的让我看懂吧?好,有一篇能看懂的了,喂能不能讲完啊,讲一半死球了不做完一套demo几个意思!

OK既然没有好的Retrofit第一炮的文章,那么我的机会就来了

看完本文并且do it你将收获

  1. 使用Retrofit进行一次基础的不能再基础的网络请求
  2. 没了

正文开始

  • Retrofit是啥?

    我想既然朋友你找到这篇文章,一定心里有个底,简单说就是一个简化网络操作的库

  • 准备工作
    1. 添加依赖
    //这是Retrofit的包
      compile 'com.squareup.retrofit2:retrofit:2.2.0'
    //这是Retrofit用来将得到的json转化成bean对象的包
      compile 'com.squareup.retrofit2:converter-gson:2.0.2'
    2. 用于请求数据的api,这里送你一个
    //最后面的num=3,这个数字可以自己改,需要几条数据就写几
    http://www.imooc.com/api/teacher?type=4&num=3
    3. json对应的javabean

    咱们先将2中的url用浏览器访问一下,会得到一串json字符串
    根据json内容自己敲一个bean
    复制json字符串,然后去jsonschema2pojo将他转化成一个bean


    jsonschema2pojo


    下载之后你得到了:Bean.javaDatum.java两个源文件

    /**Bean.java**/
    public class Bean {
          public Integer status;
          public List<Datum> data = null;
          public String msg;
          private Map<String, Object> additionalProperties = new HashMap<>();
    
          public Map<String, Object> getAdditionalProperties() {
              return this.additionalProperties;
          }
    
          public void setAdditionalProperty(String name, Object value) {
              this.additionalProperties.put(name, value);
          }
    }
    /**Datum.java**/
    public class Datum {
          public Integer id;
          public String name;
          public String picSmall;
          public String picBig;
          public String description;
          public Integer learner;
          private Map<String, Object> additionalProperties = new HashMap<>();
    
          public Map<String, Object> getAdditionalProperties() {
              return this.additionalProperties;
          }
    
          public void setAdditionalProperty(String name, Object value) {
              this.additionalProperties.put(name, value);
          }
    }

    接下来你需要将他们复制到你项目的包下,因为你要用到他们
    至此,准备就工作就全部做完了

  • 正式开始使用Retrofit
    1. 首先需要写一个接口

    这个接口规定get、post请求的url参数;规定一个返回Call对象(这个call对象用于正式发起请求并获得返回数据)的方法,这个方法接收的参数为url参数值,用开始给的url举例:

    http://www.imooc.com/api/teacher?type=4&num=3
    //num=3,num是一个参数,3是参数值,而这个接口内就规定了url中有哪些参数
    //返回Call对象 的方法 接收的参数,就是url的参数值

    那么对于这个api,我们需要写的接口应该是这样:

    public interface ApiService {
          @GET("teacher?type=4")
          Call<Bean> getCall(@Query("num") int count);
      }
    //这个"@GET"是Retrofit的注解,表示进行get请求,()括号内的字符串就是url的*参数信息*
    //那为什么"&num=3"不见了呢?看官请看我下面...
    //-------Call<Bean> getCall(@Query("num") int count);-------
    //这个方法返回一个Call<Bean>对象,等会儿正式发起请求并获取数据就靠他了
    //对头,Bean就对应于Bean.java!因为我们需要解析json变成一个Bean实例嘛
    //(@Query("num") int count)就厉害了,他表示:
    //在@GET("teacher?type=4")之中的字符串的后面,再添加"&num="
    //那么num等于多少呢,这就在使用getCall方法的时候由参数int count决定了

    好了,一个进行get请求的接口就写完了,也就这么两行,太简单了!

    其实,在这里还有另外一种情况,如果url不是在后面&添加参数,而需要指定的变量在url的路径中呢?比如github这个api:

    https://api.github.com/users/{user}/repos

    {user}是需要查找的用户名
    这个时候接口就应该这样写:

    public interface ApiService {
        @GET("users/{user}/repos")
        Call<Bean> getCall(@Path("user") String u);
    }
    //{user}直接理解为一个变量,这个变量的值由↓决定
    //@Path("user")表示将以上路径中的{user}变量赋值为参数u的值
    //当然切记,这里的Call<Bean>的Bean应该换成另外你根据API返回的json生成的bean

    以上内容,请另外尝试,与本次demo无关呀

    什么?post请求的接口该怎么写?
    我也不知道(/▽╲)

    2. 接下来创建一个Retrofit实例,通过Retrofit实例创建 接口的实例
          Retrofit retrofit = new Retrofit.Builder()
                  .baseUrl("http://www.imooc.com/api/")
                  .addConverterFactory(GsonConverterFactory.create())
                  .build();
          ApiService apiService = retrofit.create(ApiService.class);
    //机智,就是通过baseUrl补全整个url信息了!是不是上面@GET中残缺url的疑惑一下就解决了?!
    //当然在刚刚的接口中,你也可以一次性写全url,但是这样就不够灵活了!
    //----------------addConverterFactory(GsonConverterFactory.create())
    //这一句规定解析json用哪个库,这就是最开始要你导入Gson库的原因啦,咱们用Gson解析json
    //当然你也可以用其他的库解析json,比如jackson,写法是一样的,注意引入别人的库就是了
    //然后很完美的创建了一个retrofit实例,并且通过retrofit实例来创建了一个接口的实例
    3. 紧接着我们需要一个Call实例来正式的发起请求获取数据
    //请求3条数据,最后url就拼接成了最顶上给的url,是一毛一样的
    //没错,网络请求有异常,得try/catch一下
          Call<Bean> call = apiService.getCall(3);
          try {
              call.execute();//执行call,也就是正式发起网络请求咯!
          } catch (IOException e) {
              e.printStackTrace();
          }

    那么问题来了,发起网络请求之后,我去哪儿得到数据呢!机智的我把鼠标放在"execute()"上,然后按下ctrl键:


得到了call.execute()的返回值

原来call.execute()直接返回了一个请求结果,那么我们拿到这个结果来看看都有啥:

Response<Bean> response= call.execute();
result.//看下图

result都有啥


哇,这么多方法,返回的都是什么?其实一看方法名和返回类型便知,这里我们挑两个打印出来看看:

        try {
            Response<Bean> response= call.execute();
            Log.i(TAG, "response.body()----->" + response.body());
            Log.i(TAG, "response.message()----->" + response.message());
            Log.i(TAG, "response.code()----->" + response.code());
            //明明打印了3个!!
        } catch (IOException e) {
            e.printStackTrace();
        }
  • 拿到返回结果之后
    好的,现在所有代码如下:
    public class MainActivity extends AppCompatActivity {
          private static final String TAG = "MainActivity";
          public interface ApiService {
              @GET("teacher?type=4")
              Call<Bean> getCall(@Query("num") int count);
          }
          @Override
          protected void onCreate(Bundle savedInstanceState) {
              super.onCreate(savedInstanceState);
              setContentView(R.layout.activity_main);
              Retrofit retrofit = new Retrofit.Builder()
                      .baseUrl("http://www.imooc.com/api/")
                      .addConverterFactory(GsonConverterFactory.create())
                      .build();
              ApiService apiService = retrofit.create(ApiService.class);
              Call<Bean> call = apiService.getCall(3);
              try {
                  Response<Bean> response= call.execute();
                  Log.i(TAG, "response.body()----->" + response.body());
                  Log.i(TAG, "response.message()----->" + response.message());
                  Log.i(TAG, "response.code()----->" + response.code());
              } catch (IOException e) {
                  e.printStackTrace();
              }
          }
    }
    好像很完美了,马上就能收获利用retrofit发起网络请求获得数据的喜悦了!
    来,Run起来!
    ------------别Run了,你的结果一定是:

    程序挂掉了啊哈哈哈哈

    因为你没有添加网络权限!!
    <uses-permission android:name="android.permission.INTERNET" />
    好,这下OK了,这次我们真正的Run起来!

    程序挂掉了啊哈哈哈哈哈哈我不行了

    报错信息:
    //这尼玛我怎么在主线程进行网络请求了呢!!
    Caused by: android.os.NetworkOnMainThreadException
    好了,这下要真正的解决问题了!真正的所有代码MainActivity.java:
    public class MainActivity extends AppCompatActivity {
      private static final String TAG = "MainActivity";
      public interface ApiService {
          @GET("teacher?type=4")
          Call<Bean> getCall(@Query("num") int count);
      }
      @Override
      protected void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          setContentView(R.layout.activity_main);
          Retrofit retrofit = new Retrofit.Builder()
                  .baseUrl("http://www.imooc.com/api/")
                  .addConverterFactory(GsonConverterFactory.create())
                  .build();
          ApiService apiService = retrofit.create(ApiService.class);
          final Call<Bean> call = apiService.getCall(3);
    //----这里直接new了一个子线程来进行网络请求,看下方有一个Retrofit自带的异步请求方法
          new Thread(new Runnable() {
              @Override
              public void run() {
                  try {
                      Response<Bean> response= call.execute();
                      Log.i(TAG, "response.body()----->" + response.body());
                      Log.i(TAG, "response.message()----->" + response.message());
                      Log.i(TAG, "response.code()----->" + response.code());
                  } catch (IOException e) {
                      e.printStackTrace();
                  }
              }
          }).start();
    //如果你选择了这种写法
    //可千万别忘了start()!不然等会儿看不到log,你又要拿起砍刀找我了!
    //-------------------------------------
      }

    Retrofit还有一个本身就是异步请求的方法:

          //call.enqueue()方法接收一个Callback回调,我们直接new出来,这是异步请求方法
          call.enqueue(new Callback<Bean>() {
              @Override
              public void onResponse(Call<Bean> call, Response<Bean> response) {
                  //当获取到返回结果的时候回调这个方法
                  Log.i(TAG, "response.body()----->" + response.body());
                  Log.i(TAG, "response.message()----->" + response.message());
                  Log.i(TAG, "response.code()----->" + response.code());
              }
              @Override
              public void onFailure(Call<Bean> call, Throwable t) {
                  //网络请求失败的时候回调这个方法
              }
          });

    把上面的上面的new Thread(......).start();全部换成上面的代码,也一样OK了!

    • 当然更推荐这里写法了!

好了,废话这么多,来看看log到底打印出来了一些什么吧:


log信息

真的太完美了,这个结果告诉我们请求码是200,请求信息是OK,还给了我一个Bean对象!
噢对了,看看我会不会拿到一个假的Bean对象!眼见为实

        ......
            Bean b = response.body();
            Log.i(TAG, "Bean内容:" + b.msg);
            Log.i(TAG, "Bean内容:" + b.data.get(0).description);
         ......

还好拿到了真对象

好了,至此我们已经成功利用Retrofit进行网络请求,并且将得到的json直接变成了Bean对象,简直不要太爽

  • 如果我的文章确实有帮助到你,请不要忘了点一下文末的"♡"让他变成"❤"
  • 作为新手难免很多地方理解不到位,文中若有错误请直(bu)接(yao)指(ma)出(wo)
  • 写作不易!