包名變化

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中用到，升級的時候需要注意 [email protected]註解在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);}

以上就是我升級的過程，如有問題和錯誤請留言