Android xUtils3.0使用手冊（二） - 數據庫操作

步驟： 

(1). 創建數據表；

(2). DaoConfig 獲取數據庫的配置信息；

(3).  獲取數據庫實例：  x.getDb(daoConfig);  

(4). 數據庫的增刪改查。

 

1. 創建數據表

    在這里要強調的是，數據庫里面表的創建的時間，只有在你對數據庫里面的操作涉及到這張表的操作時，會先判斷當前的表是否存在，如果不存在，才會創建一張表，如果存在，才會進行相應的CRUD操作。

@Table(name = "person") 
public class person {
    @Column(name = "ID", isId = true, autoGen = true)
    public int id;
    @Column(name = "NAME")
    public String name; // 姓名
    @Column(name = "AGE")
    public int age; // 年齡
    @Column(name = "SEX")
    public String sex; // 性別
11
    @Override
    public String toString() {
 return "person [id=" + id + ", name=" + name + ", age=" + age + ", sex=" + sex + "]";
    }
16 }

上表中包含了db相關注解：

@Check     check約束
@Column    列名
@Finder    一對多、多對一、多對多關系(見sample的Parent、Child中的使用)    
@Foreign  外鍵
@Id        主鍵，當為int類型時，默認自增。 非自增時，需要設置id的值
@NoAutoIncrement  不自增
@NotNull  不為空
@Table    表名
@Transient  不寫入數據庫表結構
@Unique     唯一約束

注解屬性

name (String)       :  表名稱    
isId (boolean)      :  是否為主鍵
autoGen (boolean)   :  是否自增(默認: false)
proprety (String)   :  是否為空(默認: NOT NULL) 

 

2. DaoConfig 獲取數據庫的配置信息

//本地數據的初始化
DbManager.DaoConfig daoConfig = new DbManager.DaoConfig()
        .setDbName("my_db.db") //設置數據庫名
        .setDbVersion(1) //設置數據庫版本,每次啟動應用時將會檢查該版本號,
        // 發現數據庫版本低於這里設置的值將進行數據庫升級並觸發DbUpgradeListener
        .setAllowTransaction(true) //設置是否開啟事務,默認為false關閉事務
        .setTableCreateListener(new DbManager.TableCreateListener() {
                @Override
                public void onTableCreated(DbManager dbManager, TableEntity<?> tableEntity) {
                }
        })
        .setDbOpenListener(new DbManager.DbOpenListener() {
                @Override
                public void onDbOpened(DbManager db) {
                    // 開啟WAL, 對寫入加速提升巨大
                    db.getDatabase().enableWriteAheadLogging();
                }
        })
        // 設置數據庫創建時的Listener
        .setDbUpgradeListener(new DbManager.DbUpgradeListener() {
                @Override
                public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
                    // TODO: ...
                    // db.addColumn(...);
                    // db.dropTable(...);
                    // ...
                    // or
                    // db.dropDb();
                }
        }); //設置數據庫升級時的Listener,這里可以執行相關數據庫表的相關修改,比如alter語句增加字段等
        // .setDbDir(null);//設置數據庫.db文件存放的目錄,默認為包名下databases目錄下
            
DBManager db = x.getDb(daoConfig);

 

3. 獲取數據庫實例

DbManager db = x.getDb(daoConfig);

 

4. 表 操作

通過DbManager這類我們可以做如下操作：

.getDaoConfig  // 獲取數據庫的配置信息
.getDatabase   // 獲取數據庫實例  
.replace       // 只有存在唯一索引時才有用 （慎重）
.dropTable     // 刪除表 
.addColumn     // 添加一列 
.dropDb        // 刪除數據庫

5. 增 操作

try {
    List<person> list = new ArrayList<person>();
    // ... 加載數據

    db.save(list); // 保存實體類或者實體類的List到數據庫
    db.saveOrUpdate(list); // 保存或更新實體類或者實體類的List到數據庫，根據id對應的數據是否存在
    db.saveBindingId(list); // 保存實體類或實體類的List到數據庫，如果該類型的id是自動生成的，則保存完后會給id賦值
} catch (DbException e) {
}

 

6. 刪 操作

try {
    db.delete(person.class);//該方法是刪除表中的全部數據
    db.deleteById(person.class, 12);//該方法主要是根據表的主鍵(id)進行單條記錄的刪除
    db.delete(person.class, WhereBuilder.b("age", ">", "20"));//根據where語句的條件進行刪除操作 
    List<person> findAll = db.selector(person.class).expr("age > 20").findAll();
    db.delete(findAll);//根據實體bean進行對表里面的一條或多條數據進行刪除   
} catch (DbException e) {
}

 

7. 改 操作

// 第一種
try {
    List<Person> findAll = db.findAll(Person.class);
    for (Person person : findAll) {
        person.setAge(10);
    }
    db.update(findAll, "age"); //可以使對象、集合
} catch (DbException e) {
}
// 第二種
try {
    PersonTable person = db.findById(Person.class, 1);
    person.setAge(25);
    db.update(person, "age");
} catch(DbException e){
}

 

8. 查 操作

try {
    db.findById(person.class, 1);//通過主鍵的值來進行查找表里面的數據
    db.findFirst(person.class);//返回當前表里面的第一條數據 
    List<person> findAll = db.findAll(person.class);//返回當前表里面的所有數據 
    db.findDbModelAll(new SqlInfo("select * from person where age > 25"));
    DbModel model = db.findDbModelFirst(new SqlInfo("select * from person where age > 25"));
    model.getString("age");//model相當於游標
    List<person> findAll2 = db.selector(person.class).expr("age >10").findAll();//主要是用來進行一些特定條件的查找
} catch (DbException e) {
}

 

9. 相關資料

☞  Android xUtils3.0使用手冊（一）- 基礎功能使用