xUTils框架的学习(二)
这章讲的是框架的DbUtils模块的学习
三 xUtils框架的DButils模块
最开始接触这个框架就是从数据库模块开始的。当时的需求是需要记录用户的登录数据,保存在本地以便进行离线登录。首先想到的是用sharedpreference存储,但是后面说要支持多用户同设备登录,所以就想到了数据库保存信息。于是就用到了dbutils,当时由于项目比较紧就没过多研究,用了比较简洁的方法,在开始的时候用sqlite的可视化数据库操作工具创建了数据库直接放到asset文件夹下面的。至于如何在项目中直接创建数据库,后面部分会陆续提到。
3.1 用sqlite expert profession3 软件创建数据库
首先声明一下sqlite的数据存储类型和MySQL以及其他数据库的数据存储类型不一样,主要有null(空值)、INTERGER(有符号整数类型)、REAL(浮点数类型)、TEXT(字符串)、BLOB(二进制表示)。用sqliteExpert 创建表 user_info ,并在表里面增加column,把ID作为primaryKey,并设置为自增长。仔添加其他字段,数据库表创建完成后将数据库拷贝到工程的asset文件夹下。
sqliteExpert工具的使用会在另外一篇文章里面讲解。详情见sqliteE软件使用(创建数据库和表)
3.2 在工程 下创建service 包,并在该包下创建DBService.class文件用来进行数据库的初始化。下面是DBService的代码。
public class DbService { private Context context; private static DbService instance; /*** * userInfoDbUtils:人员登录数据库(将用户登录信息保存在本地数据库) */ private DbUtils userInfoUtils; public DbUtils getDbUtils() { if (dbUtils == null) { openBaseDb(); } return dbUtils; } private DbService(Context context) { this.context = context; } public static DbService getInstance(Context context) { if (instance == null) { instance = new DbService(context); } return instance; } /** * @Method :初始化打开数据库 */ public void initAllDbs() { openUserInfoDB(); } private void openUserInfoDB(){ userInfoUtils = DbUtils.create(context, Constants.getLocalDefaultPath(), Constants.USER_INFO); userInfoUtils.configAllowTransaction(true); userInfoUtils.configDebug(true); } /** * @Method :关闭所有数据库 */ public void closeAllDbs() { if(null != userInfoUtils){ userInfoUtils.close(); } } public DbUtils getUserInfoUtils() { if(null == userInfoUtils){ openUserInfoDB(); } return userInfoUtils; } }
3.3 在工程下创建entity包 ,并在该包内创建UserEntity.class文件,与表的字段对应,下面是UserEntity的代码,可以看到表里的每一个字段都有
一个属性与之对应。这样在用到DbUtils的时候才能将数据准确的与对象属性对应。这个对象类与普通的对象类不同的是就是在前面加了xutils框架里面的数据库的表注解@Table以及字段的注解@Column。
@Table(name = "user_info") public class UserInfo { /*** * id */ @Column(column = "id") private int id; /*** * 用户名 */ @Column(column = "USER_NAME") private String username; /*** * 密码 */ @Column(column = "PASSWORD") private String password; /*** * 查询范围(用json字串存起来,在读取的时候再进行对象转换) */ @Column(column = "MODULE_QUERY") private String muduleList; public String getMuduleList() { return muduleList; } public void setMuduleList(String muduleList) { this.muduleList = muduleList; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } }
3.4 在工程开始启动的时候就创建数据库,项目中是在启动的时候有一个开始动画,所以就在这个动画的页面里面进行了数据库的初始化。具体代码如下
private static final String[] FILE_NAME_ASSETS = { "USER_INFO.db"};//由于考虑到会有其他的数据库要进行加载,所以就用一个字节数组保存
private class SplashRunnable implements Runnable { @Override public void run() { String sdCardStatus =Environment.getExternalStorageState(); if (sdCardStatus.equals(Environment.MEDIA_MOUNTED)) { FileUtils.makeDirs(Constants.getLocalDefaultPath()); for (String fileName : FILE_NAME_ASSETS) { if (!FileUtils.isFileExist(Constants.getLocalDefaultPath() .concat("/").concat(fileName))) { appService.copyApkFromAssets(mContext,fileName, Constants.getLocalDefaultPath().concat("/") .concat(fileName)); } } startActivity(loginIntent); finish(); } } }
在这里我起了一个线程去做这件事情,这个线程做的事情是先检测是否存在SD卡,如果存在就检测数据库文件是否存在,不存在的话就将数据库拷贝到指定的文件夹下面。然后再跳转到下一个页面。这就完成了数据库的初始化。注:appService是我在项目里面创建的一个服务类。
下面是拷贝的方法
public boolean copyApkFromAssets(Context context, String fileName, String path) { boolean copyIsFinish = false; InputStream is = null; FileOutputStream fos = null; try { is = context.getAssets().open(fileName); File file = new File(path); if (file.exists()) { file.delete(); } file.createNewFile(); fos = new FileOutputStream(file); byte[] temp = new byte[1024]; int i = 0; while ((i = is.read(temp)) > 0) { fos.write(temp, 0, i); } } catch (IOException e) { e.printStackTrace(); } finally { try { fos.close(); is.close(); } catch (IOException e) { e.printStackTrace(); } copyIsFinish = true; } return copyIsFinish; }
3.5 接下来是在项目里面使用数据库里面的数据。
首先创建一个LoginService类来操作数据库,比如数据的存储,数据的保存,删除。我在这个类里面只用到了数据的读取和保存。
public class LoginService { private DbUtils dbUtils; private static LoginService loginService; private Context mContext; private LoginService(Context context){ this.mContext = context; dbUtils = DbService.getInstance(context).getUserInfoUtils(); } public static LoginService getInstance(Context context){ if(null == loginService) loginService = new LoginService(context); return loginService; } //根据用户名得到用户的信息 public UserInfo getUserInfoByUserName(String userName){ try{ UserInfo userInfo = dbUtils.findFirst(Selector.from(UserInfo.class).where("USER_NAME","=",userName)); if(null != userInfo){ return userInfo; } }catch (DbException e){ e.printStackTrace(); } return null; } //保存用户信息 public void saveUserInfo(UserInfo userInfo){ try { dbUtils.save(userInfo); }catch (DbException e){ e.printStackTrace(); } } }
然后就是使用了
UserInfo userInfo = new UserInfo(); userInfo.setUsername(userName); userInfo.setPassword(password); //先检查数据库是否已经保存用户数据,如果没有再去进行数据插入 UserInfo pUserInfo = LoginService.getInstance(mContext).getUserInfoByUserName(userName); if(null == pUserInfo){ LoginService.getInstance(mContext).saveUserInfo(userInfo); }
至此,DbUtils模块的使用就完成了,虽然有点繁琐,但是只要按照要求一步步去写完的话,后面的实现和使用还是很简单的。
至于数据库的更新以及创建,后续会陆陆续续的补上的。