本文主要是介绍Android中使用OrmLite(一):表创建及增删改查,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
OrmLite是一个轻量级的ORM框架,面向JAVA语言。也是时下流行的Android的ORM框架之一。在Android中使用Sqlite数据,如果又不想写SQL,OrmLite或许是个不错的选择。
使用OrmLite,首先要在gradle配置依赖 compile 'com.j256.ormlite:ormlite-android:4.48'
也可以去ormlite官网下载查看文档 http://ormlite.com/
1.表创建
然后要要创建一个实体类,对应表结构。OrmLite提供了两个注解,@DatabaseField 代表表列名,@DatabaseTable 表名 tableName值为数据库中表的真实名称。下列的User类必须有一个无参数的构造函数。
需要指定一个字段为唯一标志,必须为int, Integer ,long, Long, Uuid类型
数据库中的记录通过定义为唯一的特殊字段成为唯一标识。记录不是必须有唯一标识字段当时很多DAO操作(更新、删除、刷新)都需要一个唯一标识字段。这个标识要么用户提供要么数据库自动生成。标识字段有表中唯一的值并且如果你用DAO根据id查询、删除、刷新或者更新指定行的时候他们必须存在。为了配置一个成员变量作为标识成员,你应该使用下面三个设置之一(而且必须使用一个):@DatabaseField: id, generatedId, generatedIdSequence 。
@DatabaseField(id = true)指定哪个字段为主键
@DatabaseField(generatedId = true)自动增加的ID
@DatabaseField(generatedIdSequence = true) 设置序列名来匹配已经存在的schema,你可以使用generatedIdSequence指定序列名的值。
这样才可以使用ID来做删除,修改,查询等操作。否则调用相关方法抛出
Cannot query-for-id with class xxx.xxx.xxx.User because it doesn't have an id field相关异常。
Android中使用Sqlite需要继承自SQLiteOpenHelper,要使用ormlite需要继承OrmLiteSqliteOpenHelper,来实现一些创建数据库,创建表,更新表的操作。TableUtils是个工具类,主要提供表的创建,表的移除等操作。
2.表的增删改查
首先通过上述的单例类获取一个OrmLiteSqliteOpenHelper的实例,该类中有个getDao(Class<T> clazz)方法可以获取到对应实体的dao对象,参数clazz为表对应的实体的class对象,例如User.class 。
通过getDao返回一个Dao<T, ID>的实例,dao中有增删改查的方法。
从helper获取一个dao的实例
在表中添加一条记录
public int create(T data) throws SQLException;
在表中添加一条记录,如果表不存在这条数据,根据设置的主键来判断是否存在
public T createIfNotExists(T data) throws SQLException;
在表中添加一条记录,如果存在则更新主键对应的一条记录,
public CreateOrUpdateStatus createOrUpdate(T data) throws SQLException;
删除
根据传入实体删除
public int delete(T data) throws SQLException;
根据ID删除
public int deleteById(ID id) throws SQLException;
根据集合删除
public int delete(Collection<T> datas) throws SQLException;
根据id集合删除
public int deleteIds(Collection<ID> ids) throws SQLException;
更新
//根据传入的实体更新数据,ID为唯一标志
public int update(T data) throws SQLException;
//更新ID,其他值不变
public int updateId(T data, ID newId) throws SQLException;
查询
根据唯一标志id检索一条记录,如果id为
public T queryForId(ID id) throws SQLException;
查询匹配到的所有行中的第一个
public T queryForFirst(PreparedQuery<T> preparedQuery) throws SQLException;
返回表中所有条目,可导致大量数据导入内存,应该使用iterator方法来代替此方法
public List<T> queryForAll() throws SQLException;
查询指定字段value等于查询值的行: where fieldName = value
public List<T> queryForEq(String fieldName, Object value) throws SQLException;
匹配传入实体(字段不能为默认值,null,false,0,0.0等)的每个字段的值,每个条件进行and操作,返回的结果,可能导致SQL quote escaping
public List<T> queryForMatching(T matchObj) throws SQLException;
同上述方法,不会导致SQL quote escaping
public List<T> queryForMatchingArgs(T matchObj) throws SQLException;
根据传入的字段与value值的map匹配查询
public List<T> queryForFieldValues(Map<String, Object> fieldValues) throws SQLException;
根据传入的字段与value值的map匹配查询
public List<T> queryForFieldValuesArgs(Map<String, Object> fieldValues) throws SQLException;
查询与传入实体id相等的数据行
public T queryForSameId(T data) throws SQLException;
这篇关于Android中使用OrmLite(一):表创建及增删改查的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!