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

包名变化

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

而到3.0之后变成：okhttp3.*

retrofit2.0之前：retrofit.*

retrofit2.0之后：retrofit2.*

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

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

[java]  view plain  copy

 

1. public class MainRetrofit {  
2.   
3.     final MeoHttp mService;  
4.     final Gson gson = new GsonBuilder().setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'").serializeNulls().create();  
5.     RequestInterceptor requestInterceptor = new RequestInterceptor() {  
6.         @Override  
7.         public void intercept(RequestFacade request) {  
8.             request.addHeader("User-Agent", AppConstants.USER_AGENT);  
9.             request.addHeader("X-Requested-With", "XMLHttpRequest");  
10.             request.addHeader("Cookie", AppConstants.PHPSESSID);  
11.   
12.         }  
13.     };  
14.     MainRetrofit() {  
15.         OkHttpClient client = new OkHttpClient();  
16.         client.setReadTimeout(41, TimeUnit.SECONDS);  
17.         RestAdapter restAdapter = new RestAdapter.Builder()  
18.                 .setClient(new OkClient(client))  
19.                 .setEndpoint(MainFactory.HOST)  
20.                 .setConverter(new GsonConverter(gson))  
21.                 .setLogLevel(RestAdapter.LogLevel.NONE)  
22.                 .setRequestInterceptor(requestInterceptor)  
23.                 .build();  
24.         mService = restAdapter.create(MeoHttp.class);  
25.      
26.     }  
27.   
28.     public MeoHttp getService(){  
29.         return mService;  
30.     }  
31.   
32. }  

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

[java]  view plain  copy

 

1. final RequestApi api;  
2.    final Gson gson = new GsonBuilder().setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'").serializeNulls().create();  
3.    Interceptor requestInterceptor;  
4.    private static final okhttp3.OkHttpClient.Builder httpClient = new OkHttpClient.Builder();  
5.    public MainRetrofit(final boolean hasCookie) {  
6.        httpClient.readTimeout(60, TimeUnit.SECONDS).  
7.                connectTimeout(2, TimeUnit.SECONDS).build();  
8.        requestInterceptor = new Interceptor() {  
9.            @Override  
10.            public Response intercept(Chain chain) throws IOException {  
11.                Request request = chain.request();  
12.                String cookie = "";  
13.                if (hasCookie) {  
14.                    cookie = AppConfig.Net.COOKIE_HEAD + CookieManager.getCookie();  
15.                }  
16.                Request compressedRequest = request.newBuilder()  
17.                        .header("Cookie", cookie)  
18.                        .header("Accept-Language", Locale.getDefault().toString())  
19.                        .header("Accept-Charset", "utf-8")  
20.                        .header("Connection", "Keep-Alive")  
21.                        .header("User-Agent", getUserAgent())  
22.                        .build();  
23.                Response response = chain.proceed(compressedRequest);  
24.                return response;  
25.            }  
26.        };  
27.        httpClient.interceptors().add(requestInterceptor);  
28.        OkHttpClient okHttpClient = httpClient.build();  
29.        Retrofit client = new Retrofit.Builder()  
30.                .baseUrl(AppConfig.Net.HOST)  
31.                .addConverterFactory(new ScalarsConverterFactory())  
32.                .addConverterFactory(GsonConverterFactory.create(gson))  
33.                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())  
34.                .client(okHttpClient)  
35.                .build();  
36.        //retrofit 没有日志打印功能  
37.        /*if (AppConfig.IS_DEVELOPING) { 
38.            //日志可用 
39.            client.setLogLevel(RestAdapter.LogLevel.FULL); 
40.        } else { 
41.            client.setLogLevel(RestAdapter.LogLevel.NONE); 
42.        }*/  
43.        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
@POST
Call<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
@POST
Call<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);}

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