retrofit的实现原理(一)

retrofit框架实现的这么巧妙,虽然我们不需要再造一个轮子,但研究下轮子的实现还是很有帮助的.

retrofit有几个关键的地方.

1.用户自定义的接口和接口方法.(由动态代理创建对象.)

2.converter转换器.(把response转换为一个具体的对象)

3.注解的使用.

 

让我们跟随Api来看吧.

RestAdapter restAdapter = new RestAdapter.Builder().setEndpoint(API_URL).build(); 

　　build()其内部实现是这样的:

1 2 3 4 5 6 7 8

public RestAdapter build() {      if (endpoint == null) {        throw new IllegalArgumentException("Endpoint may not be null.");      }      ensureSaneDefaults();      return new RestAdapter(endpoint, clientProvider, httpExecutor, callbackExecutor,          requestInterceptor, converter, profiler, errorHandler, log, logLevel);    }

　　当用户没有设置自定义的converter,client, httpExecutor(http访问执行的线程-->只对异步的retrofit有效.), callBackExecutor(异步的callBack执行的线程), errorHandler, log, RequestInterceptor的时候,就会使用retrofit默认的配置.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

private void ensureSaneDefaults() {     if (converter == null) {       converter = Platform.get().defaultConverter();     }     if (clientProvider == null) {       clientProvider = Platform.get().defaultClient();     }     if (httpExecutor == null) {       httpExecutor = Platform.get().defaultHttpExecutor();     }     if (callbackExecutor == null) {       callbackExecutor = Platform.get().defaultCallbackExecutor();     }     if (errorHandler == null) {       errorHandler = ErrorHandler.DEFAULT;     }     if (log == null) {       log = Platform.get().defaultLog();     }     if (requestInterceptor == null) {       requestInterceptor = RequestInterceptor.NONE;     }   } }

　　Platform.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

private static final Platform PLATFORM = findPlatform();   static Platform get() {   return PLATFORM; }   private static Platform findPlatform() {   try {     Class.forName("android.os.Build");//只要android.os.Build的class可以正常找到,证明是在android平台     if (Build.VERSION.SDK_INT != 0) {       return new Android();     }   } catch (ClassNotFoundException ignored) {   }     if (System.getProperty("com.google.appengine.runtime.version") != null) {     return new AppEngine();   //google的app Engine平台   }     return new Base(); }

retrofit的Android类继承了Platform, 根据android的特性对配置项做了处理.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42

private static class Android extends Platform {     @Override Converter defaultConverter() {       return new GsonConverter(new Gson());  //默认的转换器是Gson     }       @Override Client.Provider defaultClient() {       final Client client;       if (hasOkHttpOnClasspath()) {  //有okhttp的路径就使用 Okhttp         client = OkClientInstantiator.instantiate();       } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.GINGERBREAD) {         client = new AndroidApacheClient(); //没有okhttp,且版本小于2.3 使用HttpClient       } else {         client = new UrlConnectionClient();  //没有okhttp,且版本大于等于2.3 使用urlConnection.       }       return new Client.Provider() {         @Override public Client get() {           return client;         }       };     }       @Override Executor defaultHttpExecutor() {   //网络访问执行的线程.       return Executors.newCachedThreadPool(new ThreadFactory() {  //一个cached的线程池.可以复用老线程且线程长时间不用会自动回收. 线程池中线程不够会生成新线程.         @Override public Thread newThread(final Runnable r) {           return new Thread(new Runnable() {             @Override public void run() {               Process.setThreadPriority(THREAD_PRIORITY_BACKGROUND);    //设置线程的优先级 为最低               r.run();             }           }, RestAdapter.IDLE_THREAD_NAME);         }       });     }       @Override Executor defaultCallbackExecutor() { //异步执行的线程.       return new MainThreadExecutor();     }       @Override RestAdapter.Log defaultLog() {  //通过Log.d("Retrofit",String)打印log       return new AndroidLog("Retrofit");     }   }

1 2 3 4 5 6 7 8

private static boolean hasOkHttpOnClasspath() {   try {     Class.forName("com.squareup.okhttp.OkHttpClient"); //是否可以找到OkHttpClient类.     return true;   } catch (ClassNotFoundException ignored) {   }   return false; }

可以发现上面默认的Http的Executor是一个线程池.

而CallBack的Executor是在主线程执行的. 由绑定MainLooper的Handler提交到主线程执行.

1 2 3 4 5 6 7

public final class MainThreadExecutor implements Executor {   private final Handler handler = new Handler(Looper.getMainLooper()); //关联主线程的Handler     @Override public void execute(Runnable r) {     handler.post(r);                                 //提交到主线程执行   } }

1 2 3 4

public final boolean post(Runnable r)     {        return  sendMessageDelayed(getPostMessage(r), 0);     }

1 2 3 4 5

private static Message getPostMessage(Runnable r) {   //把runnable封装到Message中.       Message m = Message.obtain();       m.callback = r;       return m;   }