在Android应用中使用SQLite数据库的方法

最近在完成创训项目——一个基于地图的记事本小应用的时候，用到了Android手机自带的SQLite数据库，于是来总结一下它的用法。

众所周知，Android手机中内置了一个轻量级的数据库：SQLite，它也是一个关系型数据库，然而非常小，占用资源非常少，但麻雀虽小五脏俱全，我们基本可以认为它是一个精简版的MySQL数据库，同样可以通过SQL语句来操作。

下面就记录下它的使用步骤：

1、实现一个SQLiteOpenHelper类

package com.tt.utils;

import org.junit.Test;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

public class DBOpenHelper extends SQLiteOpenHelper{

	/**
	 * 
	 * @param context 上下文对象
	 * @param name    数据库名称
	 * @param factory   不用管
	 * @param version   数据库版本号
	 */
	public DBOpenHelper(Context context) {
		super(context, "quicknote2.db", null, 1);
	}

	/**
	 * 创建数据库
	 */
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL("CREATE TABLE person(user varchar(20) primary key,pwd varchar(20))");
		db.execSQL("CREATE TABLE contenttable(username varchar(20),password varchar(20),content varchar(300),latitude varchar(20),longitude varchar(20))");
		}

	/**
	 * 修改数据库表结构的方法
	 */
	@Override
	public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {
		
	}

}

这个类相当于是操作SQLite数据库的最底层的类，其中有一点需要特别注意，就是onCreate()方法只在第一次创建数据库的时候会被调用，也就是说，在我们操作数据库的时候，系统会自动检测，当发现数据库中没有当前要操作的database时，便会调用该类的onCreate()方法，创建数据库的同时创建所有需要的数据库表，而当这个数据库已经存在的时候就不会再调用onCreate()方法。

2、封装一个工具类

package com.tt.utils;

import java.util.ArrayList;
import java.util.List;

import com.tt.entity.Fc;
import com.tt.entity.Person;

import android.R;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.widget.Toast;

public class SqlService {

	private Context context;

	public SqlService(Context context) {
		this.context = context;
	}

	public void savezc(String user, String pwd) {
		DBOpenHelper dbOpenHelper = new DBOpenHelper(context);
		SQLiteDatabase database = dbOpenHelper.getReadableDatabase();
		String sql = "insert into person (user,pwd) values('" + user + "','"
				+ pwd + "')";
		database.execSQL(sql);
	}

	public List<Person> findbysql(String sql) {
		List<Person> list = new ArrayList<Person>();
		DBOpenHelper dbOpenHelper = new DBOpenHelper(context);
		SQLiteDatabase db = dbOpenHelper.getReadableDatabase();
		Cursor cursor = db.rawQuery("select * from person ", null);

		while (cursor.moveToNext()) {

			String person1 = cursor.getString(cursor.getColumnIndex("user"));
			String pwd1 = cursor.getString(cursor.getColumnIndex("pwd"));
			Person personlist = new Person(person1, pwd1);
			list.add(personlist);
		}

		return list;

	}

}

从代码中我们可以看出，这个类只是操作特定数据库表，若希望它更通用些，可以修改它的参数，使得数据库表可变。

3、使用工具类操作数据库

package com.tt.newmap;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

import com.tt.utils.SqlService;

public class SQLiteRegistActivity extends Activity {
    private String username;
    private String password;
    private Button rebutton;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_regist);
        rebutton = (Button) findViewById(R.id.registbutton);
        rebutton.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View arg0) {
                EditText editText = (EditText) findViewById(R.id.reusername);
                EditText editText2 = (EditText) findViewById(R.id.repassword);
                username = editText.getText().toString();
                password = editText2.getText().toString();
                if (username.equals("") || password.equals("")) {
                    Toast.makeText(getApplicationContext(), "账号密码不能为空", 1)
                            .show();
                } else {
                    try {
                        SqlService service = new SqlService(
                                getApplicationContext());
                        service.savezc(editText.getText().toString(), editText2
                                .getText().toString());
                        Toast.makeText(getApplicationContext(), "注册成功", 1)
                                .show();
                        Intent intent = new Intent(getApplicationContext(),
                                SQLiteLoginActivity.class);
                        startActivity(intent);
                    } catch (Exception e) {
                        Toast.makeText(getApplicationContext(), "注册失败", 1)
                                .show();
                        System.out.println(e);
                    }
                }
            }
        });

    }
}

可以看出，该类是一个实现注册功能的Activity，根据用户名和密码信息是否正确插入数据库给出相应的提示信息。而其中最核心的对数据库操作的代码则是：

SqlService service = new SqlService(getApplicationContext());
service.savezc(editText.getText().toString(), editText2.getText().toString());

排错经历

我在使用的时候遇到了一个非常奇怪的错误，就是每当创建一个新的数据库，只有第一次插入数据时可以成功插入，但是从第二次起就会报错，并且报错信息中没有有提示价值的信息，我百思不得其解，耗了两天都没有发现问题所在。最后，我突然发现我的SQL语句是这样的：

CREATE TABLE contenttable(username varchar(20) primary key,password varchar(20),content varchar(300),latitude varchar(20),longitude varchar(20))

我把第一个字段username作为了表的主键，众所周知，在关系型数据库中，主键是一个唯一标识，因此必须保证它的唯一性，但在我这里只要是同一个用户的操作，则username永远是一样地，这就不符合主键的要求，因此会出现这种奇怪的错误现象。其实我们在使用MySQL数据库的时候，一般都会把ID作为主键，我当时认为这是一个比较简单的小项目，因此就没有严格按照惯例来，这才造成这个问题。至于解决方案，一种是可以在表中增加一个ID字段，将其设为主键，另一种是可以直接取消主键的设置。