Retrofit 2.1 笔(基础)

Android 网路请求框架

一、自定义RetrofitManage类

0.添加Retrofit2的依赖
compile 'com.squareup.retrofit2:retrofit:2.1.0'
1.Retrofit的获取
Retrofit retrofit = new Retrofit.Builder()
    // 服务器请求URL
    .baseUrl("http://192.168.1.100/apiServer/")
    // 添加Gson转换器 需添加依赖 'com.squareup.retrofit2:converter-gson:2.1.0'
    .addConverterFactory(GsonConverterFactory.create())
    // OkHttp3 对象
    .client(client)
    .build();

Retrofit2 已支持的转换器(除此之外可以自定义Converter)

类型 依赖

Gson | com.squareup.retrofit2:converter-gson
Jackson | com.squareup.retrofit2:converter-jackson
Moshi | com.squareup.retrofit2:converter-moshi
Protobuf | com.squareup.retrofit2:converter-protobuf
Wire | com.squareup.retrofit2:converter-wire
Simple XML | com.squareup.retrofit2:converter-simplexml
Scalars (primitives, boxed, and String) | com.squareup.retrofit2:converter-scalars

2.OkHttpClient的获取
// OkHttp3 配置
OkHttpClient client = new OkHttpClient.Builder()
    // 添加拦截器
    .addInterceptor(authInterceptor)
    // 连接超时时间
    .connectTimeout(7676, TimeUnit.SECONDS)
    // 读取时间
    .readTimeout(7676, TimeUnit.SECONDS)
    .build();

// addInterceptor : 设置应用拦截器,可用于设置公共参数,头信息,日志拦截等
// connectTimeout : 设置超时时间
// readTimeout : 设置读取时间
3.Interceptor(拦截器)的创建

实现步骤:

  • 继承Interceptor类

  • 重写intercept方法

  • 继续执行拦截的请求则 return chain.proceed();

    package com.demon.retrofit20.http;

    import java.io.IOException;

    import okhttp3.Interceptor;
    import okhttp3.Request;
    import okhttp3.Response;

    /**

    • @author Demon

    • @version V1.0

    • @Description: OkHttpClient 授权拦截器

    • @date 2016年10月13日11:22:43
      */
      public class OAuthInterceptor implements Interceptor {

      static String PHONE;
      static String TOKEN;

      public OAuthInterceptor(String phone, String token) {
      PHONE = phone;
      TOKEN = token;
      }

      /**

      • 1.仅添加请求头
        */
        @Override
        public Response intercept(Chain chain) throws IOException {
        if (PHONE == null || TOKEN == null) {
        Request request = chain.request();
        return chain.proceed(request);
        } else {
        // 凭证
        String credentials = PHONE + "&" + TOKEN;
        Request authorised = chain.request().newBuilder()
        // 请求头添加验证
        .header("Authorization", credentials)
        .build();
        // 继续进行这个请求
        return chain.proceed(authorised);
        }
        }

      /**

      • 2.添加请求头+请求体 / 请求体
        @Override
        public Response intercept(Chain chain) throws IOException {
        // 获取构建的请求
        Request.Builder builder = chain.request().newBuilder();
        // 添加请求头内容
        builder.addHeader("Authorization", "demon");

        // 创建一个新的请求体
        RequestBody formBody = new FormBody.Builder()
        .add("validateCode", "aiybybz@163.com")
        .build();

        // 请求添加请求体
        builder.put(formBody);

        // 继续进行这个请求
        return chain.proceed(builder.build());
        }
        */
        }

4.自定义RetrofitManage整体代码展示
package com.demon.retrofit20.http;

import java.util.concurrent.TimeUnit;

import okhttp3.OkHttpClient;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

/**
 * @author Demon
 * @version V1.0
 * @Description: Retrofit2.0 管理类
 * @date 2016年10月13日11:22:43
 */
public class RetrofitManage {

    /**
     * HTTP 请求地址
     **/
    private final String API_URL = "http://192.168.1.100/apiServer/";
    /**
     * 网络请求api
     */
    private RetrofitService api;

    private static RetrofitManage retrofitManage = null;

    /**
     * 静态工厂方法(单例)
     *
     * @return RetrofitManage
     */
    public synchronized static RetrofitManage getInstance() {
        if (retrofitManage == null) {
            retrofitManage = new RetrofitManage();
        }
        return retrofitManage;
    }

    /**
     * 构造方法
     */
    private RetrofitManage() {
        // 实例化授权拦截器
        OAuthInterceptor authInterceptor = new OAuthInterceptor(null, null);

        // OkHttp3 配置
        OkHttpClient client = new OkHttpClient.Builder()
                // 添加拦截器
                .addInterceptor(authInterceptor)
                // 连接超时时间
                .connectTimeout(7676, TimeUnit.SECONDS)
                // 读取时间
                .readTimeout(7676, TimeUnit.SECONDS)
                .build();

        // addInterceptor : 设置应用拦截器,可用于设置公共参数,头信息,日志拦截等
        // connectTimeout : 设置超时时间
        // readTimeout : 设置读取时间

        // 需添加依赖 'com.squareup.retrofit2:retrofit:2.1.0'
        Retrofit retrofit = new Retrofit.Builder()
                // 服务器请求URL
                .baseUrl(API_URL)
                // 添加Gson转换器 需添加依赖 'com.squareup.retrofit2:converter-gson:2.1.0'
                .addConverterFactory(GsonConverterFactory.create())
                // OkHttp3 对象
                .client(client)
                .build();

        // 获取Proxy.newProxyInstance动态代理对象
        api = retrofit.create(RetrofitService.class);
    }

    /**
     * 外部获取 RetrofitService
     * @return
     */
    public RetrofitService getApi() {
        return api;
    }
}

二、编写接口RetrofitService 常用方法

1.常用方法编写
  • 数据请求

      /**
       * 个人信息(改造前)
       * @param     userId 用户Id
       * @return     ResponseBody
       */
      @POST("userInfo")
      Call<ResponseBody> userInfoB(@Query("userId") String userId);
    
  • 上传文件

      /**
       * 上传文件(改造前)
       * @param makeThum String
       * @param file MultipartBody.Part
       * @return ResponseBody
       */
      @Multipart
      @POST("http://192.168.1.1/recycleImgServer/uploadFile")
      Call<ResponseBody> uploadFileB(@Query("makeThum")String makeThum, @Part MultipartBody.Part file);
    
2.完整代码展示
package com.demon.retrofit20.http;

import okhttp3.MultipartBody;
import okhttp3.ResponseBody;
import retrofit2.Call;
import retrofit2.http.Multipart;
import retrofit2.http.POST;
import retrofit2.http.Part;
import retrofit2.http.Query;

/**
 * @author Demon
 * @version 1.0
 * @Description Retrofit 2.0 网络请求API
 * @date 2016年10月13日13:54:01
 */
public interface RetrofitService {

    /**
     * 个人信息(改造前)
     * @param     userId 用户Id
     * @return     ResponseBody
     */
    @POST("userInfo")
    Call<ResponseBody> userInfoB(@Query("userId") String userId);

    /**
     * 上传文件(改造前)
     * @param makeThum String
     * @param file MultipartBody.Part
     * @return ResponseBody
     */
    @Multipart
    @POST("http://192.168.1.1/recycleImgServer/uploadFile")
    Call<ResponseBody> uploadFileB(@Query("makeThum")String makeThum, @Part MultipartBody.Part file);

}

三、RetrofitService调用

1.RetrofitService获取
/**
 * 网络请求API对象
 */
private RetrofitService api;

private void initHttp() {
    api = RetrofitManage.getInstance().getApi();
}
3.同步请求
Repo repo = call.execute();

以上的代码会阻塞线程,不能在安卓的主线程中调用,不然会NetworkOnMainThreadException。
如果想调用execute方法,请在后台线程执行。

2.异步请求
/**
 * 获取个人信息(改造前)
 */
private void userInfoB() {
    // 调用接口方法
    Call<ResponseBody> call = api.userInfoB("103");
    // 异步请求
    call.enqueue(new Callback<ResponseBody>() {
        // 异步请求 需要Callback回调
        @Override
        public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
            Toast.makeText(getApplicationContext(), response.body().toString(), Toast.LENGTH_LONG).show();
        }

        @Override
        public void onFailure(Call<ResponseBody> call, Throwable t) {
            Toast.makeText(getApplicationContext(), t.toString(), Toast.LENGTH_LONG).show();
        }
    });

    // 关闭请求
    // call.clone();
    // call只能调用一次。否则会抛 IllegalStateException

    // 取消
    // call.cancel();
}

2016/10/19 00:58:32
代码地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,122评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,070评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,491评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,636评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,676评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,541评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,292评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,211评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,655评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,846评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,965评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,684评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,295评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,894评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,012评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,126评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,914评论 2 355

推荐阅读更多精彩内容