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

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

banxi1988@banxi:~/work$ mkdir sqlite
banxi1988@banxi:~/work$ cd sqlite/
banxi1988@banxi:~/work/sqlite$ ls
banxi1988@banxi:~/work/sqlite$ sqlite3 teas.db
SQLite version 3.7.4
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite> create table teas(_ID integer primary key autoincrement,
   ...> name text not null,
   ...> brew_time integer not null);
sqlite> .tables
teas
sqlite> .schema teas
CREATE 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

引用

Android does not impose any limitations beyond the standard SQLite concepts. We do recommend including an autoincrement value key field that can be used as a unique ID to quickly find a record. This is not required for private data, but if you implement a content provider, you must include a unique ID using the BaseColumns._ID constant.

熟悉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));
		}
		
	}

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