Android开发历程_16(SQLite的使用)

　　

　　前言

　　SQLite是一种轻量级的小型数据库，虽然比较小，但是功能相对比较完善，一些常见的数据库基本功能也具有，在现在的嵌入式系统中使用该数据库的比较多，因为它占用系统资源很少。Android系统中也不例外，也是采用SQLite，本节中就学习下在andorid中怎样使用该数据库来存放数据，并且对SQLite完成简单的新建，更新，查询，删除等操作。

 

　　实验说明：

　　Android中使用SQLite数据库时,需要用adb来辅助调试,如果想在windows下的cmd命令行中使用adb,必须先配置环境变量,我这里是配的用户环境变量path: C:\Program Files\android-sdk\platform-tools;

　　配置好环境变量后，在cmd中输入adb shell进入linux shell环境前，需要把android模拟器打开(本文都是针对模拟器而言，并非真机)。如果启动好了模拟器，且输入adb shell命令后出现error: device not found错误提示，则可以杀掉adb进程然后重新启动该进程，在cmd中输入如下命令：

　　adb kill-server

　　adb start-server

 

　　如果要在android中使用SQLite，一般需要重新写一个类，而该类继承一个android提供访问该数据库的助手类SQLiteOpenHelper。 本次实验中我们在src文件夹下新建一个类，类名为DatabaseHelper,该类继承SQLiteOpenHelper类，而继承SQLiteOpenHelper类的类必须有自己的构造函数，因此按照mars老师的代码，在程序中写了3个构造函数，这3个函数的区别是参数个数的不同，参数个数少的函数是因为另外一些参数已经被固定了，且它们都是显示或隐式调用了父类的构造函数，下面是SQLiteOpenHelper的构造函数。

 

　　public SQLiteOpenHelper (Context context, String name, SQLiteDatabase.CursorFactory factory, int version)

　　第一个参数为该类本身；第二个参数为数据库的名字；第3个参数是用来设置游标对象的，这里一般设置为null；参数四是数据库的版本号。

 

　　public void execSQL (String sql)

　　该函数是类SQLiteDatabase中的一个函数，其功能是执行一条SQL语句命令，这条语句的内容就是该函数的参数。因此参数sql需要符合SQL语法规则。

 

　　public ContentValues ()

　　ContentValues是用于数据库中存放数据的类，也是采用的键值对来存放数据的，有点类似content和bundle等。该构造函数是建立一个默认大小的空的数据集。

 

　　实验步骤和结果：

　　界面设计：

　　该程序的界面设计比较简单，因为需要完成6中功能，所以在界面中只有6个按钮，每个按钮对应一种功能，这些按钮的功能依次为新建数据库，更新数据库的版本，向数据库中插入记录，更新数据库中的记录，查询数据库中的记录，删除数据库中的记录。其界面效果如下：

　　

 

　　建立数据库：

　　运行模拟器,单击create sqlite database按钮，创建一个名为”tornadomeet”的数据库，版本号为1，这时候可以看到程序终端显示”create a sqlite database”字样。在cmd中输入如下命令：adb shell;cd data; cd data; ls; cd com.example.sqlite_test; ls;命令，其中com.example.splite是本程序的包名，输入最后ls命令后可以看到有2个文件夹cache, lib。然后在单击后继续ls命令查看，多了一个database文件夹。使用命令cd database进入该文件夹后ls发现里面有数据库，截图如下：

　　 

　　继续在cmd命令行输入sqlite3 tornadomeet.db;（其中tornadomeet为单击创建数据库后新建立的数据库名称。）输入 .schema;(注意前面有个点)显示如下：

　　 

　　可以看到这个数据库有2个表，且可以看到这2个表建立的sqlite语句，其中第一个表示android自带的，第二个表示我们新建的。

继续输入命令select * from user1;（注意此时因为是真正的sqlite语句，所以在命令行中要以分号结束）查询自己建立的数据库中的表user1，发现里面什么内容都没有。

 

　　更新数据库版本：

在该步骤中，当按下update sqlite database按钮后，我们在监听器函数中新建了一个数据库，数据库名为”tornadomeet”不变，只是将其版本号设置为了2。因为版本号变了，所以程序会自动去调用SQLiteOpenHelper的子类的onUpgrade方法，该程序中只是在该方法中输出一条语句而已。

 

　　数据库插入：

　　单击模拟器的insert按钮，进入sqlite对应的数据库后，输入select * from user1;命令后(带分号)可以看到有如下显示：1 | tornado，说明我们的数据库成功插入了一条记录，该记录的内容是在程序中静态给的。

 

　　更新数据库内容：

　　更新操作相当于执行SQL的UPDATE语句，语法为:UPDATE  table_name  SET  ###col =###1  WHERE  ###col  = ###2

　　本程序将上面插入的一条记录的name名有tornado改为了tornadomeet，所以当按下update按钮后，重新在cmd使用select * from user1可以看出那条记录变成了1 | tornadomeet了。

 

　　查询操作：

　　查询操作使用SQLiteOpenHelper中的query方法，这里的查询是指按照列名name去查询的，实际查询过程中是有一个游标，开始时指向表头，后面一次一次往下移，直到满足查询的条件时就输出，然后终止查询。

 

　　删除操作：

　　删除操作与前面的类似，使用SQLiteOpenHelper中的delete方法，按照指定列名为某一值，然后删除那条记录即可。

　　下面是在依次单击新建一个SQLite数据库按钮，插入记录按钮，更新记录按钮，再次插入记录按钮，删除按钮后adb后台调试的结果：

　　

　　由此可以看出，删除操作也是成功的。

 

　　实验主要部分代码及注释(附录有实验工程code下载链接)：

MainActivity.java:

package com.example.sqlite_test;

import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class MainActivity extends Activity {

    private Button create_database = null;
    private Button update_database = null;
    private Button insert = null;
    private Button update = null;
    private Button query = null;
    private Button delete = null;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        create_database = (Button)findViewById(R.id.create_database);
        create_database.setOnClickListener(new CreateDatabaseOnClickListener());
        update_database = (Button)findViewById(R.id.update_database);
        update_database.setOnClickListener(new UpdateDatabaseOnClickListener());
        insert = (Button)findViewById(R.id.insert);
        insert.setOnClickListener(new InsertOnClickListener());
        update = (Button)findViewById(R.id.update);
        update.setOnClickListener(new UpdateOnClickListener());
        query = (Button)findViewById(R.id.query);
        query.setOnClickListener(new QueryOnClickListener());
        delete = (Button)findViewById(R.id.delete);
        delete.setOnClickListener(new DeleteOnClickListener());
    }

    public class CreateDatabaseOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // TODO Auto-generated method stub
            //创建一个DatabaseHelper类的对象，该类是单独一个java文件,这里采用2个参数的构造函数，建立的数据
            //库的名字为tornadomeet.db
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db");
            //只有调用getReadableDatabase()或者getWriteableDatabase()函数后才能返回一个SQLiteDatabase对象
            SQLiteDatabase db = database_helper.getReadableDatabase();
        }                
    }
    
    public class UpdateDatabaseOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // TODO Auto-generated method stub
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db", 2);
            SQLiteDatabase db = database_helper.getReadableDatabase();
        }        
    }
    
    public class InsertOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // 生成contentvallues对象，该对象用来存数据的
            ContentValues values = new ContentValues();
            values.put("id", 1);//注意值的类型要匹配
            values.put("name", "tornado");
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db");
            SQLiteDatabase db = database_helper.getWritableDatabase();//这里是获得可写的数据库
            db.insert("user1", null, values);
        }       
    }
    
    public class UpdateOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // TODO Auto-generated method stub
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db");
            SQLiteDatabase db = database_helper.getWritableDatabase();
            ContentValues values = new ContentValues();
            values.put("name", "tornadomeet");
            //参数1为表名，参数2为更新后的值，参数3表示满足条件的列名称，参数4为该列名下的值
            db.update("user1", values, "id=?", new String[]{"1"});
        }        
    }
    
    public class QueryOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // TODO Auto-generated method stub
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db");
            SQLiteDatabase db = database_helper.getWritableDatabase();
            //查询的语法，参数1为表名；参数2为表中的列名；参数3为要查询的列名；参数时为对应列的值；该函数返回的是一个游标
            Cursor cursor = db.query("user1", new String[]{"id", "name"}, "id=?", new String[]{"1"},  null, null, null);
            //遍历每一个记录
            while(cursor.moveToNext()) {
                String name = cursor.getString(cursor.getColumnIndex("name"));//返回列名为name的值
                System.out.println("query---->" + name);
            }
        }       
    }
    
    public class DeleteOnClickListener implements OnClickListener{

        public void onClick(View v) {
            // TODO Auto-generated method stub
            DatabaseHelper database_helper = new DatabaseHelper(MainActivity.this, "tornadomeet.db");
            SQLiteDatabase db = database_helper.getWritableDatabase();
            //直接删除名为tornadomeet对应的那条记录
            db.delete("user1", "name=?" ,new String[]{"tornadomeet"});
        }
        
    }
    
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.activity_main, menu);
        return true;
    }
}

 

DatabaseHelper.java:

package com.example.sqlite_test;

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

public class DatabaseHelper extends SQLiteOpenHelper {

    private static final int  VERSON = 1;//默认的数据库版本
    
    //继承SQLiteOpenHelper类的类必须有自己的构造函数
    //该构造函数4个参数，直接调用父类的构造函数。其中第一个参数为该类本身；第二个参数为数据库的名字；
    //第3个参数是用来设置游标对象的，这里一般设置为null；参数四是数据库的版本号。
    public DatabaseHelper(Context context, String name, CursorFactory factory, int verson){
        super(context, name, factory, verson);
    }
    
    //该构造函数有3个参数，因为它把上面函数的第3个参数固定为null了
    public DatabaseHelper(Context context, String name, int verson){
        this(context, name, null, verson);
    }
    
    //该构造函数只有2个参数，在上面函数 的基础山将版本号固定了
    public DatabaseHelper(Context context, String name){
        this(context, name, VERSON);
    }
    
    //该函数在数据库第一次被建立时调用
    @Override
    public void onCreate(SQLiteDatabase arg0) {
        // TODO Auto-generated method stub
        System.out.println("create a sqlite database");
        //execSQL()为执行参数里面的SQL语句，因此参数中的语句需要符合SQL语法,这里是创建一个表
        arg0.execSQL("create table user1(id int, name varchar(20))");
    }

    @Override
    public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {
        // TODO Auto-generated method stub
        System.out.println("update a sqlite database");
    }

}

 

activity_main.xml:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <Button 
        android:id="@+id/create_database"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:text="@string/create_database"
        />

    <Button
        android:id="@+id/update_database"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_above="@id/create_database"
        android:layout_alignParentLeft="true"
        android:text="@string/update_database" />

    <Button
        android:id="@+id/insert"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_above="@id/update_database"
        android:layout_alignParentLeft="true"
        android:text="@string/insert" />

    <Button
        android:id="@+id/update"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_above="@id/insert"
        android:layout_alignParentLeft="true"
        android:text="@string/update" />
    
    <Button 
        android:id="@+id/query"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_above="@id/update"
        android:text="@string/query"
        />
    <Button 
        android:id="@+id/delete"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_above="@id/query"
        android:text="@string/delete"
        />
        
</RelativeLayout>

 

 

　　总结： 通过本次实验，对SQLite在andorid中的使用流程有了初步的了解。

 

 

　　参考资料：

     http://www.mars-droid.com/bbs/forum.php

 

 

　　附录：

　　实验工程code下载。