Afinal简介
Afinal 是一个android的sqlite orm 和 ioc 框架。同时封装了android中的http框架,使其更加简单易用;
使用finalBitmap,无需考虑bitmap在android中加载的时候oom的问题和快速滑动的时候图片加载位置错位等问题。
Afinal的宗旨是简洁,快速。约定大于配置的方式。尽量一行代码完成所有事情。
将Afinal框架带进你的工程的过程
1.下载Afinal的jar包。推荐到GIT上下载(https://github.com/yangfuhai/afinal),这里不仅提供了Afinal 的jar包,还包括Afinal的源码以及详细API。
2.将下载后的jar包添加到Android工程里面。相信大家都会,不过也可能会遇到当添加了Afinal包后,继承FinalActivity的Activity会报java.lang.classNotFound这种错误,这种情况你最好将Afinal 包直接拷贝到Android工程的lib文件夹里面。这时你看Android的Dependencies包里面如果有了Afinal包就再次运行APK应该就不会有错了。
3.一个依赖Afinal包的工程还需要添加它所需要的权限:我们在AndroidManifest.xml文件里面添加如下权限:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
目前Afinal主要有四大模块:
FinalDB模块(数据库模块):android中的orm框架,一行代码就可以进行增删改查。支持一对多,多对一等查询,使用了线程池对sqlite进行操作。
FinalActivity模块(注解模块):android中的ioc框架,完全注解方式就可以进行UI绑定和事件绑定。无需findViewById和setClickListener等。
FinalHttp模块(网络模块):通过httpclient进行封装http数据请求,支持ajax方式加载,支持下载、上传文件功能。
FinalBitmap模块(图片缓存模块):通过FinalBitmap,imageview加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象。FinalBitmap可以配置线程加载线程数量,缓存大小,缓存路径,加载显示动画等。FinalBitmap的内存管理使用lru算法,没有使用弱引用(android2.3以后google已经不建议使用弱引用,android2.3后强行回收软引用和弱引用,详情查看android官方文档),更好的管理bitmap内存。FinalBitmap可以自定义下载器,用来扩展其他协议显示网络图片,比如ftp等。同时可以自定义bitmap显示器,在imageview显示图片的时候播放动画等(默认是渐变动画显示)。
FinalDB使用方法:
1.FinalDb db = FinalDb.create(this);
2.User user = new User();
//这里需要注意的是User对象必须有id属性,或者有通过@ID注解的属性
3.user.setEmail("mail@tsz.net");
4.user.setName("michael yang");
5.db.save(user);或user.setId(1);
FinalActivity使用方法
完全注解方式就可以进行UI绑定和事件绑定
无需findViewById和setClickListener等
public class AfinalDemoActivity extends FinalActivity { //无需调用findViewById和setOnclickListener等 @ViewInject(id=R.id.button,click="btnClick") Button button; @ViewInject(id=R.id.textView) TextView textView; public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } public void btnClick(View v){ textView.setText("text set form button"); }}
FinalHttp使用方法:普通get方法
使用FinalHttp上传文件 或者 提交数据 到服务器(post方法)
xUtils框架
xUtils 源于Afinal框架,对Afinal进行了大量重构,使得xUtils支持大文件上传,更全面的http请求协议支持,拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响
xUitls最低兼容android 2.2 (api level 8)
xUtils包含了四大模块:
1、DbUtils模块
android中的orm框架,一行代码就可以进行增删改查;
支持事务,默认关闭;
可通过注解自定义表名,列名,外键,唯一性约束,NOT NULL约束,CHECK约束等(需要混淆的时候请注解表名和列名);
支持绑定外键,保存实体时外键关联实体自动保存或更新;
自动加载外键关联实体,支持延时加载;
支持链式表达查询,更直观的查询语义,参考下面的介绍或sample中的例子。
2、ViewUtils模块
android中的ioc框架,完全注解方式就可以进行UI,资源和事件绑定;
新的事件绑定方式,使用混淆工具混淆后仍可正常工作;
目前支持常用的20种事件绑定,参见ViewCommonEventListener类和包com.lidroid.xutils.view.annotation.event。
3、BitmapUtils模块
加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象;
支持加载网络图片和本地图片;
内存管理使用lru算法,更好的管理bitmap内存;
可配置线程加载线程数量,缓存大小,缓存路径,加载显示动画等...
4、HttpUtils模块
支持同步,异步方式的请求;
支持大文件上传,上传大文件不会oom;
支持GET,POST,PUT,MOVE,COPY,DELETE,HEAD,OPTIONS,TRACE,CONNECT请求;
下载支持301/302重定向,支持设置是否根据Content-Disposition重命名下载的文件
返回文本内容的请求(默认只启用了GET请求)支持缓存,可设置默认过期时间和针对当前请求的过期时间。
使用xUtils快速开发框架需要有以下权限:
1.<uses-permission android:name="android.permission.INTERNET" />
2.<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
混淆时注意事项:
添加Android默认混淆配置${sdk.dir}/tools/proguard/proguard-android.txt
不要混淆xUtils中的注解类型,添加混淆配置:-keep class * extends java.lang.annotation.Annotation { *; }
对使用DbUtils模块持久化的实体类不要混淆,或者注解所有表和列名称@Table(name="xxx"),@Id(column="xxx"),@Column(column="xxx"),@Foreign(column="xxx",foreign="xxx");
输出日志 LogUtils
// 自动添加TAG,格式: className.methodName(L:lineNumber)
// 可设置全局的LogUtils.allowD = false,LogUtils.allowI = false...,控制是否输出log。
// 自定义log输出
LogUtils.customLogger = new xxxLogger();LogUtils.d("wyouflf");
Afinal框架更好用一些,断点续传下载功能很强大,只需要几行代码就能搞定各种类型文件的上传和下载。只需要一个jar包。占用空间小
afinal框架:是一个开源的android的orm和ioc应用开发框架
xUtils,它是在aFinal基础上进行重构和扩展的框架,相比aFinal有很大的改善。
xUtils :源于Afinal框架 对Afinal进行了大量重构,使得xUtils支持大文件上传,更全面的http请求协议支持