Android数据库框架——ORMLite轻量级的对象关系映射(ORM)Java包
事实上,我想写数据库的念头已经很久了,在之前写了一个答题系统的小项目那只是初步的带了一下数据库,数据库是比较强大的,不是我们三言两语就能解决的,我一直想抽个时间自己再过一遍Sqlite和JDBC的,但是,大家也知道,琐事比较多,我们来说一下数据库的框架吧,事实上市面上,我觉得还可以的数据库框架有两个,ORMLite和GreenDao,我以前做的运动类的应用上,就需要存储大量的运动数据,我们最开始是在本地写数据库的,那也是比较老的逻辑了,后来我们准备重构项目的时候,我决定把数据库也重构一下,因为我们当时的应用读取速度来还是比较慢的,比如你有一两年的数据之类的,我后来就研究了一下这两个框架,虽然我最后采用的是GreenDao,但是ORMLite也是研究了一会儿,所以,接下来,我将把这两个框架分两篇文章来分析,首先就是ORMLite了,网上还是有很多关于他们的文章的,所以我也是准备站在巨人的肩膀上,首先他们之间的优缺点,也有前辈写了,你可以参考一下
而且鸿洋老师也写了两篇关于ORMLite的文章
但是就算他们写了,我觉得我再根据自己的逻辑去讲一遍,很多人还是会收益的,我自信我的文笔应该还是算不错的,而且我是基于Android studio来讲的。嘻嘻,话不多说,我们来新建一个项目:
一.准备工作
在以前,我们写数据库时怎么写的?那就是频繁的去写SQLiteOpenHelper了,所以后来在我们开发中,很多人就喜欢封装他们,提高性能,也就出现了很多的数据库框架,ORMLite算是一个佼佼者了
我们根据官方文档来看这个框架是怎么样集成的,官网上有共有四个步骤
知道他需要两个jar,一个android的,一个core的可以直接去下载
然后添加到libs目录下,然后右键——Add As Library就算是添加成功了,紧接着,我们在xml中写个按钮用来创建表和保存数据
<Button
android:id="@+id/btn_create_save"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="创建表 | 保存数据" />
二.Bean类
OK,我们继续看文档,他需要编写一个bean类来声明一些表明和字段的
既然如此,那我们就创建好了,这个类可不简单,它主要通过注解去注明表单信息,然后映射给整个数据库,我们看
package com.lgl.ormlite;
import com.j256.ormlite.field.DatabaseField;
import com.j256.ormlite.table.DatabaseTable;
/**
* bean类,对应的整个数据库的表单信息,帮助我们映射到整个数据库当中
* Created by LGL on 2016/6/26.
*/
//配置表名
@DatabaseTable(tableName = "user_info")
public class User {
//配置主键 id
@DatabaseField(generatedId = true)
private int id;
//名称
@DatabaseField(columnName = "name")
private String name;
//描述
@DatabaseField(columnName = "desc")
private String desc;
//空构造
public User(){
}
//构造方法
public User(int id, String name, String desc) {
this.id = id;
this.name = name;
this.desc = desc;
}
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 getDesc() {
return desc;
}
public void setDesc(String desc) {
this.desc = desc;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", desc='" + desc + '\'' +
'}';
}
}
写起来还是逻辑性很强的,如果需要一些特别的参数的话,可以参考一下官网上的项目描述,首先在User类上添加@DatabaseTable(tableName = “user_info”),标明这是数据库中的一张表名字为user_info,然后分别在属性上添加@DatabaseField(columnName = “name”) ,columnName的值为该字段在数据中的列名,@DatabaseField(generatedId = true) ,generatedId 表示id为主键且自动生成,好了,到这里,我们继续看官方的文档了
三.Dao类
官网写的很详细呀,我们跟着造轮子既可呀,嘿嘿,那我们就来写这个Dao类吧,注意,注释写的很清楚了哦!
package com.lgl.ormlite;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import com.j256.ormlite.android.apptools.OrmLiteSqliteOpenHelper;
import com.j256.ormlite.dao.Dao;
import com.j256.ormlite.support.ConnectionSource;
import com.j256.ormlite.table.TableUtils;
import java.sql.SQLException;
import java.util.HashMap;
import java.util.Map;
/**
* Dao类
* Created by LGL on 2016/6/26.
*/
public class DataBaseHelper extends OrmLiteSqliteOpenHelper {
//创建数据库名称
private static final String DATABASE_NAME = "ormlite_sql.db";
//版本号
private static final int DATABASE_VERSION = 1;
//存放Dao
private Map<String, Dao> maps = new HashMap<>();
//单例模式
private static DataBaseHelper instance;
public static synchronized DataBaseHelper getInstance(Context context) {
if (instance == null) {
synchronized (DataBaseHelper.class) {
if (instance == null) {
instance = new DataBaseHelper(context);
}
}
}
return instance;
}
/**
* 获得数据库的访问对象
*
* @param cls
* @return
* @throws SQLException
*/
public synchronized Dao getDao(Class cls) throws SQLException {
Dao dao = null;
//通过反射获得类的名称
String clsName = cls.getSimpleName();
//是否存在该对象
if (maps.containsKey(clsName)) {
dao = maps.get(clsName);
} else {
dao = super.getDao(cls);
maps.put(clsName, dao);
}
return dao;
}
/**
* 关闭所有操作
*/
public void close() {
super.close();
//获取所有的map键值对置空
for (String key : maps.keySet()) {
Dao dao = maps.get(key);
dao = null;
}
}
//构造方法
public DataBaseHelper(Context context) {
//上下文,数据库名,null,版本号
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
//创建数据库
@Override
public void onCreate(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource) {
try {
//对数据库的创建以及表的建立
TableUtils.clearTable(connectionSource, User.class);
} catch (SQLException e) {
e.printStackTrace();
}
}
//更新数据库
@Override
public void onUpgrade(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource, int i, int i1) {
try {
//调用更新就删除数据库
TableUtils.dropTable(connectionSource, User.class, true);
} catch (SQLException e) {
e.printStackTrace();
}
}
}
到这里,我们的前期都OK了,紧接着,我们就可以去操作这些数据了
四.UserDao类
这个类主要是对数据的初始化和操作的
package com.lgl.ormlite;
import android.content.Context;
import com.j256.ormlite.dao.Dao;
import java.sql.SQLException;
/**
* 数据库操作类
* Created by LGL on 2016/6/26.
*/
public class UserDao {
//上下文
private Context mContext;
//主键查询
private Dao<User,Integer>userDao;
//Dao类
private DataBaseHelper helper;
public UserDao(Context mContext) {
this.mContext = mContext;
//创建数据库
helper = DataBaseHelper.getInstance(mContext);
try {
//操作Dao
userDao = helper.getDao(User.class);
} catch (SQLException e) {
e.printStackTrace();
}
}
public void addUser(User user){
try {
userDao.create(user);
} catch (SQLException e) {
e.printStackTrace();
}
}
}
五.增
OK,基本上现在可以去实际的操作了,这个UserDao类我们等下还需要去完善,现在先这样,我们去实现按钮的点击事件
//点击事件
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.btn_create_save:
userDao = new UserDao(this);
User user = new User();
user.setName("lgl");
user.setDesc("Android");
userDao.addUser(user);
break;
}
}
到这里,我们就可以去操作了,我们去看数据库,打开DDMS
当然,你也可以打开看看
既然插入成功了,那我们尝试一下多条语句的插入吧
case R.id.btn_create_save:
User user = new User();
user.setName("lgl");
user.setDesc("Android");
userDao.addUser(user);
User user1 = new User();
user.setName("zhangsan");
user.setDesc("IOS");
userDao.addUser(user1);
User user2 = new User();
user.setName("lisi");
user.setDesc("python");
userDao.addUser(user2);
break;
OK,运行一下
六.改
我们继续操作UserDao这个类
//更新User
public void updateUser(User user) {
try {
userDao.update(user);
} catch (SQLException e) {
e.printStackTrace();
}
}
既然可以更新,那我们写个按钮
<Button
android:id="@+id/btn_update"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="修改数据" />
写完之后,我们就可以执行了
case R.id.btn_update:
//我们可以修改id为1的这个数据
User user3 = new User();
user3.setId(1);
user3.setName("lgl帅哥");
userDao.updateUser(user3);
break;
我们可以看下结果
OK,这就是我们的改了,我们可以封装一下
/**
* 根据ID来更新
* @param user
* @param id
*/
public void updateById(User user,Integer id){
try {
userDao.updateId(user,id);
} catch (SQLException e) {
e.printStackTrace();
}
}
还有一个修改方法
/**
* 修改数据,支持多条
*
* @param user
*/
public void updateUserByBuilder(User user) {
try {
UpdateBuilder builder = userDao.updateBuilder();
builder.updateColumnValue("name", user.getName()).where().eq("id", 1);
builder.update();
} catch (SQLException e) {
e.printStackTrace();
}
}
七.删除
删除我们可以根据条件删除,就直接贴代码了
/**
* 删除
*
* @param user
*/
public void deleteUser(User user) {
//删除的方法比较多,根据的条件也比较多
try {
userDao.delete(user);
} catch (SQLException e) {
e.printStackTrace();
}
}
/**
* 多个对象的删除操作
*
* @param users
*/
public void deleteMulUser(List<User> users) {
try {
userDao.delete(users);
} catch (SQLException e) {
e.printStackTrace();
}
}
/**
* 根据ID删除
*
* @param ids
*/
public void deleteUserById(List<Integer> ids) {
try {
userDao.deleteIds(ids);
} catch (SQLException e) {
e.printStackTrace();
}
}
你要删除直接调用就好了
八.查
查算是比较多的场景了,我们也可以多条件查询,看我们全部查询的例子
/**
* 全部查询
*
* @return
*/
public List<User> listAll() {
try {
return userDao.queryForAll();
} catch (SQLException e) {
e.printStackTrace();
}
return null;
}
但是我们一般也不会用到全部查询,条件查询才是必须的,所以我们再新建一个按钮
<Button
android:id="@+id/btn_query"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="查询数据" />
OK.我们就可以查询了,我们写个单表查询
/**
* 查询单张表
*
* @return
*/
public List<User> queryBuilder() {
List<User> list = null;
//查询器
QueryBuilder<User, Integer> queryBuilder = userDao.queryBuilder();
//声明where条件
Where<User, Integer> where = queryBuilder.where();
//查询sesc字段的name是哪个值
try {
where.eq("name", "lgl");
where.and();
where.eq("desc", "Android");
where.prepare();
list = queryBuilder.query();
//select * from user_info where name = 'lgl' and desc = 'Android'
} catch (SQLException e) {
e.printStackTrace();
}
return list;
}
注意在点击事件里
case R.id.btn_query:
List<User> list = userDao.queryBuilder();
Log.i(TAG, list.toString());
break;
好的,我们现在看Log
我们多条件查询
/**
* 多条件查询
*
* @return
*/
public List<User> queryBuilders() {
List<User> list = null;
QueryBuilder<User, Integer> queryBuilder = userDao.queryBuilder();
Where<User, Integer> where = queryBuilder.where();
try {
where.or(where.and(where.eq("", ""), where.eq("", "")), where.and(where.eq("", ""), where.ge("", ""))).query();
} catch (SQLException e) {
e.printStackTrace();
}
return list;
}
这里我们就不演示了
最后,只能说,ORMLite是比较强大的,我们如果真的要去理解他的话,还是得去看他的API文档,不然真的无从下手,我这篇博文也只是希望大家能对ORMLite有个大概的了解,不敢妄自说精通,好的,本篇博客到这里也就结束了,如果大家觉得还不错的话,不妨点个赞!