Android网络编程（二）- 简要记录Retrofit的使用

Android网络编程（二）

初识Retrofit网络框架，简要记录一下使用流程：

我理解的Retrofit

Retrofit网络框架，本质上来说还是之前介绍过的OkHttp框架，Retrofit是对其进行了一层封装，通过注解来配置网络请求参数，支持同步异步，而且有方法直接在UI线程更新界面；

Retrofit使用流程

1.首先要添加Retrofit相关的依赖；
2.根据API或者网络请求返回地数据建立数据解析类，我们这里用的是GSON解析；
3.创建Retrofit用于进行网络请求的接口；
4.新建Retrofit实例，传入参数；
5.实例化接口，用Retrofit实例进行create()；
6.实例化Call<>，配置网络请求参数；
7.发送网络请求；

OVER！！！OVER！！！

---

接下来就一步一步实现吧：

1.添加相关依赖：

	//Retrofit库
	compile 'com.squareup.retrofit2:retrofit:2.0.2'
	//OkHttp库
    compile 'com.squareup.okhttp3:okhttp:3.1.2'
    //Retrofit对应版本Gson库
    compile 'com.squareup.retrofit2:converter-gson:2.0.2'

---

2.创建接收数据实例类：

之前介绍过用GSONFormat自动建立数据类，这里就不介绍了，有兴趣可以去看看，挺简单的，这里直接跳过吧，我们的数据解析类叫做Weather，下面会用到的；

---

3.创建网络请求接口：

在Retrofit中，这部分属于很重要的一部分了，用到了注解，Retrofit中注解很多，目前我用到了@GET以及@POST，可以解决绝大多数问题了。

1).@GET：

@GET()括号中，写入的是部分url网址，因为公用的url我们会在正式使用的时候设置，而后面的后缀不同，返回地参数也就不同，因此在GET()中会写入不同的部分：

	@GET("?")

这是我用的API的不确定部分：

https://query.asilu.com/weather/baidu/?city=南京

这就是API的网址了，我们可以传入城市来获取数据，前面都是一样的，因此我们只要在GET中写入“？”就可以，那么这个参数我们怎么传入呢：

Call<Weather> getWeather(@Query("city") String city);

这个Weather就是之前说过的数据解析类，@Query这部分代表的是个键值对，我的理解是，这个地方写的键值对会做“city = city”这样的形势放在？后面作为整体的url传入，如果有不对的希望大佬们告诉我；

2). @POST

顾名思义，这是需要我们上传一些数据的，比如我们进行数据上传登录注册等时，就需要用到这个，现在用的比较浅显，简要记录一下：

	@POST("?")
    @FormUrlEncoded
    Call<Weather> getCity(@Field("city") String city);

@FormUrlEncoded这个注解是为了说明上传的是个表单形式，下面的@Field在我理解下和之前的@Query含义是一样的，只是一个作为URL网址，一个作为数据；

---

4.实例化Retrofit：

这里先上代码吧：

String url="https://query.asilu.com/weather/baidu/";
        Retrofit retrofit=new Retrofit.Builder()
                .baseUrl(url)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

简洁的代码，新建了Retrofit.Builder()，然后传入baseUrl()我们设置好的url值，然后设置使用Gson解析，最后build()一下；

---

5.根据刚实例化的retrofir实例化网络请求接口：

WeatherInter weatherInter = retrofit.create(WeatherInter.class);

就这样；

---

6.实例化Call，配置网络请求参数：

Call<Weather> call=weatherInter.getCity(city);

我们这里测试一下获取的是不是我们想要的城市的天气，因此设置的getCity()；

---

7.发送网络请求：

 call.enqueue(new Callback<Weather>() {
            @Override
            public void onResponse(Call<Weather> call, Response<Weather> response) {
                String weather=response.body().getCity();
                textView.setText(weather);
            }

            @Override
            public void onFailure(Call<Weather> call, Throwable t) {
                Toast.makeText(RetrofitActivity.this, "???", Toast.LENGTH_SHORT).show();
            }
        });

OVER！！！OVER！！！

用着确实是比其他的简单，不过还有其他的需要研究一下，下面贴一下整体代码：

public interface WeatherInter {

    @GET("?")
    Call<Weather> getWeather(@Query("city") String city);

    @POST("?")
    @FormUrlEncoded
    Call<Weather> getCity(@Field("city") String city);
}

public class RetrofitActivity extends AppCompatActivity {

    private ImageView imageView;
    private TextView textView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_retrofit);
        imageView=findViewById(R.id.retrofit_Go);
        textView=findViewById(R.id.retrofit_Text);
        imageView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Retrofit("济宁");
            }
        });


    }

    public void retrofit(){
        String url="https://query.asilu.com/weather/baidu/";
        Retrofit retrofit=new Retrofit.Builder()
                .baseUrl(url)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

        WeatherInter weatherInter=retrofit.create(WeatherInter.class);
        Call<Weather> call=weatherInter.getWeather("济宁");

        call.enqueue(new Callback<Weather>() {
            @Override
            public void onResponse(Call<Weather> call, Response<Weather> response) {
                String weather=response.body().getWeather().get(0).getWeather();
                textView.setText(weather);
            }

            @Override
            public void onFailure(Call<Weather> call, Throwable t) {
                Toast.makeText(getApplicationContext(),"???",Toast.LENGTH_SHORT).show();
            }
        });
    }

    public void Retrofit(String city){
        String url="https://query.asilu.com/weather/baidu/";
        Retrofit retrofit=new Retrofit.Builder()
                .baseUrl(url)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

        WeatherInter weatherInter=retrofit.create(WeatherInter.class);
        Call<Weather> call=weatherInter.getCity(city);

        call.enqueue(new Callback<Weather>() {
            @Override
            public void onResponse(Call<Weather> call, Response<Weather> response) {
                String weather=response.body().getCity();
                textView.setText(weather);
            }

            @Override
            public void onFailure(Call<Weather> call, Throwable t) {
                Toast.makeText(RetrofitActivity.this, "???", Toast.LENGTH_SHORT).show();
            }
        });
    }
}

其实没什么好贴的，但是我就想看着多一点，就这样。