微信号:ardays

介绍:android每日绝对干货

简单实用的Android ORM框架TigerDB

2016-10-26 18:00

TigerDB是一个简单的Android ORM框架,它能让你一句话实现数据库的增删改查,同时支持实体对象的持久化和自动映射,同时你也不必关心表结构的变化,因为它会自动检测新增字段来更新你的表结构。

该库主要包括如下几个要点:

  1. 根据实体对象自动建表、新增字段(SQLite不支持删除字段列)

  2. 支持注解配置表名、字段名、字段默认值、主键是否自增长以及哪些字段不作为数据表中的映射字段

  3. 直接映射实体对象到SQLite数据库,实现一行代码对SQLite数据库增删改查

  4. 支持在SDCard中新建数据库db

  5. 解决在onCreate,onUpgrade中执行数据库其他操作时出现的异常(java.lang.IllegalStateException: getDatabase called recursively)

  6. 支持原生SQL语句操作数据库

该ORM库使用过程中的主要类说明:

  1. SQLiteDBConfig:主要用于设置数据库的名字、创建路径、版本号、数据创建更新时的监听

  2. SQLiteDB:创建完数据库之后,主要通过此类来操作数据库的增删改查

  3. SQLiteDBFactory:该类主要用于创建SQLite数据库,同时缓存当前创建的SQLiteDB对象

  4. CursorUtil:查询数据库时,检测游标对象Cursor是否正常,解析Cursor数据为实体对象

  5. IDBListener:数据库创建、升级时的监听类,提供了空实现SimpleDBListener

  6. Column:该注解用来设置字段名、字段默认值

  7. PrimaryKey:该注解用来设置主键、主键字段名、以及主键是否为自增长

  8. Table:该注解用来设置表名,不设置的话默认类名为表名

  9. NotDBColumn:该注解用来设置哪些实体属性不映射到数据表中

主要用法如下:

 
           
  1. //新建实体,可以通过注解@Table设置表名,如果不设置默认以类名User作为表名

  2. public class User {

  3.     //设置主键id为自增长,也可以通过注解@Column设置字段名或字段默认值

  4.     @PrimaryKey(isAutoGenerate=true)

  5.     private long id;

  6.         

  7.     private String name;

  8.         

  9.     //设置age字段默认值为1

  10.     @Column(defaultValue="1")

  11.     private int age;

  12.         

  13.     //该字段不作为数据表中的字段

  14.     @NotDBColumn

  15.     private String bz;

  16.         

  17.     //必须实现无参构造

  18.     public User() {

  19.     }

  20.         

  21.     public User(String name) {

  22.         super();

  23.         this.name = name;

  24.     }

  25.     public long getId() {

  26.         return id;

  27.     }

  28.     public void setId(long id) {

  29.         this.id = id;

  30.     }

  31.     public String getName() {

  32.         return name;

  33.     }

  34.     public void setName(String name) {

  35.         this.name = name;

  36.     }

  37.         

  38.     @Override

  39.     public String toString() {

  40.         return "{id=" + id + ",name=" + name + "}";

  41.     }

  42. }

  43.     

  44. //SQLite相关配置,包括数据库名字、创建路径、版本号、数据创建和升级时的监听

  45. SQLiteDBConfig config = new SQLiteDBConfig(this);

  46. //设置数据库创建更新时的监听,有提供空实现:SimpleDBListener

  47. config.setDbListener(new IDBListener() {

  48.     @Override

  49.     public void onUpgradeHandler(SQLiteDatabase db, int oldVersion, int newVersion) {

  50.                 

  51.     }

  52.             

  53.     @Override

  54.     public void onDbCreateHandler(SQLiteDatabase db) {

  55.         showLongToast("数据库创建成功");

  56.     }

  57.  });

  58.  //创建db,在创建数据库的时候,不需要在onDbCreateHandler手动去创建相关的数据表,在对实体对象进行数据操作的时候,会自动判断表是否存在,不存在的话会自动创建,同时如果有新增的字段也会自动更新表结构

  59.  SQLiteDB db = SQLiteDBFactory.createSQLiteDB(config);

  60.  

  61. //保存单个实体对象

  62. User user = new User("添加单个对象");

  63. int rtn = db.save(user)

  64.         

  65. //保存集合对象

  66. List list = new ArrayList();

  67. int rtn = db.save(list)

  68.         

  69. //查询User表中的所有数据

  70. List list = db.queryAll(User.class);

  71.     

  72. //根据实体id(主键)查询User

  73. User user = db.query(User.class, "1");

  74.     

  75. //查询User表中的数据总数

  76. long total = db.queryTotal(User.class);

  77.  

  78. //删除指定实体对象

  79. db.delete(user);

  80.     

  81. //更新实体对象

  82. db.update(user);

  83.     

  84. //分页查询

  85. db.queryPage(claxx, curPage, pageSize);

  86.     

  87. //根据SQL查询

  88. Cursor cursor = db.query(sql, bindArgs);

源码及Demo地址:https://github.com/huyongli/TigerDB,大家可以自行下载查看

 
Android每日干货 更多文章 android日志打印库,可以配置打印到本地,可以配置打印格式化的日志 【Android】自定义控件之View原理与使用 简单实用的Android ORM框架TigerDB PullRefreshView 5秒让你的View变3D,ThreeDLayout使用和实现
猜您喜欢 More than React(二)组件对复用性有害? 又一七牛小伙伴获得巨额融资,祝贺极客学院完成2200万美元B轮融资 3.20软件开发文档该怎样写 广告节评奖的那点事儿 pt-osc改表导致数据不一致案例分析