編輯:Android資訊
我相信,在平時的開發過程中,大家一定會或多或少地接觸到 SQLite。然而在使用它時,我們往往需要做許多額外的工作,像編寫 SQL 語句與解析查詢結果等。所以,適用於 Android 的ORM 框架也就孕育而生了,現在市面上主流的框架有 OrmLite、SugarORM、Active Android、Realm 與 GreenDAO。而今天的主角便是 greenDAO,下面,我將詳解地介紹如何在 Android Studio 上使用 greenDAO,並結合代碼總結一些使用過程中的心得。
簡單的講,greenDAO 是一個將對象映射到 SQLite 數據庫中的輕量且快速的 ORM 解決方案。(greenDAO is a light & fast ORM solution that maps objects to SQLite databases.)
而關於 ORM (Object Relation Mapping – 對象關系映射)的概念,可參見 Wikipedia。
這是其核心概念:為了在我們的 Android 工程中使用 greenDAO ,我們需要另建一個純 Java Project,用於自動生成後繼 Android 工程中需要使用到的 Bean、DAO、DaoMaster、DaoSession 等類。
關於以上幾個類的相關概念與作用,我將在下面的代碼(注釋)中詳細講解。
當然,你也可以在 官網 中找到相關介紹。
sourceSets { main { java.srcDirs = ['src/main/java', 'src/main/java-gen'] } }
compile 'de.greenrobot:greendao:1.3.7'
compile 'de.greenrobot:greendao-generator:1.3.1'
public class ExampleDaoGenerator { public static void main(String[] args) throws Exception { // 正如你所見的,你創建了一個用於添加實體(Entity)的模式(Schema)對象。 // 兩個參數分別代表:數據庫版本號與自動生成代碼的包路徑。 Schema schema = new Schema(1, "me.itangqi.greendao"); // 當然,如果你願意,你也可以分別指定生成的 Bean 與 DAO 類所在的目錄,只要如下所示: // Schema schema = new Schema(1, "me.itangqi.bean"); // schema.setDefaultJavaPackageDao("me.itangqi.dao"); // 模式(Schema)同時也擁有兩個默認的 flags,分別用來標示 entity 是否是 activie 以及是否使用 keep sections。 // schema2.enableActiveEntitiesByDefault(); // schema2.enableKeepSectionsByDefault(); // 一旦你擁有了一個 Schema 對象後,你便可以使用它添加實體(Entities)了。 addNote(schema); // 最後我們將使用 DAOGenerator 類的 generateAll() 方法自動生成代碼,此處你需要根據自己的情況更改輸出目錄(既之前創建的 java-gen)。 // 其實,輸出目錄的路徑可以在 build.gradle 中設置,有興趣的朋友可以自行搜索,這裡就不再詳解。 new DaoGenerator().generateAll(schema, "/Users/tangqi/android-dev/AndroidStudioProjects/MyGreenDAO/app/src/main/java-gen"); } /** * @param schema */ private static void addNote(Schema schema) { // 一個實體(類)就關聯到數據庫中的一張表,此處表名為「Note」(既類名) Entity note = schema.addEntity("Note"); // 你也可以重新給表命名 // note.setTableName("NODE"); // greenDAO 會自動根據實體類的屬性值來創建表字段,並賦予默認值 // 接下來你便可以設置表中的字段: note.addIdProperty(); note.addStringProperty("text").notNull(); // 與在 Java 中使用駝峰命名法不同,默認數據庫中的命名是使用大寫和下劃線來分割單詞的。 // For example, a property called “creationDate” will become a database column “CREATION_DATE”. note.addStringProperty("comment"); note.addDateProperty("date"); } }
如果在此處出錯,你可以依據錯誤日志進行排查,主要看是否輸出目錄存在?其他配置是否正確?等
這裡,我們只創建一個 NodeActivity 類,用於測試與講解 greenDAO 的增、刪、查功能。
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical"> <LinearLayout android:id="@+id/linearLayout1" android:layout_width="fill_parent" android:layout_height="wrap_content" android:orientation="horizontal"> <EditText android:id="@+id/editTextNote" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_weight="1" android:hint="Enter new note" android:inputType="text"></EditText> <Button android:id="@+id/buttonAdd" android:layout_width="wrap_content" android:layout_height="wrap_content" android:onClick="onMyButtonClick" android:text="Add"></Button> <Button android:id="@+id/buttonSearch" android:layout_width="wrap_content" android:layout_height="wrap_content" android:onClick="onMyButtonClick" android:text="Search"></Button> </LinearLayout> <ListView android:id="@android:id/list" android:layout_width="fill_parent" android:layout_height="wrap_content"></ListView> </LinearLayout>
public class NoteActivity extends ListActivity { private SQLiteDatabase db; private EditText editText; private DaoMaster daoMaster; private DaoSession daoSession; private Cursor cursor; public static final String TAG = "DaoExample"; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_note); // 官方推薦將獲取 DaoMaster 對象的方法放到 Application 層,這樣將避免多次創建生成 Session 對象 setupDatabase(); // 獲取 NoteDao 對象 getNoteDao(); String textColumn = NoteDao.Properties.Text.columnName; String orderBy = textColumn + " COLLATE LOCALIZED ASC"; cursor = db.query(getNoteDao().getTablename(), getNoteDao().getAllColumns(), null, null, null, null, orderBy); String[] from = {textColumn, NoteDao.Properties.Comment.columnName}; int[] to = {android.R.id.text1, android.R.id.text2}; SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, cursor, from, to); setListAdapter(adapter); editText = (EditText) findViewById(R.id.editTextNote); } private void setupDatabase() { // 通過 DaoMaster 的內部類 DevOpenHelper,你可以得到一個便利的 SQLiteOpenHelper 對象。 // 可能你已經注意到了,你並不需要去編寫「CREATE TABLE」這樣的 SQL 語句,因為 greenDAO 已經幫你做了。 // 注意:默認的 DaoMaster.DevOpenHelper 會在數據庫升級時,刪除所有的表,意味著這將導致數據的丟失。 // 所以,在正式的項目中,你還應該做一層封裝,來實現數據庫的安全升級。 DaoMaster.DevOpenHelper helper = new DaoMaster.DevOpenHelper(this, "notes-db", null); db = helper.getWritableDatabase(); // 注意:該數據庫連接屬於 DaoMaster,所以多個 Session 指的是相同的數據庫連接。 daoMaster = new DaoMaster(db); daoSession = daoMaster.newSession(); } private NoteDao getNoteDao() { return daoSession.getNoteDao(); } /** * Button 點擊的監聽事件 * * @param view */ public void onMyButtonClick(View view) { switch (view.getId()) { case R.id.buttonAdd: addNote(); break; case R.id.buttonSearch: search(); break; default: Log.d(TAG, "what has gone wrong ?"); break; } } private void addNote() { String noteText = editText.getText().toString(); editText.setText(""); final DateFormat df = DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM); String comment = "Added on " + df.format(new Date()); // 插入操作,簡單到只要你創建一個 Java 對象 Note note = new Note(null, noteText, comment, new Date()); getNoteDao().insert(note); Log.d(TAG, "Inserted new note, ID: " + note.getId()); cursor.requery(); } private void search() { // Query 類代表了一個可以被重復執行的查詢 Query query = getNoteDao().queryBuilder() .where(NoteDao.Properties.Text.eq("Test1")) .orderAsc(NoteDao.Properties.Date) .build(); // 查詢結果以 List 返回 // List notes = query.list(); // 在 QueryBuilder 類中內置兩個 Flag 用於方便輸出執行的 SQL 語句與傳遞參數的值 QueryBuilder.LOG_SQL = true; QueryBuilder.LOG_VALUES = true; } /** * ListView 的監聽事件,用於刪除一個 Item * @param l * @param v * @param position * @param id */ @Override protected void onListItemClick(ListView l, View v, int position, long id) { // 刪除操作,你可以通過「id」也可以一次性刪除所有 getNoteDao().deleteByKey(id); // getNoteDao().deleteAll(); Log.d(TAG, "Deleted note, ID: " + id); cursor.requery(); } }
一切就緒,讓我們看看效果吧!運行程序,分別執行添加按鈕、刪除(點擊 List 的 Item)與查詢按鈕,可以在控制台得到如下日志:
NanoHttpd是個很強大的開源庫,僅僅用一個Java類,就實現了一個輕量級的 Web Server,可以非常方便地集成到Android應用中去,讓你的App支
Android平台有三種網絡接口可以使用,他們分別是:java.net.*(標准Java接口)、Org.apache接口和Android.net.*(Androi
過年前發了一篇介紹 Translucent System Bar 特性的文章 Translucent System Bar 的最佳實踐 ,收到很多開發者的關注和反
本文由碼農網 – 小峰原創翻譯,轉載請看清文末的轉載要求,歡迎參與我們的付費投稿計劃! 專業的Android app開發人員會關注一些成熟的項目管理技術,