AndroidDataFramework - 通过XML文件来定义Sqlite数据库
AndroidDataFramework 是Android平台上一个数据库定义框架,通过该框架可以简单的通过XML文件来定义Sqlite数据库. AndroidDataFramework 刚发布1.0版本,功能还不是很完善,但也可以简单使用了.下面就来看看如何使用:
下载类库:
http://androiddataframework.googlecode.com/files/com.android.DataFramework.jar
如果你想查看示例代码可以下载这个文件:
http://androiddataframework.googlecode.com/files/Prueba%20DataFramework.tar.gz
本教程使用 的示例代码就是来自于上面的文件中.
下载好类库后,用Eclipse新建Android项目,并且把下载后的jar库加入类建构路径中.
这样环境就设置好了.
1.sqlite数据库的定义:
要定义Sqlite数据库,只需要创建如下文件:
res/xml/tables.xml
注意: 定义数据库表结构的文件必须位于res/xml/目录下且文件名字必需为 tables.xml.
很明显这是一个XML文件,里面定义了数据库表结构.
<!-- 使用该文件来定义数据库和数据表,这里定义了数据库名字为notes_db,两个数据表 notes和categories --><DATABASE version="1" name="notes_db"><TABLE class=ke-zeroborder name="notes" to-string="%title%"><FIELD name="title" size="128" type="text" obligatory="true"><FIELD name="body" type="text" obligatory="true"><FIELD name="category_id" type="foreign-key" foreign-table="categories"></FIELD></FIELD></FIELD></TABLE><TABLE class=ke-zeroborder name="categories" to-string="%name%description%"backup="no"><FIELD name="name" size="128" type="string-identifier"obligatory="true"><FIELD name="description" size="128" type="text" obligatory="true"></FIELD></FIELD></TABLE></DATABASE>
注意上面 table 中的 to-string 属性的定义:在 AndroidDataFramework 中,每条表记录用一个Entity来表示, to-string定义了用那些表中的字段来显示toString信息.如果有多个字段用%分割,例如第一个表格中的定义:
to-string="%name%description%"
field中的obligatory="true"属性指定该字段是否为必需的; 而type="string-identifier"指定该属性的类型,目前type的类型有 string-identifier 和 text(在定义数据表初始数据的时候使用):
string-identifier:说明该字段的取值来自于 res/values/strings.xml 中定义的文字内容
text:说明该字段的内容就是里面的文本
2 sqlite数据库表初始数据的定义:
初始化数据在如下文件中定义:
res/xml/initialvalues_v1.xml
文件名中的initialvalues_是不能修改的,而后面的v1代表数据库的版本号.
<VALUES> <!-- table 指定数据所属的表格, id定义该数据的id值 --> <ROW id=1 table="categories"> <!-- 由于在tables.xml文件中定义的name field的类型为string-identifier,说明其初始化值取之于strings.xml中的定义所以这里的name值对应为strings.xml中work的字符串值. --> <FIELD name="name" value="work"> <!-- description的类型为text,为这里定义的字符串 --> <FIELD name="description" value=" for work"> </FIELD> <ROW id=2 table="categories"> <FIELD name="name" value="friends"> <FIELD name="description" value=" for friends"> </FIELD> </FIELD> </ROW> </FIELD> </ROW></VALUES>
AndroidDataFramework 的使用请参考下面的Java代码:
package org.goodev;import android.app.ListActivity;import android.content.Intent;import android.database.Cursor;import android.os.Bundle;import android.view.Menu;import android.view.MenuItem;import android.view.View;import android.widget.ListView;import android.widget.SimpleCursorAdapter;import com.android.dataframework.DataFramework;public class PruebaDataFramework extends ListActivity { private static final int ACTIVITY_CREATE=0; private static final int ACTIVITY_EDIT=1; private static final int INSERT_ID = Menu.FIRST; private static final int DELETE_ID = Menu.FIRST + 1; private static final int BACKUP_ID = Menu.FIRST + 2; private static final int RESTORE_ID = Menu.FIRST + 3; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.notes_list); try { //初始化数据库,org.goodev为项目的package名字 DataFramework.getInstance().open(this, "org.goodev");} catch (Exception e) {e.printStackTrace();}fillData(); } private void fillData() { //得到notes表格的Cursor Cursor notesCursor = DataFramework.getInstance().getCursor("notes"); //manage该Cursor startManagingCursor(notesCursor); String[] from = new String[] {"title"}; int[] to = new int[]{R.id.text1}; SimpleCursorAdapter notes = new SimpleCursorAdapter(this, R.layout.notes_row, notesCursor, from, to); setListAdapter(notes); } @Override public boolean onCreateOptionsMenu(Menu menu) { super.onCreateOptionsMenu(menu); menu.add(0, INSERT_ID, 0, R.string.menu_insert); menu.add(0, DELETE_ID, 0, R.string.menu_delete); menu.add(0, BACKUP_ID, 0, "Backup"); menu.add(0, RESTORE_ID, 0, "Restore"); return true; } @Override public boolean onMenuItemSelected(int featureId, MenuItem item) { switch(item.getItemId()) { case INSERT_ID: createNote(); return true; case BACKUP_ID: try { //备份数据到xml文件的功能 DataFramework.getInstance().backup("/sdcard/backup-notes.xml"); } catch (Exception e) { } return true; case RESTORE_ID: try { DataFramework.getInstance().emptyTablesBackup(); //恢复数据的功能 DataFramework.getInstance().restore("/sdcard/backup-notes.xml"); fillData(); } catch (Exception e) { } return true; case DELETE_ID: //清空数据表 DataFramework.getInstance().emptyTable("notes"); fillData(); return true; } return super.onMenuItemSelected(featureId, item); } private void createNote() { Intent i = new Intent(this, NoteEdit.class); startActivityForResult(i, ACTIVITY_CREATE); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { super.onListItemClick(l, v, position, id); Intent i = new Intent(this, NoteEdit.class); i.putExtra(DataFramework.KEY_ID, id); startActivityForResult(i, ACTIVITY_EDIT); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) { super.onActivityResult(requestCode, resultCode, intent); fillData(); } }AndroidDataFramework 项目主页:http://code.google.com/p/androiddataframework/ 1 楼 fjzzmike 2011-12-07 俺也在学习这个框架，已经支持blob，看看如何使用。