SQLiteOpenHelper 类

SQLiteOpenHelper 是Android提供的一个管理数据库的工具类,可以用于管理数据库创建和版本更新.一般的用法是创建 SQLiteOpenHelper 的子类,并扩展它的onCreate(SQLiteDatabase db)方法和 onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)方法.
常用方法如下:

1. getReadableDatabase() : 以读写的方式打开数据库对应的 SQLiteOpenHelper 的对象.
2. getWritableDatabase() : 以（写）的方式打开数据库对应的 SQLiteOpenHelper 的对象.
3. onCreate(SQLiteDatabase db) 当第一次创建数据库时回调该方法.
4. onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) :当数据库版本更新时回调该方法.
5. close()　：　关闭所有打开的database 数据库时调用．

---

下面一个实例来学习　SQLiteOpenHelper 的功能与用法．

package com.test.sqliteopenhelper;

import android.content.Intent;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

/**
 * SQLiteOpenHelper 的功能与用法．
 */
public class MainActivity extends AppCompatActivity {
    MyDatabaseHelper dbHelper;
    Button insert = null;
    Button search = null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        //创建 MyDatabaseHelper 对象指定数据库版本为 1,此处使用相对路径
//        ..数据库文件自动会保存在程序的数据库文件夹的 database目录下
        dbHelper = new MyDatabaseHelper(this, "myDict.db3", null, 1);

        insert = (Button) findViewById(R.id.insert);
        search = (Button) findViewById(R.id.search);

        insert.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //获取用户输入信息
                String word = ((EditText) findViewById(R.id.word)).getText().toString();
                String detail = ((EditText) findViewById(R.id.detail)).getText().toString();

                //插入生词记录
                insertData(dbHelper.getReadableDatabase(), word, detail);

                Toast.makeText(MainActivity.this, "添加生词成功!", Toast.LENGTH_SHORT).show();
            }
        });

        search.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
//获取用户输入的关键词
                String key = ((EditText) findViewById(R.id.key)).getText().toString();

                //执行查询
                Cursor cursor = dbHelper.getReadableDatabase().rawQuery("select * from dict where word like ? or detail like ? ",
                        new String[]{"%" + key + "%", "%" + key + "%"});

                //创建一个 Bundle
                Bundle bundle = new Bundle();
                bundle.putSerializable("data", converCursorToList(cursor));

                //创建一个 Intent
                Intent intent = new Intent(MainActivity.this,ResultActivity.class);

                intent.putExtras(bundle);

                startActivity(intent);
            }
        });
    }

    public ArrayList> converCursorToList(Cursor cursor) {

        ArrayList> result = new ArrayList<>();
        //遍历 cursor
        while(cursor.moveToNext()){
//            将cursor结果集中的数据存入 ArrayList 中
            Map map = new HashMap<>();
//            取出查询记录中 第2列和第3列的值
            map.put("word",cursor.getString(1));
            map.put("detail",cursor.getString(2));

            result.add(map);
        }

        return result;
    }

    private void insertData(SQLiteDatabase readableDatabase, String word, String detail) {
        //执行插入语句
        readableDatabase.execSQL("insert into dict values(null,?,?)", new String[]{word, detail});
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();

        //退出程序时,关闭 MyDatabaseHelper里的 SQLiteDatabase
        if (dbHelper != null) {
            dbHelper.close();
        }
    }
}

布局界面

<LinearLayout
    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"
    android:orientation="vertical"
    tools:context="com.test.sqliteopenhelper.MainActivity">

    <EditText
        android:id="@+id/word"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="单词"/>

    <EditText
        android:id="@+id/detail"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="详情"
        android:lines="1"/>

    <Button
        android:id="@+id/insert"
        android:layout_gravity="center_horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/insert"/>
    <EditText
        android:hint="@string/key"
        android:id="@+id/key"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        />
    <Button
        android:id="@+id/search"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/search"
        />
    <ListView
        android:divider="#123"
        android:dividerHeight="2px"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/show"
        />
LinearLayout>

这是一个对话框风格的activity

 <activity android:name=".ResultActivity"
            android:theme="@style/Theme.AppCompat.Light.Dialog"
            >
        activity>

显示搜索结果的Activity

package com.test.sqliteopenhelper;

import android.content.Intent;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.ListView;
import android.widget.SimpleAdapter;

import java.util.List;
import java.util.Map;

public class ResultActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_result);

        ListView listView = (ListView) findViewById(R.id.result);

        Intent intent = getIntent();

        //获取Intent 携带的数据
        Bundle bundle = intent.getExtras();
        List> mapList = (List>) bundle.getSerializable("data");

        //设置一个adapter
        SimpleAdapter adapter = new SimpleAdapter(
                ResultActivity.this,
                mapList,
                R.layout.item,
                new String[]{"word","detail"},
                new int[]{R.id.word,R.id.detail});

        listView.setAdapter(adapter);

    }
}

显示结果的Activity的 布局界面

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="fill_parent"
              android:layout_height="fill_parent"
              android:gravity="center"
              android:divider="?android:attr/dividerVertical"
              android:showDividers="beginning"
              android:dividerPadding="2dp"
    >
    <ListView
        android:id="@+id/result"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        />
LinearLayout>

条目布局

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="fill_parent"
              android:layout_height="fill_parent"
    >
    <EditText
        android:id="@+id/word"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:width="120px"
        android:editable="false"
        />
    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/detail"
        />
    <EditText
        android:id="@+id/detail"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:editable="false"
        android:lines="3"
        />
LinearLayout>