ActiveAndroid使用手冊中文版

存儲表和列的命名

不要使用以下的詞來命名表和列：

ABORT               DEFAULT         INNER         REGEXP
ACTION              DEFERRABLE      INSERT        REINDEX
ADD                 DEFERRED        INSTEAD       RELEASE
AFTER               DELETE          INTERSECT     RENAME
ALL                 DESC            INTO          REPLACE
ALTER               DETACH          IS            RESTRICT
ANALYZE             DISTINCT        ISNULL        RIGHT
AND                 DROP            JOIN          ROLLBACK
AS                  EACH            KEY           ROW
ASC                 ELSE            LEFT          SAVEPOINT
ATTACH              END             LIKE          SELECT
AUTOINCREMENT       ESCAPE          LIMIT         SET
BEFORE              EXCEPT          MATCH         TABLE
BEGIN               EXCLUSIVE       NATURAL       TEMP
BETWEEN             EXISTS          NO            TEMPORARY
BY                  EXPLAIN         NOT           THEN
CASCADE             FAIL            NOTNULL       TO
CASE                FOR             NULL          TRANSACTION
CAST                FOREIGN         OF            TRIGGER
CHECK               FROM            OFFSET        UNION
COLLATE             FULL            ON            UNIQUE
COLUMN              GLOB            OR            UPDATE
COMMIT              GROUP           ORDER         USING
CONFLICT            HAVING          OUTER         VACUUM
CONSTRAINT          IF              PLAN          VALUES
CREATE              IGNORE          PRAGMA        VIEW
CROSS               IMMEDIATE       PRIMARY       VIRTUAL
CURRENT_DATE        IN              QUERY         WHEN
CURRENT_TIME        INDEX           RAISE         WHERE
CURRENT_TIMESTAMP   INDEXED         RECURSIVE     WITH
DATABASE            INITIALLY       REFERENCES    WITHOUT

(其實就是一大波SQL裡的關鍵字)
如果你發現還有其他的，請告訴我。

保存到數據庫

現在你已經做好了數據庫模型，然後我們來看一下怎麼把記錄保存到數據庫。

插入和更新記錄

為了保存一條新的記錄，只需要創建activeandroid.Model類的一個實例，給其中的字段賦上值，然後調用.save()方法。save方法用於插入和更新記錄。
下面是一個例子

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

Item item = new Item();
item.category = restaurants;
item.name = "Outback Steakhouse";
item.save();

添加一些items

item = new Item();
item.category = restaurants;
item.name = "Red Robin";
item.save();

item = new Item();
item.category = restaurants;
item.name = "Olive Garden";
item.save();

大量插入

為了同時插入多條記錄，你可以使用事務。在事務之間做插入操作可以提升速度。下面是一個例子：

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();
}

在事務之中執行大約耗時40毫秒，如果不寫在事務之間耗時大約4秒。

刪除記錄

怎麼刪除記錄呢？刪除一條記錄只需要調用delete()方法。下面的例子我們通過Id來load一個Item對象並且刪除它。

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

或者你可以靜態地刪除

Item.delete(Item.class, 1);

你還可以構建查詢語法來刪除

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

查詢數據庫

在ActiveAndroid中所有的查詢操作都通過構建查詢的語句或者調用Model.method。
這是目前我們完成了的：

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

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

我們希望隨機得到一條記錄，增加一個方式來實現這個功能。

public static Item getRandom() {
    return new Select()
    .orderBy("RANDOM()")
    .executeSingle();
}

在ActiveAndroid中創建一個查詢類似於創建一條普通的SQL語句。我們創建一個新的select對象，在Item類中完成查詢的功能。調用orderBy來做隨機。調用execute()方法來執行查詢，或者像下面的例子使用executeSingle()。
如果我們只是想從一個確定的category中查詢，我麼只需給方法的參數傳入值就可以了。方法如下：

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

下面是通過一個category來獲取所有items，按照name屬性排序。

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

類型序列化

ActiveAndroid可以處理默認的數據類型，如果需要處理自定義類型，可以使用TypeSerializer類來做到。最好的學習方法就是通過例子，下面以Date類型舉例。
當我們創建一個TypeSerializer類型時我們必須想辦法把自定義的類型轉換為基本數據類型讓ActiveAndroid來處理。Date類型可以轉換為Long型，這樣我們就可以使用了。
下面是例子。

final public class UtilDateSerializer extends TypeSerializer {
    @Override
    public Class getDeserializedType() {
        return Date.class;
    }

    @Override
    public Class getSerializedType() {
        return Long.class;
    }

    @Override
    public Long serialize(Object data) {
        if (data == null) {
            return null;
        }

        return ((Date) data).getTime();
    }

    @Override
    public Date deserialize(Object data) {
        if (data == null) {
            return null;
        }

        return new Date((Long) data);
    }
}

第一個方法getDeserializedType返回我們進行序列化的的class，對於Date類型我們就返回Date.class。
第二個方法返回相反的類型，也就是我們希望把Date類型保存時所用的類型（這裡就是Long型）。我們使用枚舉類型來代替字符串類型。下面是這個方法的枚舉類。(這一句翻譯得可能不准確，因為我也不知道下面的枚舉類有什麼作用，看懂的童鞋請告訴我)

public enum SQLiteType {
    INTEGER, REAL, TEXT, BLOB
}

再下一個方法就是把我們自定義的類型轉換為ActiveAndroid可以保存的類型，這裡使用了getTime()方法返回了一個Long型對象。
最後一個方法是把保存在數據庫的數據轉換為自定義類型，Date類型可以使用Long型來構對象，所以我們使用一個Long來生成一個Date對象。
最後在AndroidManifest.xml中注冊我們自定義的類型。

mySpinner.setAdapter(new SimpleCursorAdapter(getActivity(),
    android.R.layout.simple_expandable_list_item_1,
    null,
    new String[] { "MyProperty" },
    new int[] { android.R.id.text1 },
    0));

getActivity().getSupportLoaderManager().initLoader(0, null, new LoaderCallbacks() {
    @Override
    public Loader onCreateLoader(int arg0, Bundle cursor) {
        return new CursorLoader(getActivity(),
        ContentProvider.createUri(MyEntityClass.class, null),null, null, null, null);
    }

    @Override
    public void onLoadFinished(Loader arg0, Cursor cursor) {
        ((SimpleCursorAdapter)mySpinner.getAdapter()).swapCursor(cursor);
    }

    @Override
    public void onLoaderReset(Loader arg0) {
        ((SimpleCursorAdapter)mySpinner.getAdapter()).swapCursor(null);
    }
});

    
    ...

ALTER TABLE Items ADD COLUMN color INTEGER;

CREATE TABLE "android_metadata" ("locale" TEXT DEFAULT 'en_US')
INSERT INTO "android_metadata" VALUES ('en_US')

@Table(name = "Items", id = "_id")
public class Item extends Model {