定义Retrofit 网络接口服务的包装类（基础类）

1、根据API返回的json数据来创建一个FamousInfo数据对象，我们可以利用AndroidStudio插件 GsonFormat 快速，方便的将json数据转为Java
对象。

FamousInfo

package test.ban.com.myapplication.bean;

import java.util.List;

/**
* Created by ban
*/
public class FamousInfo {

/**
* total : 227
* result : [{"famous_name":"车尔尼雪夫斯基","famous_saying":"非凡的单纯，非凡的明确\u2014\u2014这是天才的智慧的最可惊人的品质。"},{"famous_name":"约·德莱顿","famous_saying":"天才在社会生活中往往显得迟钝而"},{"famous_name":"雨果","famous_saying":"敢于冲撞命运才是天才"},{"famous_name":"卡莱尔","famous_saying":"所谓天才，就是比任何人都先抵挡痛苦的经验本领。"},{"famous_name":"林肯","famous_saying":"卓越的天才不屑走一条人家走过的路。他寻找迄今没有开拓过的地区。"},{"famous_name":"席勒","famous_saying":"产生天才的土壤比天才还要难找"},{"famous_name":"爱因斯坦","famous_saying":"任何天才不能在孤独的状态中发展"},{"famous_name":"民谚","famous_saying":"名人的古怪行为是天才的标志，凡人的古怪行为是神经出了毛病"},{"famous_name":"鲁迅","famous_saying":"哪里有天才，我是把别人喝咖啡的工夫都用在了工作上了。"},{"famous_name":"塞涅夫","famous_saying":"没有某些发狂的劲头，就没有天才。"},{"famous_name":"狄德罗","famous_saying":"精神的浩瀚想象的活跃心灵的勤奋：就是天才。"},{"famous_name":"爱默生","famous_saying":"平凡的人希望，天才的人创造。"},{"famous_name":"契诃夫","famous_saying":"真正的天才是常常隐藏在群众里面，绝不挤向人前去露脸的。"},{"famous_name":"别林斯基","famous_saying":"任何天才，不经过艰苦不断的劳动，不经过最使空想家头疼和懊恼的最初纯物质和机械的劳动，就无法精通任何种类的艺术。"},{"famous_name":"杨格","famous_saying":"我愿意以天才比美德，以学问比财富。如美德越少的人，越需要财富，天才越低的人，越需要学问。"},{"famous_name":"巴尔扎克","famous_saying":"职业尽管不同，但天才的品德并无分别。"},{"famous_name":"恩格斯","famous_saying":"逆境使天才脱颖而出，顺境会埋没"},{"famous_name":"巴尔扎克","famous_saying":"破坏的人和建设的人，两者都是意志的现象：一个是准备工作，另一个是完成工作；前者好像是一个恶的天才，后者似乎是一个善的天才；对这一个给予光荣，对另一个给予忘却。恶者哇啦哇啦，把庸俗的人们从梦里惊醒，对他佩服得五体投地，可是善者却一直默不作声。"},{"famous_name":"培根","famous_saying":"如果孩子确有某种超群的天才，那当然应该扶植发展。但就一般情况说，下面这句格言很有用的：\u201c长期的训练会通过适应化难为易。\u201d"},{"famous_name":"爱迪生","famous_saying":"天才是百分之一的灵感，百分之九十九的血汗。"}]
* error_code : 0
* reason : Succes
*/

private int total;
private int error_code;
private String reason;
/**
* famous_name : 车尔尼雪夫斯基
* famous_saying : 非凡的单纯，非凡的明确——这是天才的智慧的最可惊人的品质。
*/

private List<ResultEntity> result;

public void setTotal(int total) {
this.total = total;
}

public void setError_code(int error_code) {
this.error_code = error_code;
}

public void setReason(String reason) {
this.reason = reason;
}

public void setResult(List<ResultEntity> result) {
this.result = result;
}

public int getTotal() {
return total;
}

public int getError_code() {
return error_code;
}

public String getReason() {
return reason;
}

public List<ResultEntity> getResult() {
return result;
}

public static class ResultEntity {
private String famous_name;
private String famous_saying;

public void setFamous_name(String famous_name) {
this.famous_name = famous_name;
}

public void setFamous_saying(String famous_saying) {
this.famous_saying = famous_saying;
}

public String getFamous_name() {
return famous_name;
}

public String getFamous_saying() {
return famous_saying;
}
}
}

FamousInfoReq

package test.ban.com.myapplication.bean;

import java.io.Serializable;

/**
* Created by ban
*/
public class FamousInfoReq implements Serializable{
public String apiKey;
public String keyword; //关键字
public int page;  //请求页数，默认page=1
public int rows;   //返回记录条数，默认rows=20,最大50

public String getApiKey() {
return apiKey;
}

public void setApiKey(String apiKey) {
this.apiKey = apiKey;
}

public String getKeyword() {
return keyword;
}

public void setKeyword(String keyword) {
this.keyword = keyword;
}

public int getPage() {
return page;
}

public void setPage(int page) {
this.page = page;
}

public int getRows() {
return rows;
}

public void setRows(int rows) {
this.rows = rows;
}
}

2、创建一个接口，返回 Call；如下：

package test.ban.com.myapplication.netApi;

import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Header;
import retrofit2.http.Query;
import test.ban.com.myapplication.bean.FamousInfo;

/**
* Created by ban
* 这里我们使用的是Retrofit 提供注解的方式来定义接口的
* @get后面我们填写需要访问对应的接口地址
* @Header用来添加Header
* @Query用来添加查询关键字
*/
public interface FamousService {
@GET("/avatardata/mingrenmingyan/lookup")
Call<FamousInfo> getFamousResult(@Header("apiKey") String apiKey,
@Query("keyword") String keyword,
@Query("page") int page,
@Query("rows") int rows);
}

3、定义Retrofit 网络接口服务的包装类 （基础类）

package test.ban.com.myapplication.utils;/**
* Created by apple on 16/8/23.
*/

import android.content.Context;

import retrofit2.GsonConverterFactory;
import retrofit2.Retrofit;

/**
* 定义Retrofit 网络接口服务的包装类
* 作者：ban on 16/8/23 15:55
*/
public class RetrofitWrapper {

private static RetrofitWrapper instance;
private Context mContext;
private Retrofit mRetrofit;

private RetrofitWrapper(){
//创建retrofit
mRetrofit = new Retrofit.Builder().baseUrl(Constant.BASEURL)
.addConverterFactory(GsonConverterFactory.create())
.build();
}

/**
* 单例模式 获取唯一的网络接口服务的包装类RetrofitWrapper
* @return
*/
public static RetrofitWrapper getInstance(){
if(instance == null){
synchronized (RetrofitWrapper.class){
if (instance == null) {
instance = new RetrofitWrapper();
}
}
}
return instance;
}

/**
* 抽取一层 在创建retrofit时,只需要传入不同的service(对应创建不同的接口),即可完成创建不同的retrofit,
* =====================================例子如下: ============================================
* FamousService mFamousService = RetrofitWrapper.getInstance().create(FamousService.class);
* =========================================================================================
* @param service
* @param <T>
* @return
*/
public <T> T create(final Class<T> service){
return mRetrofit.create(service);
}

}

4、网络服务的包装类定义好了之后，在定义一个访问的Model

package test.ban.com.myapplication.model;/**
* Created by apple on 16/8/23.
*/

import android.content.Context;

import retrofit2.Call;
import test.ban.com.myapplication.bean.FamousInfo;
import test.ban.com.myapplication.bean.FamousInfoReq;
import test.ban.com.myapplication.netApi.FamousService;
import test.ban.com.myapplication.utils.RetrofitWrapper;

/**
* 网络服务的包装类定义好了之后，在定义一个访问的Model。
* 即:定义了相对应的外层方法。底层的包装类不会改变,只会根据不同的类做响应的事情。
* 作者：ban on 16/8/23 16:02
*/
public class FamousInfoModel {

private static FamousInfoModel sFamousInfoModel;
private FamousService mFamousService;

public static FamousInfoModel getInstance(Context context){
if(sFamousInfoModel == null){
sFamousInfoModel = new FamousInfoModel(context);
}
return sFamousInfoModel;
}

private FamousInfoModel (Context context){
mFamousService  = RetrofitWrapper.getInstance().create(FamousService.class);

}

public Call<FamousInfo> queryLookUp(FamousInfoReq famousInfoReq){
Call<FamousInfo> infoCall = mFamousService.getFamousResult(famousInfoReq.apiKey,
famousInfoReq.keyword,famousInfoReq.page,famousInfoReq.rows);
return infoCall;
}
}

5、使用

package test.ban.com.myapplication;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.view.View;
import android.widget.EditText;
import android.widget.ImageButton;
import android.widget.TextView;
import android.widget.Toast;

import java.util.List;

import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
import test.ban.com.myapplication.bean.FamousInfo;
import test.ban.com.myapplication.bean.FamousInfoReq;
import test.ban.com.myapplication.model.FamousInfoModel;
import test.ban.com.myapplication.utils.Constant;

public class MainActivity extends AppCompatActivity {

public final String TAG = this.getClass().getName();
private FamousInfoModel mfamousInfoModel;
private EditText mEditKeyWord;
private ImageButton mSerachBtn;
private TextView mTxtContent;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mfamousInfoModel = FamousInfoModel.getInstance(getApplicationContext());
initView();
initParams();
initEvent();
}

/**
* 初始化View
*/
private void initView() {
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
// setSupportActionBar(toolbar);
mEditKeyWord = (EditText) findViewById(R.id.edit_keyword);
mSerachBtn = (ImageButton) findViewById(R.id.button_search);
mTxtContent = (TextView) findViewById(R.id.txt_content);

}

/**
* 初始化参数
*/
private FamousInfoReq initParams() {
FamousInfoReq mFamousInfoReq = null;
mFamousInfoReq = new FamousInfoReq();
mFamousInfoReq.apiKey = Constant.APIKEY;
mFamousInfoReq.keyword = mEditKeyWord.getText().toString();
mFamousInfoReq.page = 3;
mFamousInfoReq.rows = 30;
return mFamousInfoReq;
}

/**
* 使用分为四步:
* <p>
* -- 创建Retrofit对象
* -- 创建访问API的请求
* -- 发送请求
* -- 处理结果
* <p>
* 主要代码如下：
*/
public void initEvent() {
mSerachBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Call<FamousInfo> famousInfoCall = mfamousInfoModel.queryLookUp(initParams());

famousInfoCall.enqueue(new Callback<FamousInfo>() {
@Override
public void onResponse(Call<FamousInfo> call, Response<FamousInfo> response) {
if (response.isSuccess()) {
FamousInfo info = response.body();
if (info != null) {
List<FamousInfo.ResultEntity> entity = info.getResult();
mTxtContent.setText("1、" + entity.get(0).getFamous_saying() +
"\n---" + entity.get(0).getFamous_name() + "\n 2、"
+ entity.get(1).getFamous_saying() + "\n---" + entity
.get
(1).getFamous_name());
}
}
}

@Override
public void onFailure(Call<FamousInfo> call, Throwable t) {
Toast.makeText(MainActivity.this, "onFaile-retrofit", Toast.LENGTH_SHORT)
.show();
}
});
}
});
}
}

其它用到的类等

package test.ban.com.myapplication.utils;

/**
* Created by ban
*/
public class Constant {
public  static String BASEURL="http://apis.baidu.com"; //服务器地址
public  static String APIKEY="4c4f0c3c49e09d5578ae0ba49fa84a97";
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true"
tools:context=".MainActivity">

<android.support.design.widget.AppBarLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:theme="@style/AppTheme.AppBarOverlay">

<android.support.v7.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
app:popupTheme="@style/AppTheme.PopupOverlay" />

</android.support.design.widget.AppBarLayout>

<include layout="@layout/content_main" />

</android.support.design.widget.CoordinatorLayout>

content_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:layout_behavior="@string/appbar_scrolling_view_behavior"
tools:context=".ui.activity.MainActivity"
tools:showIn="@layout/activity_main">

<RelativeLayout
android:id="@+id/search_layout"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/colorPrimary"
android:gravity="center_vertical"
android:orientation="horizontal">

<EditText
android:id="@+id/edit_keyword"
android:layout_width="match_parent"
android:layout_height="50dp"
android:paddingLeft="10dp"
android:layout_toLeftOf="@+id/button_search"
android:layout_weight="1"
android:hint="请输入名人名言的关键字"
android:textColorHint="#FFFFFF"
android:textColor="#ffffff" />

<ImageButton
android:id="@+id/button_search"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentRight="true"
android:layout_centerVertical="true"
android:layout_marginLeft="5dp"
android:layout_marginRight="15dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:src="@mipmap/ic_search_white_36dp" />
</RelativeLayout>
<RelativeLayout
android:layout_below="@id/search_layout"
android:layout_width="match_parent"
android:layout_height="wrap_content">

<TextView
android:id="@+id/txt_content"
android:layout_width="match_parent"
android:layout_height="wrap_content" />

</RelativeLayout>

</RelativeLayout>

ic_search_white_36dp.png