OrmLite-更符合面向對象的資料庫操作方式

1. jar包下載下載地址：http://ormlite.com/releases/，一般用core和android包即可。如果使用的是android studio，也可以直接通過module settings加入依賴。 2. 實體類使用OrmLite創建表不需要寫任何SQL語句，而是通過創建 ...

1. jar包下載

下載地址：http://ormlite.com/releases/，一般用core和android包即可。

如果使用的是android studio，也可以直接通過module settings加入依賴。

2. 實體類

使用OrmLite創建表不需要寫任何SQL語句，而是通過創建一個對應的實體類，通過這一實體類建表，即一張表對應一個實體類，而數據表中的欄位以及欄位屬性則通過給實體類的屬性添加註解進行設置。這也就是OrmLite比起安卓原生的資料庫操作方式更符合面向對象思想的地方。

需要註意的是，實體類必須有無參的構造函數，否則會報錯。

常用註解：

@DatabaseTable(tableName="table_name")：加在類定義前，設置表名，不設置則預設表名為實體類的類名。

@DatabaseField：實體類的屬性前若加了這個註解，則該屬性作為數據表的欄位，不加的話，創建數據表時則忽略該屬性。

常用參數有：generatedId：true則聲明該欄位為主鍵並自動增長；

columnName：設置欄位名，不設置則預設同屬性名；

dataType：設置數據類型，不設置則同屬性類型，類型定義在DataType中；

canBeNull：設置欄位是否允許為空，預設為true；

unique：添加唯一約束；

foreign：設置該欄位為外鍵，一般是引用另一個實體類的ID。比如A實體類中有一個屬性B，而資料庫中是沒有B這樣一個數據類型的，則通過外鍵形式存儲B的ID；

foreignAutoRefresh：外鍵自動更新；

foreignAutoCreate：外鍵不存在時是否自動添加；

foreignColumnName：指定作為外鍵的欄位，不設置則預設為主鍵列。

@ForeignCollectionField：自動把所有參照本類的外鍵元素加入。比如Company公司類有個屬性Collection

@DatabaseTable(tableName = "tb_student")
public class Student {

    @DatabaseField(generatedId = true)
    private int id;
    
    @DatabaseField(columnName = "stu_name", dataType = DataType.STRING, canBeNull = false)
    private String name;
    
    @DatabaseField
    private int age;
    
    @DatabaseField
    private String phone;

    public Student(String name, int age, String phone) {
        this.name = name;
        this.age = age;
        this.phone = phone;
    }

    // 若添加了有參的構造方法，則必須添加顯性的無參構造方法
    public Student() {}

    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 int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getPhone() {
        return phone;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }
}

3. 資料庫幫助類

定義了實體類之後，就要寫一個幫助類進行創建和更新資料庫，繼承自OrmLiteSqliteOpenHelper，最好為單例模式。

繼承的類與SQLiteOpenHelper基本一致，不同的是，OrmLiteSqliteOpenHelper為我們提供了一個TableUtils類進行數據表的添加與刪除操作，更加簡便，也更加符合面向對象的思想：

創建表：TableUtils.createTable(ConnectionSource connectionSource, Class<? extends Object> dataClass)

刪除表：TableUtils.dropTable(ConnectionSource connectionSource, Class<? extends Object> dataClass, boolean igoreErrors)

public class DatabaseHelper extends OrmLiteSqliteOpenHelper {

    private final static int DATABASE_VERSION = 1;

    private static DatabaseHelper sHelper;

    private DatabaseHelper(Context context) {
        super(context, "test.db", null, DATABASE_VERSION);
    }

    // 單例模式
    public static synchronized DatabaseHelper getInstance(Context context) {
        if (sHelper == null) {
            sHelper = new DatabaseHelper(context);
        }
        return sHelper;
    }

    @Override
    public void onCreate(SQLiteDatabase database, ConnectionSource connectionSource) {
        try {
            // 創建表，傳入連接源與實體類
            TableUtils.createTable(connectionSource, Person.class);
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }

    @Override
    public void onUpgrade(SQLiteDatabase database, ConnectionSource connectionSource, int oldVersion, int newVersion) {
    }
}

4. 資料庫操作類

OrmLite專門封裝了一個Dao類對資料庫中的數據進行操作，每操作一個數據表，則通過幫助類對象調用getDao()方法獲取相應的Dao對象，類型需指定兩個泛型，第一個是相應的實體類，第二個是ID的數據類型，例如Dao<Person, Integer> dao = helper.getDao(Person.class);。

插入：

（1）dao.create()：參數是相應的實體類對象。

Person p = new Person("Tim", "男", 22);
dao.create(p);

（2）dao.createOrUpdate()：插入或更新，即插入記錄ID存在時則更新數據。

（3）dao.createIfNotExists()：如果插入記錄不存在則插入。

更新：更新的方法有兩種，第一種是直接調用SQL語句，第二種是通過UpdateBuilder對象實現。

（1）通過dao.updateRaw(String statement, String... arguments)：直接調用原生SQL語句，第一個參數為SQL語句，後面的可變參數為占位符對應的值。

dao.updateRaw("update tb_name set name = ?, age = ? where id = ?", "Tim", 22, 2);

（2）通過UpdateBuilder實現：

設置條件的常用函數有：eq()某欄位等於多少、gt()大於多少、lt()小於多少、and()並且、or()或者...等等。根據英文記憶比較容易，例如大於gt()->greater than、小於lt()->less than。

// 獲取UpdateBuilder對象
UpdateBuilder builder = dao.updateBuilder()
// 設置更新範圍
builder.setWhere(update.where().eq("id", 1).or().gt("age", 16));// id等於1或者age大於16
// 設置更新值
builder.updateColumnValue(...)
// 更新
builder.update()

查詢：查詢的方法有很多種，這裡介紹幾種比較常用的：

（1）dao.queryForAll()：查詢全部記錄，不需要參數，相當於SQL中的select * from tb_name;

（2）dao.queryForEq(String fieldName, Object value)：根據某欄位的值查詢，第一個參數為欄位名，第二個參數為值。

List<Person> persons = dao.queryForEq("name", "Tim");

（3）dao.queryForId(Integer id)：根據id查詢。

PS：查詢也可以通過類似於更新的方法，使用QueryBuilder進行查詢。

刪除：刪除的方法也有多種，可以通過delete()方法傳入實體類對象刪除相應記錄，可以通過deleteById()傳入id進行刪除，也可以類似更新的方法，通過DeleteBuilder對象進行刪除。

5. 事務

通過OrmLite使用事務時，直接把內容裝進下麵的回調函數中即可，Callable的泛型指定返回值的類型，不需要返回值則傳入Void。

TransactionManager.callInTransaction(helper.getConnectionSource(), 
    new Callable<Void>() {
        @Override
        public Void call() throws Exception {
            // 需要在事務中進行的操作
        }
    });