这章讲的是框架的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 {@Overridepublic 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模块的使用就完成了,虽然有点繁琐,但是只要按照要求一步步去写完的话,后面的实现和使用还是很简单的。
至于数据库的更新以及创建,后续会陆陆续续的补上的。