Android輕量級ORM框架ActiveAndroid入門教程(轉)


注:沒有找到出處,如有侵犯,請告知

 

開始ActiveAndroid神奇之旅:

在AndroidManifest.xml中我們需要添加這兩個

  • AA_DB_NAME (數據庫名稱,這個name不能改,但是是可選的,如果不寫的話 是默認的"Application.db"這個值)
  • AA_DB_VERSION (數據庫版本號,同樣是可選的 – 默認為1)

 

<manifest ...>
    <application android:name="com.activeandroid.app.Application" ...>

        ...

        <meta-data android:name="AA_DB_NAME" android:value="Pickrand.db" />
        <meta-data android:name="AA_DB_VERSION" android:value="5" />

    </application>
</manifest>


這個<application>是必須指定的,但你也可以使用自己的Application,繼承自com.activeandroid.app.Application

public class MyApplication extends com.activeandroid.app.Application { ...


如果你不想或者不能繼承com.activeandroid.app.Application的話,那么就這樣

public class MyApplication extends SomeLibraryApplication {
    @Override
    public void onCreate() {
        super.onCreate();
        ActiveAndroid.initialize(this);
    }
    @Override
    public void onTerminate() {
        super.onTerminate();
        ActiveAndroid.dispose();
    }
}


ActiveAndroid.initialize(this);做初始化工作,ActiveAndroid.dispose();做清理工作


創建數據庫模型
我們使用@Table(name = "Items")來表示表,使用@Column(name = "Name")來表示列,ActiveAndroid會使用自增長的ID作為主鍵,然后按照注解描述,將類對應映射為數據庫表。

@Table(name = "Categories")
public class Category extends Model { 
    @Column(name = "Name")
    public String name;
}

@Table(name = "Items")
public class Item extends Model {
    @Column(name = "Name")
    public String name;

    @Column(name = "Category")
    public Category category;
}



依賴關系的數據庫表
假如Item和Category是多對一的關系,那么我們可以這樣子創建他們的類

@Table(name = "Items")
public class Item extends Model {
    @Column(name = "Name")
    public String name;
    @Column(name = "Category")
    public Category category;
}

 

@Table(name = "Categories")
public class Category extends Model {
    @Column(name = "Name")
    public String name;
    //方法可選,對外鍵創建沒有影響
    public List<Item> items() {
        return getMany(Item.class, "Category");
    }



初始化工作做好,讓我們看一下如何保存和更新數據到數據庫
單個插入
保存Category對象

Category restaurants = new Category();
restaurants.name = "Restaurants";
restaurants.save();



批量插入
如果你要批量插入數據,最好使用事務(transaction)。

ActiveAndroid.beginTransaction();
try {
        for (int i = 0; i < 100; i++) {
            Item item = new Item();
            item.name = "Example " + i;
            item.save();
        }
        ActiveAndroid.setTransactionSuccessful();
}
finally {
        ActiveAndroid.endTransaction();
}


使用事務的話只用了 40ms,不然的話需要4秒。


刪除記錄
我們有三種方式刪除一條記錄

Item item = Item.load(Item.class, 1);
item.delete();

 

Item.delete(Item.class, 1);

 

new Delete().from(Item.class).where("Id = ?", 1).execute();


好吧!是不是感覺so easy!


查詢數據庫
作者將查詢做的非常像SQLite的原生查詢語句,幾乎涵蓋了所有的指令 com.activeandroid.query包下有以下類

  • Delete
  • From
  • Join
  • Select
  • Set
  • Update


看實際例子

public static Item getRandom(Category category) {
    return new Select()
        .from(Item.class)
        .where("Category = ?", category.getId())
        .orderBy("RANDOM()")
        .executeSingle();
}


對應的sqlite查詢語句就是 select * from Item where Category = ? order by RANDOM()

那么下面代碼對應的sqlite查詢語句作用是什么,嘗試去告訴我吧?

public static List<Item> getAll(Category category) {
    return new Select()
        .from(Item.class)
        .where("Category = ?", category.getId())
        .orderBy("Name ASC")
        .execute();
}



當然還支持其他非常多的指令,你可以從github上面的測試用例去了解~


最后,咱們來嘗試升級數據庫
很多情況下,我們需要在原來數據庫的基礎上增加字段,而又顧忌用戶原來保存的數據,不想刪除原來的數據表再重新建表,因此我們需要這樣做:

1、首先,你需要更改AndroidManifest.xml中數據庫版本號AA_DB_VERSION(必須比上一版本號大的正整數)

2、其次,你需要在assest目錄里面創建sql文件,目錄結構(/migrations/升級后的版本號.sql),文件里面你需要寫上你變動數據庫的sql語句(一行一句sql語句),比如我們想在Category表里增加Count字段來統計數量,我們需要這樣寫:

ALTER TABLE Category ADD COLUMN Count INTEGER;


3、最后,你需要在Category對象里面添加的對應字段(如果有增加字段的話,添加規則參考上面創建數據庫模型

 

 

還有園子里的一篇文章:

http://www.cnblogs.com/jack-1900/p/3876728.html

 

ORM輕量級框架---ActiveAndroid

 

ORM即Object-Relational Mapping,對象關系映射。簡單理解就是把我們Java的對象與數據庫里面的記錄進行映射,可以把實體對象持久化到數據庫中,也能把查詢到的記錄映射成Java對象。ORM讓我們徹底解放,一點也不需要再去編寫冗長晦澀的Sql語句,一切都是通過框架去做,不得不說是程序員的一大福音。

ORM框架實現的原理其實也很簡單,就是利用Java的反射機制把對象和數據庫記錄映射關聯起來。比如存儲的時候,是把對象的屬性取出來作為記錄的屬性值進行插入;而查詢的時候則是把查詢條件自動構建成一條Sql語句,把查詢到的結果集轉成對象列表。J2EE有ibatis,Hibernate框架,我們Android也有GreenDAO,ormlite,xUtils,AFinal等。它們的實現原理都一樣,不同的也只是細節方面的處理。如果興趣的同學,推薦閱讀下ActiveAndroid的源碼。Reading the fucking code!

以前寫過介紹xUtils的系列文章,其中的FinalDb模塊就是一個ORM框架,也是我工作中常用的。今天我們介紹的ActiveAndroid的API也是相當的簡單友好,而且功能一樣的強大。ActiveAndroid簡潔的API給人一種用起來很舒服的感覺,今天主要是介紹下關於CRUD的簡單使用。

一、初始化

有兩種方式,一種是配置AndroidManifest的application的name屬性,同時在meta-data標簽中可選的配置db的name和version;二是在自己的Application類中繼承ActiveAndroid的Application;前兩種方式入侵性太強,還有一種只需在自定義的Application中靜態的注入兩個方法即可。

 

 

二、定義實體類

實體類需繼承Model,可自定義表名和屬性對應的字段名

三、插入

可以實現單條數據插入,也可以批量插入,同時也支持事務。

四、刪除

支持基於引用的單條記錄刪除,也支持根據條件進行批量刪除。

五、更新

自Model中繼承來的save方法,不僅可以進行insert、還可以update;同時也能基於條件進行批量的更新。

六、查詢

ActiveAndroid的查詢API基本與sql語句的關鍵字一致,比較友好。這點和xUtils是一樣的

寫在最后:ORM框架使用起來確實是很方便的,給我們編碼提高了效率,但是也有着致命弊端。前面我們也介紹了ORM的實現的原理是Java的反射機制,反射有個缺點,就是會造成效率不高、耗時較長的現象。當有數據批量操作的時候,會把耗時加長好幾倍。所以當遇到業務中有很多的記錄要處理的時候,就不推薦大家使用框架了,還是老老實實的寫比較靠譜。今天干貨分享到此為止,希望可以幫助到大家。

 

如果覺得對你有所幫助,歡迎大家訂閱我的微信公眾賬號——Android干貨分享(ID:android_share)。下面是微信的二維碼,為你提供及時高質的Android干貨。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM