xutils db使用详解

作者：carry
== 相关网站==
http://www.tuicool.com/articles/jQnMRjB

== github Deom下载==
https://github.com/wyouflf/xUtils3/tree/master

== 使用Gradle构建时添加一下依赖即可==<pre>
compile 'org.xutils:xutils:3.3.34'</pre>

== Model的设置==
1.之前传统的model

 public class DayModel{
    //不可以少
    @Column(name = "id", isId = true)
    public int id;
    /**
     * 天的日期
     */
    public String dayTime;
    /**
     * 用户采集备注信息
     */
    public String olapInfo;
    /**
     * 训练的entity
     */
    public ArrayList<DayTrainModel> lstItem;
 }

2.若使用xUtils DB的model

 @Table(name = "dayTable")
 public class DayModel{
    //不可以少
    @Column(name = "id", isId = true)
    public int id;
    /**
     * 天的日期
     */
    @Column(name = "dayTime")
    public String dayTime;
    /**
     * 用户采集备注信息
     */
    @Column(name = "olapInfo")
    public String olapInfo;
    /**
     * 训练的entity
     */
    public ArrayList<DayTrainModel> lstItem;
 }

3.常用字段可以通过extend来实现

 public class BaseDBModel {
    //不可以少
    @Column(name = "id", isId = true)
    public int id;
    @Column(name = "userId")
    public String userId = FitApplication.userModel.userId;//用户id
 }

 @Table(name = "dayTable")
 public class DayModel extend BaseDBModel{
    /**
     * 天的日期
     */
    @Column(name = "dayTime")
    public String dayTime;
    /**
     * 用户采集备注信息
     */
    @Column(name = "olapInfo")
    public String olapInfo;
    /**
     * 训练的entity
     */
    public ArrayList<DayTrainModel> lstItem;
 }

4.PS
遇到ArrayList<DayTrainModel> 这一类的 数组数据，xUtil3未支持直接保存.
解决方法:
将ArrayList<DayTrainModel> DayTrainModel当做一张表来操作，进行增删改查.
简单说就是将dayTime，olapInfo 字段先存储在DayModel中
再将ArrayList<DayTrainModel> 数据取出 存入DayTrainModel中

== xUtilsDB 使用方法==
1.获得对象

 XUtilDB xdb = XUtilDB.getInstance()

2.DB操作方法

 //查询(全部)
 List list = xdb.selectInfo(TestModel.class);
 
 //查询+条件
 Selector selector = xdb.getDBSelector(TestModel.class);//获取操作查询的对象
 selector.where("userId", "=", 10086).and("isShow", "=", 0).limit(10);//order by,group by 等等都有
 List list = xdb.selectInfo(selector);

 //查询(存在条数)
 int count = xdb.getCount(selector);

 //查询(DB里的首相)
 <?>Obj = xdb.getFrist(selector);

 //添加(单个)
 TestModel model = new TestModel();
 model.time="20:00";
 model.userId="10086";
 xdb.addInfo(model);

 //添加(list)
 ArrayList<TestModel> testList=mew ArrayList<TestModel>();
 testList.add(model);
 xdb.addInfo(testList);

 //更新+条件
 xdb.updateInfo(TestModel.class,
     WhereBuilder.b("id", "=", 1).and("userId", "=", "10086"),
     new KeyValue("time", "19:59")...);
  );

 //删除(整张表)
 xdb.deletInfo(TestModel.class);

 //删除+条件
 xdb.deletInfo(TestModel.class,WhereBuilder.b(userId", "=", "10086"));

== xUtilsDB 更新DB相关操作==
1.setDbUpgradeListener 中操作更新的表结构等

  daoConfig = new DbManager.DaoConfig().setDbDir(getFile(ConstantUtils.APP_DB_PATH))
                .setDbName(dbName)//创建数据库的名称
                .setDbVersion(dbVersion)//数据库版本号
                .setDbOpenListener(new DbManager.DbOpenListener() {
                    @Override
                    public void onDbOpened(DbManager db) {
                        // 开启WAL, 对写入加速提升巨大
                        db.getDatabase().enableWriteAheadLogging();
                    }
                }).setDbUpgradeListener(new DbManager.DbUpgradeListener() {
                    @Override
                    public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
                        //进行操作
                        //添加字段
                        db.addColumn(DayModel.class,"mouth");
                        //删除表
                        db.dropTable(TestModel.class);
                        //删除库
                        db.dropDb();
                        ...
                    }
                });

2.使用xUtil的model修改

 @Table(name = "dayTable")
 public class DayModel implements Serializable {
   /**
    * 天的日期
    */
   @Column(name = "dayTime")
   public String dayTime;
   /**
    * 用户采集备注信息
    */
   @Column(name = "olapInfo")
   public String olapInfo;
   /**
    * 月
    */
   @Column(name = "mouth")
   public String mouth;
   /**
    * 训练的entity
    */
   public ArrayList<DayTrainModel> lstItem;
 }

3.注意事项
如果仅更新model,setDbUpgradeListener未声明，会报错（找不多对应列名）
原因是，此model已经被创建成表，所以现在并不会重复创建，
需要特意什么添加字段类似于去动DB的操作

== 注意事项==
1.切记 不可平凡 调用增删改操作

 for (int i = 0; i < list.size(); i++) {
  try {
       ArrayList<TestModel> list = (ArrayList<TestModel>) xDb.selectInfo(TestModel.class, value);
   } catch (DbException e) {
     e.printStackTrace();
   }
 }

PS：平凡的操作 会非常耗时，造成卡顿

建议：
①findAll，把数据全部取出之后对数据进行一些整合处理
②Model结构 定义的时候多考虑清除 避免复杂的整合数据
③Model类型相同的场合，不同界面使用 可以通过定义不同的库名 方便数据的分离