Android 框架 Retrofit+Rxjava+Glide 经典使用

katal 7年前
   <h2><strong>EasyFrame 3.0.0 网络框架使用说明</strong></h2>    <p>EasyFrame3.0.0 是采用 RxJava 和 Retrofit 实现的网络处理架构,采用 Glide 作为图片处理架构。极大的简化了APP开发中的框架搭建,library项目已经上传 Jcenter 和 Maven 库。</p>    <h3><strong>Jcenter:</strong></h3>    <pre>  <code class="language-java">compile 'com.qy.easyframe:easyframe:3.0.0'</code></pre>    <h3><strong>Maven:</strong></h3>    <pre>  <code class="language-java"><dependency>    <groupId>com.qy.easyframe</groupId>    <artifactId>easyframe</artifactId>    <version>3.0.0</version>    <type>pom</type>  </dependency></code></pre>    <h3><strong>使用方法:</strong></h3>    <p>一.网络请求的回调接口为ResultSubscriber.OnResultListener在请求网络的界面或者业务逻辑中实现此接口并实现接口的三个方法,分别是:</p>    <pre>  <code class="language-java">/**       * 网络请求订阅开始       */      void onStart(int requestType);        /**       * 网络请求错误       */      void onError(int requestType,Throwable e);        /**       * 处理请求结果       */      void onResult(IModel model, int requestType);</code></pre>    <p>三个方法看名字就知道对应的功能,其中 requestType 字段为不同网络请求的标示,可以自行区分。IModel 类为返回的json字段对应的 JavaBean 类的公共父类,所有的 Response 的类,都要继承 IModel 类。</p>    <p>二.定义你的针对 Retrofit 的网络请求接口,如下:</p>    <pre>  <code class="language-java">/**   * @Author: qiyuan   * @Data: 16/4/12 下午2:57   * @Description:  网络请求接口   */  public interface INetInterface {      /**       * get 请求       * @param city       * @return       */      @GET("data/cityinfo/{city_id}")      Observable<WeatherResponse> getWeather(@Path("city_id") String city);        /**       * post 请求       * @param body javabean请求体       * @return       */      @POST("data/cityinfo/")      Observable<WeatherResponse> postWeather(@Body WeatherRequest body);        /**       * post请求       * @param params 表单       * @return       */      @POST("data/cityinfo/")      Observable<WeatherResponse> postWeather2(@FieldMap Map<String, String> params);  }</code></pre>    <p>如上接口,需要自定义的地方有:</p>    <ul>     <li>请求方式的注解内的字符串,替换成自己的除主机地址外的地址或者全地址(通常是除主机外的地址)</li>     <li>Observable中的泛型,是网络请求响应回来的json字符串对应的JavaBean对象,统一继承IModel父类</li>     <li>方法名当然是自己起名字啦。。 <p>注意</p> 此接口不能有继承关系</li>    </ul>    <p>三.定义第二步网络请求接口的实现类,如下:</p>    <pre>  <code class="language-java">/**   * @Author: qiyuan   * @Data: 16/10/25 下午3:24   * @Description: HTTP请求实现类   */    public class HttpRequest {        public HttpRequest() {      }        /**       * 单例控制器       */      private static class SingletonHolder {          private static final HttpRequest INSTANCE = new HttpRequest();      }      /**       * 获取单例对象       *       * @return       */      public static HttpRequest getInstance() {          return HttpRequest.SingletonHolder.INSTANCE;      }        /**       * get获取网络数据的方法       *       * @param cityId       */      public Subscriber getWeather(String cityId, int resultType, ResultSubscriber.OnResultListener listener) {          Observable<WeatherResponse> observable = HTTPHelper.getInstance().init(Constant.BASE_PATH, INetInterface.class).getWeather(cityId);          return HTTPHelper.getInstance().doRequest(observable, resultType, listener);      }        /**       * post获取网络数据的方法       *       * @param body       */      public Subscriber postWeather(WeatherRequest body, int resultType, ResultSubscriber.OnResultListener listener) {          Observable<WeatherResponse> observable = HTTPHelper.getInstance().init(Constant.BASE_PATH, INetInterface.class).postWeather(body);          return HTTPHelper.getInstance().doRequest(observable, resultType, listener);      }        /**       * 自定义headers       * @param cityId       * @param resultType       * @param listener       * @return       */      public Subscriber getRecommendDetails(String cityId, int resultType, ResultSubscriber.OnResultListener listener) {          Map<String, String> map = new HashMap<>();          map.put("X-Token", "595a6e93-bddb-47af-a7ce-e63801315fd9");  //        Headers headers = Headers.of(map);  //        Observable<T> observable = (Observable<T>)     HTTPHelper.getInstance().init(Constant.BASE_PATH, INetInterface.class, headers).getRecommendDetails(assetId);          Observable<WeatherResponse> observable = HTTPHelper.getInstance().init(Constant.BASE_PATH, INetInterface.class, map).getWeather(cityId);          return HTTPHelper.getInstance().doRequest(observable, resultType, listener);      }    }</code></pre>    <p>此类是对第二步接口类的实现,具体接口得实现是在</p>    <pre>  <code class="language-java">HTTPHelper.getInstance().init(Constant.BASE_PATH, INetInterface.class)</code></pre>    <p>方法中操作,只需要讲第二步中的接口得class对象传入即可。</p>    <pre>  <code class="language-java">HTTPHelper.getInstance().doRequest(observable, resultType, listener)</code></pre>    <p>此方法返回Subscriber对象,可以用此对象来中断网络操作,比如在界面销毁时中断。</p>    <p>Activity或者Fragment或者其他业务中的使用</p>    <pre>  <code class="language-java">比如demo中的点击事件中,直接调用上一步的接口实现类的方法,并传递对应参数。  mButton.setOnClickListener(new View.OnClickListener() {          @Override          public void onClick(View v) {              Log.i(TAG,"onClick");              HttpRequest.getInstance().getWeather("101010300.html",CODE,MainActivity.this);          }      });</code></pre>    <p>总结</p>    <pre>  <code class="language-java">三步实现网络请求      1.实现ResultSubscriber.OnResultListener监听      2.实现对应网络请求的接口类      3.对接口类进行实现      4.由于library不能从BuildConfig中读取Debug状态,如果调试期间需要打印log日志,      可在Application中添加AppFrame.initDebug(true)方法</code></pre>    <h2><strong>HTTPHelper类中的初始化方法如下</strong></h2>    <pre>  <code class="language-java"><T extends IModel> Subscriber    doRequest(<any> observable, int resultType, ResultSubscriber.OnResultListener listener)  初始化观察者  static HTTPHelper getInstance()  获取单例对象  Interceptor    getInterceptor()  获取拦截器  <I> I    init(String baseUrl, Class<I> clazz)  初始化  <I> I    init(String baseUrl, Class<I> clazz, Headers headers)   <I> I    init(String baseUrl, Class<I> clazz, long timeOut)  初始化  <I> I    init(String baseUrl, Class<I> clazz, long timeOut, Headers headers)   HTTPHelper    setInterceptor(Interceptor mInterceptor)  设置拦截器</code></pre>    <h2><strong>Glide图片工具类使用方法及说明</strong></h2>    <pre>  <code class="language-java">static void initImageIcon(int id)   初始化默认的加载图  static void    into(android.content.Context context, File file, android.widget.ImageView view)  glide 从文件中加载图片  static void    into(android.content.Context context, File file, android.widget.ImageView view, int width, int height)  glide 通过指定的大小从文件中加载图片  static void    into(android.content.Context context, int resourceId, android.widget.ImageView view)  glide 从资源ID中加载图片  static void    into(android.content.Context context, int resourceId, android.widget.ImageView view, int width, int height)  glide 通过指定的大小从资源ID中加载图片  static void    into(android.content.Context context, String url, android.widget.ImageView view)  glide 从字符串中加载图片(网络地址或者本地地址)  static void    into(android.content.Context context, String url, android.widget.ImageView view, int defaultId)  glide 从字符串中加载图片(网络地址或者本地地址),  static void    into(android.content.Context context, String url, android.widget.ImageView view, int width, int height)  glide 通过指定的大小从字符串中加载图片(网络地址或者本地地址)  static void    into(android.content.Context context, android.net.Uri uri, android.widget.ImageView view)  glide 从URI中加载图片  static void    into(android.content.Context context, android.net.Uri uri, android.widget.ImageView view, int width, int height)  glide 通过指定的大小从Uri中加载图片  static void    intoBlur(android.content.Context context, String url, android.widget.ImageView view)  高斯模糊图片处理  static void    intoDefault(android.content.Context context, int id, android.widget.ImageView view)  默认glide,不做任何处理  static void    intoDefault(android.content.Context context, String url, android.widget.ImageView view)  默认glide,不做任何处理  static void    intoRound(android.content.Context context, int id, int radius, android.widget.ImageView view)  圆或者圆角图片处理  static void    intoRound(android.content.Context context, String url, int radius, android.widget.ImageView view)  圆或者圆角图片处理  static void    intoRound(android.content.Context context, String url, int radius, android.widget.ImageView view, int defaultId)  从字符串中加载圆形图片(网络地址或者本地地址)</code></pre>    <h3><strong>数据库处理方法</strong></h3>    <p>数据库为抽取的 xUtils 3.0 框架.</p>    <p> </p>    <p> </p>