Android学习手写二：程序升级加入sqlite支持

Android学习手记二：程序升级加入sqlite支持！
我在前面文章中记录了学习第一个android程序的过程及经验总结。
下面是这个教程的升级版。也是应用程序的升级版。
泡茶计时器，第二版带sqllite功能。
此笔记根据经网站教程学习总结得来：
http://coolshell.cn/articles/4334.html
1. sqLite.
现在使用的是sqlite3。如果是在ubuntu等linux发行版的话，安装sqlite等
相关软件是很方便的。安装相关文档也很方便。或者可以轻松在网上找到。
    sqlite数据库最主要的特点是可嵌入一个数据库就是一个文件。创建数据库就是创建文件。基本的sql与标准sql差不多。但是一些事务性的支持不好。但就是可以理解的。
2. 需求程序改进的需求来自于一个基本的认识，就是不同的茶叶所需要的泡茶时间是不同的。
  所以创建一个数据表来存在茶叶泡茶信息，测试过程如下：

[email protected]:~/work$ mkdir sqlite[email protected]:~/work$ cd sqlite/[email protected]:~/work/sqlite$ ls[email protected]:~/work/sqlite$ sqlite3 teas.dbSQLite version 3.7.4Enter ".help" for instructionsEnter SQL statements terminated with a ";"sqlite> create table teas(_ID integer primary key autoincrement,   ...> name text not null,   ...> brew_time integer not null);sqlite> .tablesteassqlite> .schema teasCREATE TABLE teas(_ID integer primary key autoincrement,name text not null,brew_time integer not null);sqlite> 

3. 经历上面过程之后，对于有mysql数据库经验的对于使用及了解sqlite3会有一些感性及理解的了解。这对于开发android上的sqlite应用也就差不多了。
    android提供了完全的sqlite数据库支持。有一个关于数据保护的特点就是。
你应用程序中的任何类都可以用你创建的数据库的数据库名来访问。其它程序则不行。
推荐的创建一个数据库的方式是继承一个SQLiteOpenHelper类，并重写onCreate()方法，在其中执行一条SQLite命令来创建数据库中的数据表。

整个TeaOpenHelper类如下：

package me.banxi.brewclock;import android.app.Activity;import android.content.ContentValues;import android.content.Context;import android.database.Cursor;import android.database.DatabaseUtils;import android.database.sqlite.SQLiteDatabase;import android.database.sqlite.SQLiteDatabase.CursorFactory;import android.database.sqlite.SQLiteOpenHelper;import android.provider.BaseColumns;public class TeasOpenHelper extends SQLiteOpenHelper {	private static final String DATABASE_NAME = "teas.db";	private static final int DATABASE_VERSION = 1;	private static final String TEAS_TABLE_NAME = "teas";	private static final String _ID = BaseColumns._ID;	public static final String NAME = "name";	public static final String BREW_TIME = "brew_time";	private static final String TEAS_TABLE_CREATE = 		String.format("create table %s(" +			"%s integer primary key autoincrement," +			"%s text not null," +			"%s integer not null);",			TEAS_TABLE_NAME,_ID,NAME,BREW_TIME);	public TeasOpenHelper(Context context) {		super(context, DATABASE_NAME, null, DATABASE_VERSION);	}	@Override	public void onCreate(SQLiteDatabase db) {		db.execSQL(TEAS_TABLE_CREATE);	}	@Override	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {		db.execSQL("DROP TABLE IF EXISTS"+TEAS_TABLE_NAME);		onCreate(db);	}		///user defined method		/**	 * 新增茶叶记录	 */	public void insert(String name,int brewTime){		SQLiteDatabase db = getWritableDatabase();		ContentValues values = new ContentValues();		values.put(NAME, name);		values.put(BREW_TIME, brewTime);		db.insertOrThrow(TEAS_TABLE_NAME, null, values);	}		public Cursor all(Activity activity){		String [] columns = {_ID,NAME,BREW_TIME};		String orderBy = NAME;		SQLiteDatabase db = getReadableDatabase();		Cursor cursor = db.query(TEAS_TABLE_NAME, columns, null, null, null, null, orderBy);		return cursor;	}	public long count(){		SQLiteDatabase db = getReadableDatabase();		return DatabaseUtils.queryNumEntries(db, TEAS_TABLE_NAME);	}}

从默认的SQLiteOpenHelper的提供的构造函数来看：

	public TeasOpenHelper(Context context, String name, CursorFactory factory,			int version) {		super(context, name, factory, version);		// TODO Auto-generated constructor stub	}

父类负责创建及维护数据库。
每次实例化sqlite数据库都传递数据库名，及version版本号。
如果发现数据库版本号有新的。就会执行doUpgrade()方法。本类中采用的方法就是。
将原有表删除后重新创建。
字段名声明为常量且公开的。是因为应用程序的其它地方还要在数据绑定等方面需要用到。

teas表的主键声明为做如此声明：

private static final String _ID = BaseColumns._ID;

是android官方推荐的一种做法：
见android文档：docs/guide/topics/data/data-storage.html#db


熟悉sqlite的人知道cursor在sqlite中相当重要。
所以对于从jdbc中走过来的人，在对于sqlite了了解中还要多下些功夫。

上面中涉及数据库重要的变量包括db：SQLiteDatabase类型。
对涉及数据操作的方法：
从SQLiteOpenHelper继承得来的，用于获得db对象的方法：getReadableDatabase()：SQLiteDatebase
    getWritableDatabase():SQLiteDatabase


sqlite主要的查询操作可以使用SQLiteDatabase的query()方法。它接受多种多样的查询参数。
所以对于简单的查询的话，会有很多的null值传递出去：

	public Cursor all(Activity activity){		String [] columns = {_ID,NAME,BREW_TIME};		String orderBy = NAME;		SQLiteDatabase db = getReadableDatabase();		Cursor cursor = db.query(TEAS_TABLE_NAME, columns, null, null, null, null, orderBy);		return cursor;	}

如果需要更复杂的查询如要用到列别名。则需要使用SQLiteQueryBuilder类了。这个类提供了
一些很便利的方法来构造复杂的查询语句。

值得注意的是：每一个SQLite查询都会返回一个指向查询到的行的Cursor对象。

再来仔细看一下插入方法：

	public void insert(String name,int brewTime){		SQLiteDatabase db = getWritableDatabase();		ContentValues values = new ContentValues();		values.put(NAME, name);		values.put(BREW_TIME, brewTime);		db.insertOrThrow(TEAS_TABLE_NAME, null, values);	}

ContentValues对象保存以表字段名作为键的键值对。相当于一个HashMap。
但ContentValues是继承自Object的。不是Java集合框架中的HashMap。
sqlite中的插入都有一个有意外情况处理的方法：

insertOrThrow(String table,String nullColumnHack,ContentValues values)

中间那个nullColumnHack就是当出现有些字段名为空时，就用nullColumnHack中代替。并显式插入空值。

再了解下另一个类，DatabaseUtils类

	/**	 * 	 * @return 返回数据库中记录的行数。	 */	public long count(){		SQLiteDatabase db = getReadableDatabase();		return DatabaseUtils.queryNumEntries(db, TEAS_TABLE_NAME);	}

DatabaseUitls中有一些实用工具方法。全称android.database.DatabaseUtils


下面分析下界面方面的代码茶叶的下拉选择框是用了一个spinner小部件。布局如下：

     <!-- Tea Selection -->   	<LinearLayout   		android:orientation="vertical"   		android:layout_width="fill_parent"   		android:layout_height="wrap_content"   	>   	<Spinner   		android:id="@+id/tea_spinner"   		android:layout_width="fill_parent"   		android:layout_height="wrap_content"   	 />   	</LinearLayout>   	<!--  end Tea Selection -->

数据绑定和事件监听等主要代码如下：

	/** Called when the activity is first created. */    @Override    public void onCreate(Bundle savedInstanceState) {      // 前面代码省略 ....        // 初始化茶叶列表 持久化支持        teaSpinner = (Spinner)findViewById(R.id.tea_spinner);        teasOpenHelper = new TeasOpenHelper(this);               if(teasOpenHelper.count() == 0){        	teasOpenHelper.insert("龙井"	, 3 );        	teasOpenHelper.insert("普洱"	, 2 );        	teasOpenHelper.insert("铁观音" ,3 );        	teasOpenHelper.insert("菊花茶" ,1 );        }                // 绑定数据到spinner        Cursor cursor = teasOpenHelper.all(this);        String [] from = {TeasOpenHelper.NAME	};        int [] to = {android.R.id.text1};        SimpleCursorAdapter teaCursorAdapter = new SimpleCursorAdapter(        		this,         		android.R.layout.simple_spinner_item,         		cursor	, from, to         );          teaSpinner.setAdapter(teaCursorAdapter);        teaCursorAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);                // 设置spinner选择事件监听器        teaSpinner.setOnItemSelectedListener(this);             }	public void onItemSelected(AdapterView<?> spinner, View view, int position,			long id) {		if(spinner == teaSpinner){			Cursor cursor = (Cursor)spinner.getSelectedItem();			setBrewTime(cursor.getInt(2));		}			}	public void onNothingSelected(AdapterView<?> arg0) {		// TODO Auto-generated method stub			}

比较复杂的代码就在绑定数据对spinner那一段了。
android本身的控件的显示也是用xml来布局的。
如
android.R.layout.simple_spinner_dropdown_item
普就可以在对应的jar或者源代码包中找到simple_spinner_dropdown_item.xml布局文件。
不过android.jar包中的xml是已经转化成二进制格式了不能直接打开。

取得选择的项然后转化为Cursor的代码显得不是那么清楚：

	public void onItemSelected(AdapterView<?> spinner, View view, int position,			long id) {		if(spinner == teaSpinner){			Cursor cursor = (Cursor)spinner.getSelectedItem();			setBrewTime(cursor.getInt(2));		}			}

未完待续----------------------