欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Android开发之Retrofit小试牛刀

程序员文章站 2024-02-23 08:05:40
...

感觉好久没有写Android的文章了,囧囧囧!因为Retrofit实在是太火了, 火得我一直跃跃欲试,但是由于种种原因吧,一直都没有用过。周末闲来无事,利用一个以前开发中用过的服务器API来小试牛刀一下,非常简单,记录自己的第一次Retrofit之旅。

重要说明:由于涉及到商业机密,所以对请求的数据和服务器地址进行了处理。自己实验时,请换成自己的服务器。

一、添加依赖、配置项目

这一步就不详细说了,会的都会,基本就是添加两个依赖和网络访问权限。

compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

<uses-permission android:name="android.permission.INTERNET" />
复制代码

二、根据服务器端返回的JSON数据配置自己的JavaBean

在项目中用Retrofit的时候,肯定和服务器端的哥们商量好了如何交互,也就是说已经知晓了服务器端会返回什么样的数据(基本都是JSON,只是内容不一样而已),这些数据你可以直接用字符串接收,然后自己处理,但是这么low的事情,Retrofit肯定可以帮我处理了,用上面的converter-gson就可以自动将JSON转成我们的对象,前提是需要与返回的JSON字段进行映射,默认情况下字段名一样就不会出什么问题,但是我却踩了一个坑,下文会介绍。

  • 服务器端返回的JSON数据如下:
{"message":"ok","list":["id":"","abstract":"","title":"","url":""},...]
复制代码
  • 根据上面的JSON数据创建JavaBean
import com.google.gson.annotations.SerializedName;
import java.util.List;

/**
 * Created by yangfan on 2017/1/7.
 */

//与服务器端数据进行字段映射
public class NewsInfo {
  
    private String message;
    private List<News> list;

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public List<News> getList() {
        return list;
    }

    public void setList(List<News> list) {
        this.list = list;
    }


    public static class News {

        private String id;
        //@SerializedName:后面是服务器端返回的数据字段名 可以与本地不一样 该关键字就是用来映射的
        @SerializedName("abstract")
        private String _abstract;
        private String title;
        private String url;

        public String getId() {
            return id;
        }

        public void setId(String id) {
            this.id = id;
        }

        public String get_abstract() {
            return _abstract;
        }

        public void set_abstract(String _abstract) {
            this._abstract = _abstract;
        }

        public String getTitle() {
            return title;
        }

        public void setTitle(String title) {
            this.title = title;
        }

        public String getUrl() {
            return url;
        }

        public void setUrl(String url) {
            this.url = url;
        }
    }
}

复制代码

踩坑记录:服务器端居然有一个abstract字段,但是这个是Java关键字啊,怎么办?用@SerializedName告诉Retrofit,我想你把该字段映射成我自定义的名字。

配置访问服务器API的接口

这个就是真正的访问服务器的本地API了,我这里只用了GET,其实远不止这个功能,可以参考官方文档。

import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Query;

/**
 * Created by yangfan on 2017/1/7.
 */
public interface NewsInterface {

    //获取服务器的新闻列表,由于新闻类型和分页显示的需要,需要传递三个参数
    @GET("news/list")
    Call<NewsInfo> newsList(@Query("type") String type, @Query("pn") String pn, @Query("ps") String ps);

}
复制代码

Activity

配置好以上信息以后,就可以开始写Android的程序了。因为我的程序比较简单,所以我很快就成功获取数据了,这一块没怎么踩坑。

public class MainActivity extends AppCompatActivity {

    private TextView tvResult;
    //服务器的基地址 与  @GET("news/list")拼接
    private static final String baseUrl = "http://服务器地址/";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        tvResult = (TextView) findViewById(R.id.tvResult);

        initRetrofit();
    }

    private void initRetrofit() {

        Retrofit retrofit = new Retrofit.Builder().baseUrl(baseUrl).addConverterFactory(GsonConverterFactory.create())
                .build();


        NewsInterface newsInterface = retrofit.create(NewsInterface.class);

        Call<NewsInfo> callNewsInfo = newsInterface.newsList("1", "1", "10");

        callNewsInfo.enqueue(new Callback<NewsInfo>() {
            @Override
            public void onResponse(Call<NewsInfo> call, Response<NewsInfo> response) {
                //成功
                if (response.code() == 200) {
                    //将返回的数据转换成自定义的对象
                    NewsInfo newsInfo = response.body();

                    if(newsInfo.getMessage().equals("ok")){
                        //最爽的地方---直接可以进行UI操作
                        tvResult.setText(newsInfo.getList().get(0).get_abstract());
                    }
                } else {
                    //请求失败
                    tvResult.setText("查询失败!响应码为:" + response.code());
                }
            }

            @Override
            public void onFailure(Call<NewsInfo> call, Throwable t) {
                //请求失败
                t.printStackTrace();
                tvResult.setText("查询失败!错误原因:" + t.getCause());
            }
        });

    }
}

复制代码

运行结果

Retrofit功能非常强大,我也看了很多文档,上面用的只是冰山一角。目前感觉最大的好处就是可以直接在回调中操作主线程的UI,再也不需要用Handler了,其他牛逼的功能和好处待学习、待发掘。

转载于:https://juejin.im/post/5a3113875188257df8462c9a