$《第一行代码：Android》读书笔记——第6章 数据持久化

　　主要讲述了Android数据持久化的三种方式：文件存储、SharedPreference存储、SQLite数据库存储。

（一）文件存储

　　其实Android中文件存储方式和Java的文件操作类似，就是用IO流进行操作。文件存储只能保存简单的字符串或二进制数据，不适合保存结构较为复杂的数据。

　　1、示例程序（代码中有详细注释）：

　　（1）xml文件：

　　其中有一个EditText，可以在里面输入字符，还有两个Button，一个用于保存输入的内容到一个文件中，另一个用于载入相应的文件内容到EditText中。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <EditText
        android:id="@+id/input_et"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <Button
        android:id="@+id/save_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="保存" />


    <Button
        android:id="@+id/load_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="载入文件内容" />

</LinearLayout>

　　（2）MainActivity：

import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.text.TextUtils;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends Activity implements OnClickListener {

    private String dataFileName = "MyDataFile";

    private EditText inputEt;
    private Button saveBtn;
    private Button loadBtn;

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

        inputEt = (EditText) findViewById(R.id.input_et);
        saveBtn = (Button) findViewById(R.id.save_btn);
        loadBtn = (Button) findViewById(R.id.load_btn);

        saveBtn.setOnClickListener(this);
        loadBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
        case R.id.save_btn:
            String inputText = inputEt.getText().toString();
            if (inputText.length() == 0) {
                Toast.makeText(MainActivity.this, "未输入任何内容！",
                        Toast.LENGTH_SHORT).show();
            } else {
                save(dataFileName, inputText);
                Toast.makeText(MainActivity.this, "保存成功！", Toast.LENGTH_SHORT)
                        .show();
            }
            break;

        case R.id.load_btn:
            String fileContent = load(dataFileName);

            // 用于判断一个字符串是否是null或者空内容的工具方法
            if (!TextUtils.isEmpty(fileContent)) {
                inputEt.setText(fileContent);
                // 让光标移到文字最后
                inputEt.setSelection(fileContent.length());
                Toast.makeText(this, "载入文件内容成功！", Toast.LENGTH_SHORT).show();
            }
            break;
        default:
            break;
        }
    }

    // 保存输入内容到文件的方法
    public void save(String fileName, String inputText) {
        FileOutputStream out = null;
        BufferedWriter writer = null;

        try {
            // 1.用Context类的openFileOutput方法创建FileOutputStream实例
            // MODE_PRIVATE模式是默认操作模式，表示当指定同样文件名时，所写入的内容将会覆盖原来的内容
            // MODE_APPEND表示如果该文件已经存在就往文件里面追加内容，不存在就创建新文件
            // 注：这里的文件名不可以包含路径，因为所有的文件都是默认存储到/data/data/包名/files目录的
            out = openFileOutput(fileName, Context.MODE_PRIVATE);

            // 2.用FileOutputStream实例创建OutputStreamWriter实例，再用OutputStreamWriter实例创建BufferedWriter实例
            writer = new BufferedWriter(new OutputStreamWriter(out));

            // 3.写入内容到文件
            writer.write(inputText);

            /**
             * 注:查看该文件的方法： DDMS—>File
             * Explorer—>/data/data/com.example.filepersistencetest(包名)/files/
             * 该目录下即可看到刚刚保存的文件，DDMS按钮下方有一个导出文件，即可把文件导出到电脑上用记事本查看
             */

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (writer != null) {
                    writer.close();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    // 载入并读取文件内容的方法
    public String load(String fileName) {
        FileInputStream in = null;
        BufferedReader reader = null;
        StringBuilder content = new StringBuilder();

        try {
            // 1.用Context类的openFileInput方法创建FileInputStream实例
            in = openFileInput(fileName);

            if (in == null) {
                Toast.makeText(MainActivity.this, "数据文件不存在！",
                        Toast.LENGTH_SHORT).show();
                return "";
            }

            // 2.创建BufferedReader实例
            reader = new BufferedReader(new InputStreamReader(in));

            String line = "";

            // 3.读取每一行
            while ((line = reader.readLine()) != null) {
                content.append(line);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (reader != null) {
                try {
                    reader.close();
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }

        return content.toString();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        String inputText = inputEt.getText().toString();
        if (inputText.length() != 0) {
            save(dataFileName, inputText);
        }
    }

}

　　2、用openFileOutput和openFileInput创建文件时，参数中的文件名不可以包含路径，因为所有的文件都是默认存储到/data/data/包名/files目录的。

　　3、查看该文件的方法： DDMS—>File Explorer—>/data/data/com.example.filepersistencetest(包名)/files/，该目录下即可看到刚刚保存的文件，DDMS按钮下方有一个导出文件按钮，即可把文件导出到电脑上用记事本查看。

（二）SharedPreferences

　　SharedPreferences用键值对形式存储数据，适合保存程序的一些偏好设置等。SharedPreferences文件会自动存放在/data/data/包名/shared_prefs目录下，是xml格式的文件。

　　1、获取SharedPreferences对象的三种方法：

　　（1）Activity类的getPreferences方法，只接收一个模式参数，这个方法会自动把当前活动类名作为SharedPreferences文件名。
　　（2）PreferencesManager类中的getDefaultSharedPreferences方法，这是一个静态方法，接收一个Context参数，并自动使用当前 应用程序的包名作为前缀来命名SharedPreferences文件。

　　（3）Context类的getSharedPreferences方法，接受两个参数，第一个为文件名字符串（不要带路径！），第二个是文件操作模式。

　　2、向SharedPreferences文件写入数据的步骤：

　　（1）用SharedPreferences对象的edit方法获取SharedPreferences.Editor实例：

SharedPreferences.Editor editor = getSharedPreferences("dataFile",
                MODE_PRIVATE).edit();

　　（2）写入数据到SharedPreferences中：

editor.putString("name", "贾永基");
editor.putInt("age", 23);
editor.putBoolean("married", false);

　　（3）用commit方法提交：

editor.commit();

　　3、从SharedPreferences文件读数据的步骤：

　　（1）创建SharedPreferences实例：

SharedPreferences pref = getSharedPreferences("dataFile", MODE_PRIVATE);

　　（2）用getXXX方法读取数据：

　　　　 // 第一个参数表示键名，第二个参数表示如果找不到数据时候返回的默认值
        String name = pref.getString("name", "");
        int age = pref.getInt("age", 0);
        boolean married = pref.getBoolean("married", false);

        Log.d("MainActivity", "name is " + name);
        Log.d("MainActivity", "age is " + age);
        Log.d("MainActivity", "married is " + married);

　　4、示例程序：

　　（1）XML文件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <Button
        android:id="@+id/save_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="保存数据" />

    <Button
        android:id="@+id/load_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="载入数据" />

</LinearLayout>

　　（2）MainActivity：

package com.example.sharedpreferencestest;

import android.app.Activity;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity implements OnClickListener {

    private Button saveDataBtn;
    private Button loadDataBtn;

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

        saveDataBtn = (Button) findViewById(R.id.save_data_btn);
        loadDataBtn = (Button) findViewById(R.id.load_data_btn);

        saveDataBtn.setOnClickListener(this);
        loadDataBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
        case R.id.save_data_btn:
            saveData();
            Toast.makeText(MainActivity.this, "保存数据成功", Toast.LENGTH_SHORT)
                    .show();
            break;
        case R.id.load_data_btn:
            loadData();
            break;
        default:
            break;
        }
    }

    // 保存数据到SharedPreferences
    public void saveData() {
        // 1.用SharedPreferences对象的edit方法获取SharedPreferences.Editor实例
        SharedPreferences.Editor editor = getSharedPreferences("dataFile",
                MODE_PRIVATE).edit();

        // 注：获取SharedPreferences对象还有两种方法：
        // （1）Activity类的getPreferences方法，只接收一个模式参数，这个方法会自动把当前活动类名作为SharedPreferences文件名
        // （2）PreferencesManager类中的getDefaultSharedPreferences方法，这是一个静态方法，接收一个Context参数，并自动使用当前
        // 应用程序的包名作为前缀来命名SharedPreferences文件

        // 2.写入数据到SharedPreferences中
        editor.putString("name", "贾永基");
        editor.putInt("age", 23);
        editor.putBoolean("married", false);

        // 3.用commit方法提交
        // 注：SharedPreferences文件会自动存放在/data/data/包名/shared_prefs目录下，是xml格式的文件
        editor.commit();
    }

    // 从SharedPreferences读数据
    public void loadData() {
        SharedPreferences pref = getSharedPreferences("dataFile", MODE_PRIVATE);

        // 第一个参数表示键名，第二个参数表示如果找不到数据时候返回的默认值
        String name = pref.getString("name", "");
        int age = pref.getInt("age", 0);
        boolean married = pref.getBoolean("married", false);

        Log.d("MainActivity", "name is " + name);
        Log.d("MainActivity", "age is " + age);
        Log.d("MainActivity", "married is " + married);
    }

}

 （三）SQLite

　　SQLite是Android内嵌的轻量级关系型数据库，速度很快，支持标准的SQL语法，还支持ACID事务。

　　1、创建数据库：

　　继承SQLiteOpenHelper类创建自己的类MyDatabaseHelper，并实现onCreate和onUpgrade两个抽象方法，在onCreate方法中建表，在onUpgrade中升级数据库。

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

public class MyDatabaseHelper extends SQLiteOpenHelper {

    // 1.将建表语句定义成字符串常量
    public static final String CREATE_BOOK = "create table book(" // 注：表名和字段名称不区分大小写
            + "id integer primary key autoincrement,"
            + "author text,"
            + "price real," + "pages integer," + "name text,"+ "category_id integer)";;

    public static final String CREATE_CATEGORY = "create table category("
            + "id integer primary key autoincrement," + "category_name text,"
            + "category_code integer)";

    private Context mContext;

    public MyDatabaseHelper(Context context, String name,
            CursorFactory factory, int version) {
        super(context, name, factory, version);
        mContext = context;
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        // 2.用SQLiteDatabase的execSQL方法执行建表语句
        db.execSQL(CREATE_BOOK);
        db.execSQL(CREATE_CATEGORY);

        Toast.makeText(mContext, "创建数据库成功！", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
        case 1:
            db.execSQL(CREATE_CATEGORY);
        case 2: // 注意这里case的最后是不写break的，以应对跨版本升级的情况
            db.execSQL("alter table book add column category_id integer");
        default:
            break;
        }
    }

}

　　2、创建数据库后，在adb shell中可以用命令行方式查看数据库的具体数据，方法如下：

　　（1）打开控制台窗口，输入adb shell，然后cd到路径：/data/data/当前包名/databases/，使用ls查看当前目录里的文件。

　　（2）假设提前创建的数据库名叫BookStore.db，那么接着就用sqlite3 BookStore.db命令打开数据库，然后可以输入各种SQL语句进行操作。

　　（3）输入.table命令可以查看当前数据库的表，.schema命令可以查看所有表的建表语句。.exit或.quit命令可以退出数据库编辑，exit命令可以退出adb shell。

　　（4）在数据库中查询结果出现乱码的情况的解决（Win7环境）：

　　在控制台里输入命令：chcp 65001 确定—>在命令行标题栏上点击右键，选择【属性】 -【字体】，将字体修改为【Lucida Console】 确定
　　完成后再通过 adb shell 进入sqlite3，乱码解决.
　　注：恢复cmd的默认设置：Win+R -> 输入regedit -> 找到HKEY_CURRENT_USERConsole\%SystemRoot%_system32_cmd.exe -> 右键删除文件夹%SystemRoot%_system32_cmd.exe -> 重启cmd即可。

　　3、示例程序：

　　（1）xml文件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <Button
        android:id="@+id/create_database_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="创建数据库" />

    <Button
        android:id="@+id/add_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="添加数据" />

    <Button
        android:id="@+id/update_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="更新数据" />

    <Button
        android:id="@+id/delete_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="删除数据" />

    <Button
        android:id="@+id/query_data_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="查询数据" />

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="查询结果：" />

    <TextView
        android:id="@+id/query_result_tv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

　　（2）MainActivity：

package com.example.databasetest2;

import java.util.ArrayList;

import android.app.Activity;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

public class MainActivity extends Activity implements OnClickListener {

    private Button createDatabaseBtn;
    private Button addDataBtn;
    private Button updateDataBtn;
    private Button deleteDataBtn;
    private Button queryDataBtn;
    private TextView queryResultTv;

    private MyDatabaseHelper dbHelper;

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

        // 1.创建MyDatabaseHelper实例
        dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 3); // 这里的3为数据库版本号

        createDatabaseBtn = (Button) findViewById(R.id.create_database_btn);
        addDataBtn = (Button) findViewById(R.id.add_data_btn);
        updateDataBtn = (Button) findViewById(R.id.update_data_btn);
        deleteDataBtn = (Button) findViewById(R.id.delete_data_btn);
        queryDataBtn = (Button) findViewById(R.id.query_data_btn);
        queryResultTv = (TextView) findViewById(R.id.query_result_tv);

        createDatabaseBtn.setOnClickListener(this);
        addDataBtn.setOnClickListener(this);
        updateDataBtn.setOnClickListener(this);
        deleteDataBtn.setOnClickListener(this);
        queryDataBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        SQLiteDatabase db;
        switch (v.getId()) {
        case R.id.create_database_btn:
            // 2.调用MyDatabaseHelper的getWritableDatabase方法打开数据库
            dbHelper.getWritableDatabase();
            break;
        case R.id.add_data_btn:
            // 先获取SQLiteDatabase实例，然后直接用execSQL方法执行SQL语句的方式往表中插入数据
            db = dbHelper.getWritableDatabase();
            db.execSQL(
                    "insert into book (name,author,pages,price,category_id) values (?,?,?,?,?)",
                    new String[] { "三体", "刘慈欣", "567", "49.9", "1" }); // 注：所有类型的占位符数据都要是字符串，若语句中无占位符参数，则第二个函数参数可为null
            db.execSQL(
                    "insert into book (name,author,pages,price,category_id) values (?,?,?,?,?)",
                    new String[] { "第一行代码——Android", "郭霖", "401", "25.9", "3" });
            break;
        case R.id.update_data_btn:
            db = dbHelper.getWritableDatabase();
            // 更新数据
            db.execSQL("update book set price = ? where name = ?",
                    new String[] { "10.99", "三体" });
            break;
        case R.id.delete_data_btn:
            db = dbHelper.getWritableDatabase();
            // 删除数据
            db.execSQL("delete from book where pages > ?", new String[] { "1" });
            break;
        case R.id.query_data_btn:
            db = dbHelper.getWritableDatabase();
            Cursor cursor = db.rawQuery("select * from book where id < ?",
                    new String[] { "100" });
            int idIndex = 0;
            int authorIndex = 0;
            int priceIndex = 0;
            int pagesIndex = 0;
            int nameIndex = 0;
            int categoryIdIndex = 0;

            ArrayList<Book> bookQueryList = new ArrayList<Book>();

            // 获取每个字段的ColumnIndex
            if (cursor.getCount() >= 0) {
                idIndex = cursor.getColumnIndex("id");
                authorIndex = cursor.getColumnIndex("author");
                priceIndex = cursor.getColumnIndex("price");
                pagesIndex = cursor.getColumnIndex("pages");
                nameIndex = cursor.getColumnIndex("name");
                categoryIdIndex = cursor.getColumnIndex("category_id");
            }
            while (cursor.moveToNext()) {
                Book book = new Book();
                book.setId(cursor.getInt(idIndex));
                book.setAuthor(cursor.getString(authorIndex));
                book.setPrice(cursor.getDouble(priceIndex));
                book.setPages(cursor.getInt(pagesIndex));
                book.setName(cursor.getString(nameIndex));
                book.setCategoryId(cursor.getInt(categoryIdIndex));

                bookQueryList.add(book);
            }

            queryResultTv.setText(bookQueryList.toString());
            break;
        default:
            break;
        }
    }
}

// Book类
class Book {
    private int id;
    private String author;
    private double price;
    private int pages;
    private String name;
    private int categoryId;

    public int getCategoryId() {
        return categoryId;
    }

    public void setCategoryId(int categoryId) {
        this.categoryId = categoryId;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    public double getPrice() {
        return price;
    }

    public void setPrice(double price) {
        this.price = price;
    }

    public int getPages() {
        return pages;
    }

    public void setPages(int pages) {
        this.pages = pages;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "Book [ id = " + id + ", author = " + author + ", price = "
                + price + ", pages = " + pages + ", name = " + name
                + ", category_id = " + categoryId + " ]";
    }
}

程序运行效果：

　　4、使用事务　

            // 删除旧数据并添加新数据，两个操作为一个原子操作
            SQLiteDatabase db = dbHelper.getWritableDatabase();
            db.beginTransaction(); // 开启事务
            try {
                db.delete("book", null, null);
                // if (true) {
                // // 在这里手动抛出一个异常，让事务失败
                // throw new NullPointerException();
                // }
                ContentValues values = new ContentValues();
                values.put("name", "这是本新书");
                values.put("author", "贾永基");
                values.put("pages", 123);
                values.put("price", 13.4);
                db.insert("book", null, values);
                db.setTransactionSuccessful();// 事务已经执行成功

            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                db.endTransaction(); // 结束事务
            }

 　　5、补充：使用SQLiteDataBase类自带的方法进行数据库的增、删、改操作（因为使用自带的方法进行查询的操作过于复杂不做介绍，直接使用SQL语句即可）：

　　（1）插入数据：

...
SQLiteDatabase db = dbHelper.getWritableDatabase();

// 使用ContentValues对象组装数据
ContentValues values = new ContentValues();
values.put("name","三体");
values.put("pages",565);
values.put("price",23.99);

// 插入数据到数据库中
// 第一个参数：表名；第二个参数：用于在未指定添加数据的情况下为某些可为空的字段自动赋值为NULL，一般用不到这个功能，把这个参数传入null即可；第三个参数：携带数据的ContentValues对象
db.insert("Book",null,values);
...