前言
Android自带的sqlite存储已经很好了,但是涉及太多sql语句,为了方便操作,今天讲一个比较不错的数据库框架Lite_orm
此数据库具备至少以下两个特点:
- 效率比Android原始数据库sqlite更高
- 增删改查可以直接操作对象
下面对这个框架做一个简单的讲解
一.本文参考了以下链接,在此表示感谢
Android 数据库 LiteOrm 的使用
官网
二.导入orm相关jar包
jar包可以在上面的官网例子里面找到
下面讲讲如何在项目中添加jar
1.将jar复制到自己的项目文件夹下,如下图:
2.选中lib-orm-1.9.2jar,然后右键,在列表中选择add as librrary.... 即可
三.建名为table的数据表
orm一个特性就是直接用注解在model中建立表,代码如下:
package com.example.pei.textdemo.orm;
import com.example.pei.textdemo.models.BaseModel;
import com.litesuits.orm.db.annotation.NotNull;
import com.litesuits.orm.db.annotation.PrimaryKey;
import com.litesuits.orm.db.annotation.Table;
import com.litesuits.orm.db.enums.AssignType;
/**
* Title:
* Description:
*
* Created by pei
* Date: 2017/11/22
*/
@Table("student")//表名为"student"
public class Student extends BaseModel{
// 指定自增,每个对象需要有一个主键
@PrimaryKey(AssignType.AUTO_INCREMENT)
private int id;
// 非空字段
@NotNull
private String name;
// 非空字段
@NotNull
private String sex;
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 getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
}
四.实现数据库帮助类OrmDBHelper
package com.example.pei.textdemo.orm;
import com.example.pei.textdemo.app.AppContext;
import com.litesuits.orm.LiteOrm;
import com.litesuits.orm.db.assit.QueryBuilder;
import java.util.List;
/**
* Title:
* Description:
*
* Created by pei
* Date: 2017/11/22
*/
public class OrmDBHelper {
private static LiteOrm mLiteOrm;
private boolean isOpenOrmLog=true;// whether open the log
//orm数据库相关
private final String ORM_DB_NAME="student.db";//orm数据库文件名,默认地址
// private final String ORM_DB_NAME= SDCardUtil.getInnerSDCardPath()+"student.db";//orm数据库文件名,自定义地址
private OrmDBHelper() {
}
private static class Holder {
private static OrmDBHelper instance = new OrmDBHelper();
}
public static OrmDBHelper getInstance() {
return OrmDBHelper.Holder.instance;
}
/**获取orm数据库对象**/
public LiteOrm getOrmDataBase(){
if(mLiteOrm==null){
mLiteOrm = LiteOrm.newCascadeInstance(AppContext.getInstance(), ORM_DB_NAME);
}
mLiteOrm.setDebugged(isOpenOrmLog); // open the log
return mLiteOrm;
}
//==================================================================
//插入
public long insert(T t) {
return getOrmDataBase().insert(t);
}
//插入or更新
public long save(T t) {
return getOrmDataBase().save(t);
}
/***
* 更新
*/
public void update(T t){
getOrmDataBase().update(t);
}
/**
* 插入所有记录
* @param list
*/
public void insertAll(List list) {
getOrmDataBase().save(list);
}
/**
* 查询所有
* @param cla
* @return
*/
public List getQueryAll(Class cla) {
return getOrmDataBase().query(cla);
}
/**
* 查询 某字段 等于 Value的值
* @param cla
* @param field
* @param value
* @return
*/
public List getQueryByWhere(Class cla, String field, Object[] value) {
return getOrmDataBase().query(new QueryBuilder(cla).where(field + "=?", value));
}
/**
* 查询 某字段 等于 Value的值 可以指定从1-20,就是分页
* @param cla
* @param field
* @param value
* @param start
* @param length
* @return
*/
public List getQueryByWhereLength(Class cla, String field, Object[] value, int start, int length) {
return getOrmDataBase().query(new QueryBuilder(cla).where(field + "=?", value).limit(start, length));
}
/**
* 删除一个数据
* @param t
* @param
*/
public void delete( T t){
getOrmDataBase().delete( t ) ;
}
/**
* 删除一个表
* @param cla
* @param
*/
public void delete( Class cla ){
getOrmDataBase().delete( cla );
}
/**
* 删除集合中的数据
* @param list
* @param
*/
public void deleteList( List list ){
getOrmDataBase().delete( list ) ;
}
/**
* 删除数据库
*/
public void deleteDatabase(){
getOrmDataBase().deleteDatabase() ;
}
}
这里涉及到的orm数据库位置的默认地址和自定义地址问题,和sqlite处理差不多,就不做赘述
五.在activity中进行数据的调用范例
// //添加
// Student man=new Student();
// man.setName("樱木花道");
// man.setSex("男");
//
// Student woman=new Student();
// woman.setName("赤木晴子");
// woman.setSex("女");
//
// OrmDBHelper.getInstance().insert(man);
// OrmDBHelper.getInstance().insert(woman);
// //查询
// Liststudents=OrmDBHelper.getInstance().getQueryAll(Student.class);
// for(Student s:students){
// LogUtil.e(OrmActivity.class,"======s=="+s.objectToString(s));
// }
// //删除
// WhereBuilder whereBuilder=new WhereBuilder(Student.class);
// whereBuilder.where("id="+2);
// OrmDBHelper.getInstance().getOrmDataBase().delete(whereBuilder);
// //查询
// List students=OrmDBHelper.getInstance().getQueryAll(Student.class);
// for(Student s:students){
// LogUtil.e(OrmActivity.class,"======s=="+s.objectToString(s));
// }
//更新
ListupdateStudents=OrmDBHelper.getInstance().getQueryAll(Student.class);
Student update=null;
for(Student t:updateStudents){
if(t.getId()==3){
update=t;
}
}
if(update!=null){
update.setName("霸天虎");
OrmDBHelper.getInstance().getOrmDataBase().update(update);
}
//查询
List students = OrmDBHelper.getInstance().getQueryAll(Student.class);
for (Student s : students) {
LogUtil.e(OrmActivity.class, "======s==" + s.objectToString(s));
}
当然,Lite_orm数据库框架还有其他的一些增删改查方法,具体的可以参照上面说的官网介绍
ok,今天关于 Lite_orm数据库就讲到这里了,谢谢啊。