高质量 Android 开发框架 LoonAndroid 详解

开发 架构
整个框架式不同于androidannotations,Roboguice等ioc框架,这是一个类似spring的实现方式。在整应用的生命周期中找到切入点,然后对activity的生命周期进行拦截,然后插入自己的功能。

整个框架式不同于androidannotations,Roboguice等ioc框架,这是一个类似spring的实现方式。在整应用的生命周期中找到切入点,然后对activity的生命周期进行拦截,然后插入自己的功能。

框架的说明

如果你想看ui方面的东西,这里没有,想要看牛逼的效果这里也没有。这只是纯实现功能的框架,它的目标是节省代码量,降低耦合,让代码层次看起来更 清晰。整个框架一部分是网上的,一部分是我改的,为了适应我的编码习惯,还有一部分像orm完全是网上的组件。在此感谢那些朋友们。整个框架式的初衷是为 了偷懒,之前都是一个功能一个jar,做项目的时候拉进去,这样对于我来说依然还是比较麻烦。最后就导致我把所有的jar做成了一个工具集合包。有很多框 架都含有这个工具集合里的功能,这些不一定都好用,因为这是根据我个人使用喜欢来实现的,如果你们有自己的想法,可以自己把架包解压了以后,源码拉出来改 动下。目前很多框架都用到了注解,除了androidannotations没有入侵我们应用的代码以外,其他的基本上都有,要么是必须继承框架里面的 activity,要么是必须在activity的oncreat里面调用某个方法。整个框架式不同于 androidannotations,Roboguice等ioc框架,这是一个类似spring的实现方式。在整应用的生命周期中找到切入点,然后对 activity的生命周期进行拦截,然后插入自己的功能。

如果需要混淆 第一步 你要先引入你得架包 -libraryjars   libs/android-support-v4.jar -libraryjars   libs/loonandroid.jar 第二步 你要保证注解在代码优化的时候不能被删除掉 -keepattributes Signature -keepattributes Annotation第三步 support4 要排除掉 -dontwarn android.support.v4.**
-keep class android.support.v4.** { ; }
-keep interface android.support.v4.app.
* { ; }
-keep public class * extends android.support.v4.
*
-keep public class * extends android.app.Fragment 第四步 只要使用了注解的包名 全部排除掉 -dontwarn xxx.**
-keep class xxx.** { ; }
其中XXX替换成你使用了注解的包名第五步 保证R不被混淆 -keep class *
.R$* {
*;
} 即OK

框架的主要功能

其中分为以下几种:

  • 自动注入框架(只需要继承框架内的application既可)

  • 图片加载框架(多重缓存,自动回收,最大限度保证内存的安全性)

  • 网络请求模块(继承了基本上现在所有的http请求)

  • eventbus(集成一个开源的框架)

  • 验证框架(集成开源框架)

  • json解析(支持解析成集合或者对象)

  • 数据库(不知道是哪位写的 忘记了)

  • 多线程断点下载(自动判断是否支持多线程,判断是否是重定向)

  • 自动更新模块

  • 一系列工具类

一 自动注入框架

1 无需继承任何BaseActivity

举例:普通activity

  1. public class FourActivity extends Activity { 
  2.  
  3.        View xx; 
  4.  
  5.        @Override 
  6.        protected void onCreate(Bundle savedInstanceState) { 
  7.            super.onCreate(savedInstanceState); 
  8.            setContentView(R.layout.activity_main4); 
  9.            xx = find......; 
  10.            //--------------------------------------------------------- 
  11.            组件的初始化 
  12.            //--------------------------------------------------------- 
  13.        } 
  14.    } 

这其中我们会耗费大量的代码或者重复性的去些一些代码。特别是布局比较复杂的情况下。

如果用框架

  1. @InjectLayer(R.layout.activity_main3) 
  2. public class ThirdActivity extends Activity { 
  3.     @InjectView 
  4.     View xx; 

即可

像软件的说明页面,就是单纯的展示一个布局,那么就是

  1. @InjectLayer(R.layout.activity_main3) 
  2. public class ThirdActivity extends Activity { 

即可

整个ioc框架不需要你继承任何的acitivity,这样就保证了不会在你的代码结构层次上造成影响,因为有的时候你需要自己的BaseActivity来实现你公用的功能。

2 支持子父布局

这种情况下,对于一般的框架来说,做法有以下几种:

  • ActivityGroup  一般的ioc框架都需要继承框架内的activity,activitygroup会让很多框架用不了,现在ActivityGroup也是不提倡的了。

  • BaseActivity 一般的Ioc框架会需要你的BaseActivity 去继承框架内的activity

  • 中间用fragment 这样的情况也一样,你的FragmentActivity必须继承它的activity才能实现ioc框架功能。对于这个框架来说很容易实现

1 ActivityGroup  你不需要继承任何activity 和普通activity 实现方式(如上面的例子)

2 BaseActivity

见代码:

首先是BaseActivity        @InjectPLayer(R.layout.activity_com)        public class BaseActivity extends Activity {}

其中R.layout.activity_com是包括上下导航的布局,中间是一个view子activity只需要这么写即可

    @InjectLayer(value = R.layout.activity_main, parent = R.id.common)
    public class MainActivity extends BaseActivity {}

当然 又会有问题了,那么我上下导航里面的点击事件怎么绑定,怎么去初始化,难道要每一个子activity都要去写吗?当然不需要

  1. @InjectPLayer(R.layout.activity_com) 
  2.   public class BaseActivity extends Activity { 
  3.   @InjectInit 
  4.   private void init() { 
  5.       MeApplication.logger.s("公共类的初始化"); 
  6.   } 
  7.  
  8.   // 这里是第一种交互事件注入方式(单击) 
  9.   @InjectMethod(@InjectListener(ids = { R.id.top, R.id.bottom }, listeners = { OnClick.class })) 
  10.   private void click2(View view) { 
  11.       Handler_TextStyle handler_TextStyle = new Handler_TextStyle(); 
  12.       switch (view.getId()) { 
  13.           case R.id.top: 
  14.               handler_TextStyle.setString("点击了顶部按钮(在基类中统一注册,也可以单独注册)"); 
  15.               handler_TextStyle.setBackgroundColor(Color.RED, 35); 
  16.               Toast.makeText(this, handler_TextStyle.getSpannableString(), Toast.LENGTH_LONG).show(); 
  17.               break
  18.           case R.id.bottom: 
  19.               handler_TextStyle.setString("点击了底部按钮(在基类中统一注册,也可以单独注册)"); 
  20.               handler_TextStyle.setBackgroundColor(Color.RED, 35); 
  21.               Toast.makeText(this, handler_TextStyle.getSpannableString(), Toast.LENGTH_LONG).show(); 
  22.           break
  23.           } 
  24.       } 
  25.   } 

如上 其中@InjectInit注解表示不管是在子activity还是父activity 都是在布局初始化完成以后才会调用,其先后顺序是

    父布局layout->子布局layout->父布局ioc和事件绑定->子布局事件绑定。

父activity 中可以对所有的公用组件和事件进行初始化和绑定还没完,又会有另一个问题,如果我某个页面下导航的a按钮和其他页面底部a按钮的功能不一样 要单独设置怎么办。那么我们可以在子布局进行@InjectMethod和@InjectView进行事件绑定和组件注入,它们会覆盖父类中相同id的组 件的操作以下是view注入的方法说明:

@InjectPLayer

表示是Activity的setContentView

    @InjectLayer(value = R.layout.activity_main2, parent = R.id.common, isFull = true, isTitle = true)

其中需要哪个参数就用哪个,value 是必须的 如果只有layout可以这么写@InjectPLayer(R.layout.activity_com)。其中value 表示layout,parent表示它在父布局中所对应组件的id 如上图中 中间显示区域的view的id。Isfull是否全屏,默认为false.isTitle 是否有标题,默认false;

@InjectView

自动注入view注解。

基本写法:

    @InjectView
    TextView test;

其中test表示它在xml中对应的Id为test

    @InjectView(R.id.next2)
    TextView test;

表示它在xml中对应的Id为next2

高级写法:

    @InjectView(binders = { @InjectBinder(method = "click", listeners = { OnClick.class, OnLongClick.class }) })
    Button next, next3, next4;

其中表示对id为next,next3,next4进行注解,其中binders 表示绑定了以下事件,binders 是个数组,也就是说可以用多个InjectBinder绑定多个事件,也可以用listeners = { OnClick.class, OnLongClick.class }来表示对组件注入了点击事件和长按事件

    @InjectView(value = R.id.next2, binders = { @InjectBinder(method = "click", listeners = { OnClick.class }) })
    Button button;

对于变量名和组件id不一致的view则需要设置value Click 表示那些注入的事件触发以后所调用的方法,其必须在当前类内。 // 支持由参数和无参数 即click(View view)或者click() 当然click名字必须对于变量注解中的method = “click”

  1.   private void click(View view) { 
  2.         switch (view.getId()) { 
  3.             case R.id.next: 
  4.             startActivity(new Intent(this, ThirdActivity.class)); 
  5.             break
  6.             ... 
  7.         } 
  8.     } 
  9.  
  10. @InjectResource 
  11.  
  12.     @InjectResource 
  13.     String action_settings; 
  14.  
  15.     @InjectResource 
  16.     Drawable ic_launcher; 
  17.  
  18. InjectResource支持string和drawable的注解 
  19.  
  20. @InjectMethod 

// 底部导航栏 子类覆盖父类

  1. @InjectMethod(@InjectListener(ids = { R.id.bottom }, listeners = { OnClick.class, OnLongClick.class })) 
  2. private void click3(View view) { 
  3.     Handler_TextStyle handler_TextStyle = new Handler_TextStyle(); 
  4.     handler_TextStyle.setString("点击了底部按钮 子类覆盖了父类"); 
  5.     handler_TextStyle.setBackgroundColor(Color.RED, 35); 
  6.     Toast.makeText(this, handler_TextStyle.getSpannableString(), Toast.LENGTH_LONG).show(); 

@InjectMethod是当我们对一个组件只需要触发而不需要find出来的时候用到。 ids 表示绑定哪些id,listeners 表示绑定哪些事件 这两个参数都是数组

当然 如果嫌注解字段太长,可以自己修改。这个是整个view的注入。

 

  1. @InjectInit 
  2.  
  3.     @InjectInit 
  4.     void init() { 
  5.         MeApplication.logger.s("子类的初始化"); 
  6.         test.setText("初始化完成,第一个页面"); 
  7.     } 

这个注解你在activity中添加到任何一个方法名上,那么,当所有的layout和所有的view以及事件绑定完毕以后,会第一个调用含有这个注解的方法。它相当于oncreat

    注意:框架注解了整个activity的生命周期, @InjectOnNewIntent,@InjectPause,@InjectResume,
    @InjectRestart,@InjectStart,@InjectStop 其中OnDestroy无注解。
    如果Activity中有含有这些注解的方法 那么不同生命周期下回自动调用这些方法

二:Fragment的自动注入

  1. @Override 
  2. public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 
  3.     this.inflater = inflater; 
  4.     View rootView = inflater.inflate(R.layout.activity_left, container, false); 
  5.     Handler_Inject.injectView(this, rootView); 
  6.     return rootView; 

    只需要在onCreateView里面调用Handler_Inject.injectView(this, rootView);
    即可

    在fragment中除了activity的生命周期注解和@InjectLayer注解无法使用外,组件绑定和事件绑定都可以使用,@InjectBefore也可以使用

    @InjectBefore 是在组件初始化之前调用

三:图片下载框架

    这个是图片框架重写了好多次了,总是有点问题,里面基本上每一段代码都有注释,还有一些bug,
    因为项目中用的还是这次重写之前的。
    如果大家发现问题,记得告诉我框架中调用的方法名和参数基本上都不会变,避免替换jar导致需要改动大部分代码。

整个图片下载的逻辑是这样的:

  • 1 根据url和view去调用图片下载的方法

  • 2 从缓存去拿bitmap

  • 3 如果bitmap不为空 判断是否针对这个url有单独的配置 没有则使用全局配置加载图片

  • 4 如果bitmap为空 则开启线程,放到本地线程池中,然后从本地文件读取

  • 5 如果文件存在,则转为bitmap放到缓存,然后重复2,然后9

  • 6 如果文件不存在,则开启线程放到网络线程池中去下载文件

  • 7 下载成功则放到本地sdcard 然后把文件转为bitmap放到缓存,然后重复2,然后9

  • 8 下载不成功,然后重复2,然后9

  • 9 如果bitmap不为空 判断是否针对这个url有单独的配置 没有则使用全局配置加载这张图片 如果bitmap为空 则显示失败的默认图

具体的流程 可以参考源码

缓存分为三层

    第一层是LruCache(原理去百度)
    第二层是LinkedHashMap
    第三层是 view标记

    1 当LruCache中的图片超过了规定了内存,那么从LruCache移除一个使用最少的,放到LinkedHashMap中
    2 当每一张图片的url对应一个count,一旦加载一张图片,那么这个url的count加1
    3 自定义AsyImageView继承ImageView,重写了onDetachedFromWindow方法,一旦
        AsyImageView从当前视图移除掉会调用onDetachedFromWindow该方法,此刻该图片所对应的url数目count减1
    4 因为listview中的imageview如果用了ViewHolder那么第3条就不适合了,此刻每一个imagview的hashCode对应一个url,
        一旦imagview更换了一个新的url,那么该imagview的hashcode上一个的引用将被移除,
        那么上一次显示的url所对应的count将减1
    5 当LinkedHashMap超过了规定限制的时候,那么遍历所有的count一旦count为0 则移除回收

图片下载使用

一:必须条件

    必须在配置文件中添加配置,来打开图片下载引擎的初始化,为了减少启动时间,默认关闭。
    #开启框架内置的图片下载 如果不设置 则无法使用框架类的图片下载
    imageload_open=true

    二:使用方法

1 普通图片下载

    ImageDownloader.download("网络和本地图片链接",mAsyImageView);

如果需要配置bitmap的高宽

第一种方式:

    在xml布局文件中对AsyImageView的高宽进行设置

第二种方式:

全局图片配置,所有图片显示默认用此配置

    GlobalConfig globalConfig = GlobalConfig.getInstance();
    globalConfig.setMaxWidth(w);

来设置

第三种

    SingleConfig config = new SingleConfig();
    config ....设置宽高
    ImageDownloader.download("网络和本地图片链接",mAsyImageView,config )

其中优先级

第三种 > 第一种 > 第二种

        其中GlobalConfig  支持的设置有高宽的设置,内存缓存的大小,默认图片,
        下载失败的图片,最大缓存数目,线程池,缓存类型,显示控制,listview得滑动监听,图片加载动画
        其中SingleConfig 支持的设置有高宽的设置,默认图片,下载失败的图片,下载进度,显示控制,加载动画

其中SingleConfig 优先于GlobalConfig

支持配置文件配置:

    mAsyImageView.setTemplate("one");
    ImageDownloader.download("url",mAsyImageView);

其中one在配置文件里面配置,这样 不管在任何地方,只要AsyImageView.setTemplate(“one”);就可以使用名称为one的配置了。

支持本地文件加载调用接口不变。

需要进度显示的:

  1. SingleConfig config = new SingleConfig(); 
  2.  config.setDisplayer(new DisplayerLister() { 
  3.      @Override 
  4.      public void startLoader(AsyImageView imageView) { 
  5.          super.startLoader(imageView); 
  6.      } 
  7.      @Override 
  8.      public Bitmap finishLoader(Bitmap bitmap, AsyImageView imageView) { 
  9.          pin_progress_1.setVisibility(View.GONE); 
  10.          return bitmap; 
  11.      } 
  12.  
  13.      @Override 
  14.      public void progressLoader(int progress, AsyImageView imageView) { 
  15.          pin_progress_1.setProgress(progress); 
  16.          super.progressLoader(progress, imageView); 
  17.      } 
  18.  }); 
  19.  ImageDownloader.download("url",photo,config); 

其中url的服务器必须支持获取文件长度

需要显示动画的:如果是单独某一个图片

  1. SingleConfig config = new SingleConfig(); 
  2.    config.setDisplayerAnimation(new FadeInAnimation()); 

如果是全局的

  1. GlobalConfig config = new GlobalConfig(); 
  2. config.setDisplayerAnimation(new FadeInAnimation()); 

其中FadeInAnimation是框架自带的一个渐变的动画如果需要自定义 实现DisplayerAnimation接口即可

2 listview中图片下载

    只要在listview的注解@InjectView(isasy=true)中添加了isasy=true(默认为false)
    那么系统会自动给你注入OnScrollListener滚动事件,以便实现图片飞行停止才加载,缓慢拖动加载的功能。如果你要实现自己的OnScrollListener

如下

 

  1.     @InjectBefore 
  2.     void test(){ 
  3.         //@InjectView(isasy=true)表示这个listview里面有网络图片下载,并且需要实现滑动停止才加载的功能 
  4.         //@InjectView(isasy=true)框架会给listview自动注入OnScrollListener,如果你自己也要滚动监听 
  5.         //那么请在此配置,如下 
  6.         GlobalConfig config = GlobalConfig.getInstance(); 
  7.         config.setOnScrollLoaderListener(new MyOnScrollListener()); 
  8.         System.out.println("before"); 
  9.     } 
  10.     //必须继承框架内的滚动监听 
  11.     class MyOnScrollListener extends OnScrollLoaderListener{ 
  12.     @Override 
  13.     public void onScrollListener(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) { 
  14.         ApplicationBean.logger.s("滚动监听:"+firstVisibleItem); 
  15.     } 
  16.  
  17.     @Override 
  18.     public void onScrollStateChange(AbsListView view, int scrollState) { 
  19.         ApplicationBean.logger.s("滚动状态"); 
  20.         } 
  21.     } 
  22.  
  23. @InjectBefore 表示在组件初始化以前开始调用,因为滚动监听必须在listview被初始化之前赋值,否则无效 将默认使用框架内的滚动监听 

3 无需显示的图片下载

  1. ImageDownloader.download("url"new LoaderLister() { 
  2.      @Override 
  3.      public void finishLoader(String url, File file) { 
  4.          System.out.println("下载完成"+file.getPath()); 
  5.      } 
  6.      @Override 
  7.      public void failLoader(String url) { 
  8.          System.out.println("下载失败"); 
  9.      } 
  10.  }); 

如果需要下载进度

  1. ImageDownloader.download("url"new LoaderLister() { 
  2.  
  3.        @Override 
  4.        public void startLoader(String url) { 
  5.            System.out.println("开始下载"); 
  6.            super.startLoader(url); 
  7.        } 
  8.  
  9.        @Override 
  10.        public void finishLoader(String url, File file) { 
  11.            System.out.println("下载完成"+file.getPath()); 
  12.        } 
  13.  
  14.        @Override 
  15.        public void progressLoader(int progress) { 
  16.            System.out.println("下载进度"+progress); 
  17.            super.progressLoader(progress); 
  18.        } 
  19.    }); 

 

责任编辑:王雪燕
相关推荐

2023-07-06 14:51:30

开发高质量软件

2011-05-31 13:43:46

外链

2017-07-14 09:54:47

代码函数程序

2023-01-27 23:46:36

嵌入式软件技巧

2010-03-01 14:31:04

Java

2021-08-08 14:26:24

SQL数据库开发

2016-08-22 09:10:13

框架

2009-11-23 20:39:21

ibmdw敏捷开发

2011-06-24 14:59:41

外链

2012-09-13 10:44:18

Python代码

2011-07-20 15:26:52

C++

2011-03-04 10:11:09

JavascriptAPI

2023-10-15 12:07:09

2011-02-16 10:38:13

Java EEJava

2020-03-12 14:03:59

工具代码开发

2023-03-09 15:05:46

HTMLWeb 开发SEO

2022-11-28 19:25:03

通信东数西算

2015-08-25 08:42:36

高质量代码命名
点赞
收藏

51CTO技术栈公众号