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 {
        	//初始化数据