Android 数据库—Afinal 框架详情

Afinal简介

（github源码 点击查看）

1、Afinal 是一个android的sqlite orm 和 ioc 框架。同时封装了android中的http框架，使其更加简单易用； 其特点是小巧灵活，代码入侵量少。

2、使用finalBitmap，无需考虑bitmap在android中加载的时候oom的问题和快速滑动的时候图片加载位置错位等问题。

3、在android应用开发中，通过Afinal的ioc框架，诸如ui绑定，事件绑定，通过注解可以自动绑定。 通过Afinal的orm框架，无需任何配置信息，一行代码就可以对android的sqlite数据库进行增删改查操作。同时，Afinal内嵌了finalHttp等简单易用的工具，可以轻松的对http就行求情的操作。

4、Afinal的宗旨是简洁，快速。约定大于配置的方式。尽量一行代码完成所有事情。

Afinal主要有四大模块：

FinalDB模块：android中的orm框架，一行代码就可以进行增删改查。支持一对多，多对一等查询。

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显示图片的时候播放动画等（默认是渐变动画显示）。

需要有以下权限：

<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

FinalDB使用方法(orm框架)：

afinal是一个android的orm、ioc快速开发框架，里面包含了四大功能： 1.空间的id绑定和事件绑定功能； 2.网络图片的显示功能（里面包含了强大的缓存框架）； 3.数据库sqlite的操作功能； 4.http数据的读取功能（支持ajax方式读取） package com.devchina.ormdemo; import java.util.Date; public class User { private int id; private String name; private String email; private Date registerDate; private Double money; //这个实体类要注意一点就是getter和setter是不能省略.因为afinal的finalDb最终会调用setter去给实体类的属性赋值。 public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } public Date getRegisterDate() { return registerDate; } public void setRegisterDate(Date registerDate) { this.registerDate = registerDate; } public Double getMoney() { return money; } public void setMoney(Double money) { this.money = money; } }

AfinalOrmDemoActivity.java

public class AfinalOrmDemoActivity extends FinalActivity { @ViewInject(id=R.id.textView) TextView textView; //这里使用了afinal的ioc功能，以后将会讲到 @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); FinalDb db = FinalDb.create(this); User user = new User(); user.setEmail("afinal@tsz.net"); user.setName("探索者"); user.setRegisterDate(new Date()); db.save(user); List<User> userList = db.findAll(User.class);//查询所有的用户 Log.e("AfinalOrmDemoActivity", "用户数量："+ (userList!=null?userList.size():0)); textView.setText(userList.get(0).getName()+":"+user.getRegisterDate()); } }

很简单吧，就一个FinalDb db = FinalDb.create(this)，然后db.save(user);就可以把我们定义的实体类保存到数据库去啦。我们来看输出日志:

就这样就保存到sqlite数据库里面去了？可是我们还没有创建数据库，也没有创建表呀？怎么可能？

这里，我要跟大家说的是afinal自己去创建啦，简单吧。

我们来看下adt的File Exploer 查看database目录，下面确实有一个afinal.db文件，如下图：

我们把afinal.db导出来后，通过sqlite数据库打开afinal.db，如下图：

同时afinal自动给我们创建来表：com_devchina_ormdemo_User，由此看出afinal会以类名为表名自动创建表：我们再过来看下表的数据：

到这里，相信大家能明白了，原理afinal自动给我们创建了数据库afinal.db同时给我们创建了表com_devchina_ormdemo_User，保存的时候，afinal自动把数据保存到sqlite表里面去了。

afinal自动创建了数据库afinal.db，同时自动创建了表com_devchina_ormdemo_User。可是，我们不想创建数据库afinal.db，也不想让我们的表示com_devchina_ormdemo_User，那我们应该怎么办呢？

这一些呀，afinal都已经想好了。

接下来，我们来介绍下afinal的orm注解功能。

第一个，配置数据库中的表名 net.tsz.afinal.annotation.sqlite.Table，我们来给user,java配置一下：

package com.devchina.ormdemo; import java.util.Date; import net.tsz.afinal.annotation.sqlite.Table; @Table(name="user_test") public class User { private int id; private String name; private String email; private Date registerDate; private Double money; /////////////getter and setter/////////////// //代码太长，略getter setter，开发中不能省略 }

这里和上边唯一不同的是 多了一个注解 @Table(name=”user_test”)，只要我们配置了这个以后，我们再来看下afinal创建的数据库和表：

由此，我们可以看出来，afinal又自动给我们创建了表user_test，但是要注意的是com_devchina_ormdemo_User这个表afinal并没有去删除，所以这里也要提醒下大家，我们在重新设计了类的结构或者属性的时候，先手动删除掉直接的数据，否则就会有垃圾数据保存在数据库里面，当然，不删除也可以，不会有任何的影响。

在上面的讲述中，细心的朋友可能会注意到了一个问题，afinal自动把user的id的这个属性当做了主键。而且自动增长。

可是，可是在我们的开发过程中，我们的user可能没有id这个属性啊，可能是userId，或者又可能是其他我们喜欢的属性，那怎么办呢？

没有关系：afinal有给我们准备了另一个注解：net.tsz.afinal.annotation.sqlite.Id，通过这个，我们就可以给我们的实体类定义主键啦

afinal的主键机制是： 当给某个属性添加注解@id的时候，该属性就是主键（一个类中只有一个主键），保存在数据库中的列名为属性的名称，@Id(column=”userId”)给属性添加注解的时候，保存在数据库的列名是userId，当这个属性没有的时候，afinal自动回去该类查找_id属性，_id属性也没有的时候，afinal就会自动去查找id属性。如果连id属性也没有，那么afinal就报错啦，afinal的orm规则中，表示必须有主键的，而且只能有一个（目前暂时不支持复合主键）。

afinal给我们自动创建数据库afinal.db，可是，我们不想创建让数据库名是afinal.db，那怎么办呢？

afinal的创建时候有多个方法的重载。

在create的方法中， isDebug表示是否是debug模式，debug模式中，使用afinal操作数据库的时候就会答应SQL语句的log， dbName就是数据库的名称啦。

所以这里，我们传入我们自己想要的数据库名称就行了。 其实afinal的FinalDb模块中，还有很多其他的功能，比如一对多，多对一的配置和注解等等。等待大家挖掘了。

afinal的orm注解中有：

Id——->注解注解Property——>属性注解Table——->数据表注解ManyToOne——–>多对一注解OneToMany———>一对多注解Transient——->忽略属性注解（如果该属性添加这个注解，afinal的orm功能将忽略该属性）

FinalDB OneToMany懒加载使用方法：

模型定义：

public class Parent{ private int id; @OneToMany(manyColumn = "parentId") private OneToManyLazyLoader<Parent ,Child> children; /*....*/ } public class Child{ private int id; private String text; @ManyToOne(column = "parentId") private Parent parent; /*....*/ }

使用：

List<Parent> all = db.findAll(Parent.class); for( Parent item : all){ if(item.getChildren ().getList().size()>0) Toast.makeText(this,item.getText() + item.getChildren().getList().get(0).getText(),Toast.LENGTH_LONG).show(); }

FinalActivity使用方法(ioc框架)：

完全注解方式就可以进行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"); } } 在其他侵入式框架下使用（如ActionBarShelock） protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(view); FinalActivity.initInjectedView(this); } 在Fragment中使用 public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { View viewRoot = inflater.inflate(R.layout.map_frame, container, false); FinalActivity.initInjectedView(this,viewRoot); }

FinalHttp使用方法：

普通get方法

FinalHttp fh = new FinalHttp(); fh.get("http://www.yangfuhai.com", new AjaxCallBack(){ @Override public void onLoading(long count, long current) { //每1秒钟自动被回调一次 textView.setText(current+"/"+count); } @Override public void onSuccess(String t) { textView.setText(t==null?"null":t); } @Override public void onStart() { //开始http请求的时候回调 } @Override public void onFailure(Throwable t, String strMsg) { //加载失败的时候回调 } });

使用FinalHttp上传文件 或者 提交数据 到服务器（post方法）

AjaxParams params = new AjaxParams(); params.put("username", "michael yang"); params.put("password", "123456"); params.put("email", "test@tsz.net"); params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件 params.put("profile_picture2", inputStream); // 上传数据流 params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流 FinalHttp fh = new FinalHttp(); fh.post("http://www.yangfuhai.com", params, new AjaxCallBack(){ @Override public void onLoading(long count, long current) { textView.setText(current+"/"+count); } @Override public void onSuccess(String t) { textView.setText(t==null?"null":t); } });

使用FinalHttp下载文件

支持断点续传，随时停止下载任务 或者 开始任务 FinalHttp fh = new FinalHttp(); //调用download方法开始下载 HttpHandler handler = fh.download("http://www.xxx.com/下载路径/xxx.apk", //这里是下载的路径 true,//true:断点续传 false:不断点续传（全新下载） "/mnt/sdcard/testapk.apk", //这是保存到本地的路径 new AjaxCallBack() { @Override public void onLoading(long count, long current) { textView.setText("下载进度："+current+"/"+count); } @Override public void onSuccess(File t) { textView.setText(t==null?"null":t.getAbsoluteFile().toString()); } }); //调用stop()方法停止下载 handler.stop();

FinalBitmap 使用方法

加载网络图片就一行代码 fb.display(imageView,url)

private GridView gridView; private FinalBitmap fb; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.images); gridView = (GridView) findViewById(R.id.gridView); gridView.setAdapter(mAdapter); fb = FinalBitmap.create(this);//初始化FinalBitmap模块 fb.configLoadingImage(R.drawable.downloading); //这里可以进行其他十几项的配置，也可以不用配置，配置之后必须调用init()函数,才生效 //fb.configBitmapLoadThreadSize(int size) //fb.configBitmapMaxHeight(bitmapHeight) } ///////////////////////////adapter中的getView//////////////////////////////////////////// public View getView(int position, View convertView, ViewGroup parent) { ImageView iv; if(convertView == null){ convertView = View.inflate(BitmapCacheActivity.this,R.layout.image_item, null); iv = (ImageView) convertView.findViewById(R.id.imageView); iv.setScaleType(ScaleType.CENTER_CROP); convertView.setTag(iv); }else{ iv = (ImageView) convertView.getTag(); } //bitmap加载就这一行代码，display还有其他重载，详情查看源码 fb.display(iv,Images.imageUrls[position]); 初始化代码 bitmap = FinalBitmap.create(this.getApplicationContext()); 初始化 bitmap.configBitmapLoadThreadSize(3);定义线程数量 bitmap.configDiskCachePath(this.getApplicationContext().getFilesDir().toString());设置缓存目录； bitmap.configDiskCacheSize(1024 * 1024 * 10);设置缓存大小 bitmap.configLoadingImage(R.drawable.news_default);设置加载图片 2、调用代码 bitmap.display(imageView, newsinfoa.getImageUrl());第一个参数为iamgeview组件，第二个为加载的url地址 //第一种方式：image为要显示图片的控件 bitmap.display(iv, uri); //第二种方式：loadingBitmap为正在加载时显示的图片 //bitmap.display(iv, uri, loadingBitmap); //第三种方式：loadingBitmap为加载中图片，failBitmap为加载失败图片 // bitmap.display(iv, uri, loadingBitmap, failBitmap); //第四种方式：我们也可以设置加载图片的大小 //bitmap.display(iv, uri, 100, 100); //第五种方式：设置加载图片的大小以及加载中和加载失败的图片 //bitmap.display(iv, uri, 100, 100, loadingBitmap, failBitmap);