升级okhttp3.0+和retrofit2.0+的过程以及遇到的坑

包名变化

okhttp3.0之前是：com.squareup.okhttp.*，

而到3.0之后变成：okhttp3.*

retrofit2.0之前：retrofit.*

retrofit2.0之后：retrofit2.*

都在末尾增加了版本号，显示的更专业，但是这也给我们升级带来了麻烦。

首先看一下retrofit1.9+okhttp2.2的配置代码

public class MainRetrofit {    final MeoHttp mService;    final Gson gson = new GsonBuilder().setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'").serializeNulls().create();    RequestInterceptor requestInterceptor = new RequestInterceptor() {        @Override        public void intercept(RequestFacade request) {            request.addHeader("User-Agent", AppConstants.USER_AGENT);            request.addHeader("X-Requested-With", "XMLHttpRequest");            request.addHeader("Cookie", AppConstants.PHPSESSID);        }    };    MainRetrofit() {        OkHttpClient client = new OkHttpClient();        client.setReadTimeout(41, TimeUnit.SECONDS);        RestAdapter restAdapter = new RestAdapter.Builder()                .setClient(new OkClient(client))                .setEndpoint(MainFactory.HOST)                .setConverter(new GsonConverter(gson))                .setLogLevel(RestAdapter.LogLevel.NONE)                .setRequestInterceptor(requestInterceptor)                .build();        mService = restAdapter.create(MeoHttp.class);       }    public MeoHttp getService(){        return mService;    }}

okhttp3.0以及retrofit2.0均采用了builder构建者模式配置

 final RequestApi api;    final Gson gson = new GsonBuilder().setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'").serializeNulls().create();    Interceptor requestInterceptor;    private static final okhttp3.OkHttpClient.Builder httpClient = new OkHttpClient.Builder();    public MainRetrofit(final boolean hasCookie) {        httpClient.readTimeout(60, TimeUnit.SECONDS).                connectTimeout(2, TimeUnit.SECONDS).build();        requestInterceptor = new Interceptor() {            @Override            public Response intercept(Chain chain) throws IOException {                Request request = chain.request();                String cookie = "";                if (hasCookie) {                    cookie = AppConfig.Net.COOKIE_HEAD + CookieManager.getCookie();                }                Request compressedRequest = request.newBuilder()                        .header("Cookie", cookie)                        .header("Accept-Language", Locale.getDefault().toString())                        .header("Accept-Charset", "utf-8")                        .header("Connection", "Keep-Alive")                        .header("User-Agent", getUserAgent())                        .build();                Response response = chain.proceed(compressedRequest);                return response;            }        };        httpClient.interceptors().add(requestInterceptor);        OkHttpClient okHttpClient = httpClient.build();        Retrofit client = new Retrofit.Builder()                .baseUrl(AppConfig.Net.HOST)                .addConverterFactory(new ScalarsConverterFactory())                .addConverterFactory(GsonConverterFactory.create(gson))                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())                .client(okHttpClient)                .build();        //retrofit 没有日志打印功能        /*if (AppConfig.IS_DEVELOPING) {            //日志可用            client.setLogLevel(RestAdapter.LogLevel.FULL);        } else {            client.setLogLevel(RestAdapter.LogLevel.NONE);        }*/        api = client.create(RequestApi.class);

而且retrofit2.0没有打印日志的功能，所以只能在okhttp的拦截器里打印日志

retrofit1.9的接口调用方式：

GET:

/** * 获得用户地址 */@GET("/user/Address?")void getAddress(Callback<AddressInfo>callback);

POST:

/** * 上传画作 * @param content 图集描述 * @param atk token值 * @param file 文件 */@Multipart@POST("/user/uploadPicture?")void upLoadPaint(@Part("content")String content, @Part("t")String atk,                 @Part("upfile") TypedFile file, Callback<BaseResponse> callback);

而对应2.0之后的方式是这样的

GET:

/** * 获得用户地址 */@GET("/user/Address?")Calll<AddressInfo> getAddress();

POST：

/** * 上传画作 * @param content 图集描述 * @param atk token值 * @param file 文件 */@Multipart@POST("/user/uploadPicture?")
Call<BaseResponse> upLoadPaint(@Part("content")String content, @Part("t")String atk,
                 @Part("upfile") RequestBody body);

大致的升级过程算是完成了

接下来讲讲有什么坑：

1.纯粹使用retrofit接口返回不能是void ,而是相对应了Call<T>，接口的实现不在是直接使用Call回调，而是用getAddress().enqueue(new CallBack)

  这里面的变动有点大，如果没做好回调函数的封装，那升级的工作量就有点大了,这样返回一个call可以用于取消请求。

2.在Retrofit 1.9中，如果获取的 response 不能背解析成定义好的对象，则会调用failure。但是在Retrofit 2.0中，不管 response 是否能被解析。onResponse总是会被调用。但是在结果不能被解析的情况下，response.body()会返回null。别忘了处理这种情况。

如果response存在什么问题，比如404什么的，onResponse也会被调用。你可以从response.errorBody().string()中获取错误信息的主体。

3.retrofit2.0去掉了一些类：RetrofitError,TypeFile MultipartTypedOutput，如果在1.9中用到，升级的时候需要注意

4.@Path注解在1.9的时候使用方式：

@Path(value="url", encode=false) String url

2.0时会导致encoded失效，此时推荐使用@Url动态替换url地址

@Multipart@POSTCall<String>  upload(@Url String url,            @PartMap Map<String, RequestBody> params);

5.多图片上次的坑：MultipartTypedOutput,以及TypeFile在2.0之后被去除了

1.9的多图片上传方式：

/** * @param multipartTypedOutput 多个参数加载 */@POST("/user/applyPainting?")void request2BePaint(@Body MultipartTypedOutput multipartTypedOutput,Callback<BaseResponse> callback);

multipartTypedOutput组装：

MultipartTypedOutput multipartTypedOutput = new MultipartTypedOutput();multipartTypedOutput.addPart("t",new TypedString(painter.atk));multipartTypedOutput.addPart("content",new TypedString(painter.content));for (int i=0;i<painter.fileImages.length;i++){   multipartTypedOutput.addPart("upfile["+i+"]",new TypedFile("image/jpeg", new File(painter.fileImages[i])));}

相对于简单些，而到2.0之后就感觉很繁琐

/** * 上传文件 */@Multipart@POSTCall<String>  upload(@Url String url,            @PartMap Map<String, RequestBody> params);

组装map以及RequestBody

RequestBody requestFile = null;Map<String, RequestBody>  photos = new HashMap<>();for (int i = 0; i < formFiles.size(); i++) {        //生成临时压缩图片文件    final File tempFile = FileUtils.createFile(AppConfig.MAIN_DIR_IMG,            "IMG_TEMP_" + System.currentTimeMillis() + ".jpg");    Bitmap bitmap = PhotoUtils.compressBitmap(formFiles.get(i).getFile().getPath());    FileOutputStream fos = new FileOutputStream(tempFile);    bitmap.compress(Bitmap.CompressFormat.JPEG, quality, fos);    requestFile = RequestBody.create(MediaType.parse("multipart/form-data"), tempFile);    photos.put("AttachmentKey"+i+"\"; filename=\""+keys.get(i),requestFile);}

以上就是我升级的过程，如有问题和错误请留言