Android xUtils框架(一) DbUtils

框架地址：https://github.com/wyouflf/xUtils

创建数据库

DaoConfig config = new DaoConfig(context);

config.setDbName(“xUtils-demo”); //db名

config.setDbVersion(1); //db版本

DbUtils db = DbUtils.create(config);//db还有其他的一些构造方法，比如含有更新表版本的监听器的

创建表

db.createTableIfNotExist(User.class); //创建一个表User

db.save(user);//在表中保存一个user对象。最初执行保存动作时，也会创建User表

删除表

db.dropTable(User.class);

开启事务

db.configAllowTransaction(true);

db相关Annotation

@Check check约束

@Column 列名

@Finder 一对多、多对一、多对多关系(见sample的Parent、Child中的使用)

@Foreign 外键

@Id 主键，当为int类型时，默认自增。 非自增时，需要设置id的值

@NoAutoIncrement 不自增

@NotNull 不为空

@Table 表名

@Transient 不写入数据库表结构

@Unique 唯一约束

一些常用方法

[java] view plain copy print?在CODE上查看代码片派生到我的代码片

DbUtils db = DbUtils.create(this);

User user = new User(); //这里需要注意的是User对象必须有id属性，或者有通过@ID注解的属性

user.setEmail(“wyouflf@qq.com”);

user.setName(“wyouflf”);

db.save(user); // 使用saveBindingId保存实体时会为实体的id赋值

…

// 查找

Parent entity = db.findById(Parent.class, parent.getId());

List list = db.findAll(Parent.class);//通过类型查找

Parent Parent = db.findFirst(Selector.from(Parent.class).where(“name”,”=”,”test”));

// IS NULL

Parent Parent = db.findFirst(Selector.from(Parent.class).where(“name”,”=”, null));

// IS NOT NULL

Parent Parent = db.findFirst(Selector.from(Parent.class).where(“name”,”!=”, null));

// WHERE id<54 AND (age>20 OR age<30) ORDER BY id LIMIT pageSize OFFSET pageOffset

List list = db.findAll(Selector.from(Parent.class)

.where(“id” ,”<”, 54)

.and(WhereBuilder.b(“age”, “>”, 20).or(“age”, ” < “, 30))

.orderBy(“id”)

.limit(pageSize)

.offset(pageSize * pageIndex));

// op为”in”时，最后一个参数必须是数组或Iterable的实现类(例如List等)

Parent test = db.findFirst(Selector.from(Parent.class).where(“id”, “in”, new int[]{1, 2, 3}));

// op为”between”时，最后一个参数必须是数组或Iterable的实现类(例如List等)

Parent test = db.findFirst(Selector.from(Parent.class).where(“id”, “between”, new String[]{“1”, “5”}));

DbModel dbModel = db.findDbModelAll(Selector.from(Parent.class).select(“name”));//select(“name”)只取出name列

List dbModels = db.findDbModelAll(Selector.from(Parent.class).groupBy(“name”).select(“name”, “count(name)”));

…

//例：分组聚合查询出 Parent表中 非重复的name和它的对应数量

List dbModels = db.findDbModelAll(Selector.form(Parent.class).select(“distinct name,count(name) as num”).groupBy(“name”));

db.execNonQuery(“sql”) // 执行自定义sql

…

db相关类库结构：

[plain] view plain copy print?在CODE上查看代码片派生到我的代码片

com.lidroid.xutils.db.annotation

Check.java

Column.java

Finder.java

Foreign.java

Id.java

NoAutoIncrement.java

NotNull.java

Table.java

Transient.java

Unique.java

com.lidroid.xutils.db.converter

BooleanColumnConverter.java

ByteArrayColumnConverter.java

ByteColumnConverter.java

CharColumnConverter.java

ColumnConverter.java

ColumnConverterFactory.java

DateColumnConverter.java

DoubleColumnConverter.java

FloatColumnConverter.java

IntegerColumnConverter.java

LongColumnConverter.java

ShortColumnConverter.java

SqlDateColumnConverter.java

StringColumnConverter.java

com.lidroid.xutils.db.sqlite

ColumnDbType.java

CursorUtils.java

DbModelSelector.java

FinderLazyLoader.java

ForeignLazyLoader.java

Selector.java

SqlInfo.java

SqlInfoBuilder.java

WhereBuilder.java

com.lidroid.xutils.db.table

Column.java

ColumnUtils.java

DbModel.java

Finder.java

Foreign.java

Id.java

KeyValue.java

Table.java

TableUtils.java