Android起航系列第六章：android数据存储

Android手机APP起航系列

本博客文章基于android官方sdk的docs文档，目的是通过此教程巩固android手机app开发的一些应知应会的基础知识，也希望能帮助同在学习android开发的小伙伴们，共同进步，如有写的不到之处，还请各位小伙伴们不吝赐教。

---

有时我们需要在app中存取数据，以免丢失信息（比如配置信息，账号信息，进度信息等）。在android中通常有三种存取数据的方式。

主要内容：

1、通过SharedPreferences存取简单键值对的方式
2、通过android文件系统存取数据
3、通过sqlite存取数据

---

一、通过SharedPreferences API存取简单键值对的方式

preference直译为偏好，share直译为共享，所以SharedPreferences API通常用来存储少量的app用户共享的偏好配置信息。通常有两种方式来创建和访问一个共享的偏好文件，getSharedPreferences()方式与getPreferences()方式，两者方式相似，下面对第一种方式做讲解：

通过在上下文中调用getSharedPreferences()方法来创建或访问一个共享偏好文件，该方法会在android文件系统下创建一个shared_prefs目录，偏好文件存放其中，如下图：

java代码如下：

public class MainActivity extends AppCompatActivity {
    private TextView textView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
         textView = (TextView) findViewById(R.id.tv);
        //getSharedPreferences()方法的第一个参数为文件名，第二个参数为读取方式(MODE_PRIVATE为私有方式：仅该app可以访问)。
        SharedPreferences sharedPreferences =  getSharedPreferences("com_jiaqian_dataoper_pref",MODE_PRIVATE);
        //写入
        SharedPreferences.Editor editor =  sharedPreferences.edit();
        editor.putInt("age",30);
        editor.putString("name","jiaqian");
        editor.commit();

        //读取
        SharedPreferences sharedPreferences2 =  getSharedPreferences("com_jiaqian_dataoper_pref",MODE_PRIVATE);
        int age = sharedPreferences2.getInt("age", 0);
        String name =  sharedPreferences2.getString("name","default");
        textView.append("   Name:"+name+",Age:"+age);
    }
}

运行以上代码程序，生成的com_jiaqian_dataoper_pref.xml文件如下：

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>    
    <string name="name">jiaqian</string>    
    <int name="age" value="30" />
</map>

虚拟机运行效果如下：

---

二、通过android文件系统方式存取数据

与sharedpreferences方式相似，android文件系统方式也是通过直接操作文件来存取数据，不同之处存取的数据不再是键值对形式的数据，往往用来存取段落形式的数据，产生的是文本文件(SharedPreferences产生的是xml文件)。这种方式存在两种情况，第一种情况是将数据文件存放于内存卡中(internal storage)，第二种情况是将数据存放于外置卡中(external storage)。存放于内存卡中，默认情况下该数据文件是私有的，别的应用程序不能访问，当用户卸载应用时，删除文件；存放于外置存储卡中，当用户卸载应用时，文件保留，需要申请访问外置存储的权限。

2.1、数据存放于内存卡的方式。此种方式数据文件存放于files文件夹中，与shared_prefs文件夹平级，如下图。

java实现代码如下：

package com.jiaqian.dataoper;

import android.content.Context;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;

import static com.jiaqian.dataoper.R.id.tv;

public class Main2Activity extends AppCompatActivity {

    private TextView textView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main2);
        String file_name = "hello_file";
        String hello_word = "hello world 2016";
        textView = (TextView) findViewById(R.id.tv);
        try {
            //文件写入
            FileOutputStream fileOutputStream =  openFileOutput(file_name, Context.MODE_PRIVATE);
            fileOutputStream.write(hello_word.getBytes());
            fileOutputStream.close();
            //文件读取
            FileInputStream fileInputStream = openFileInput(file_name);
            byte[] buff = new byte[1024];
            StringBuffer stringBuffer = new StringBuffer();
            int hasRead = 0;
            while ((hasRead = fileInputStream.read(buff))>0){
                stringBuffer.append(new String(buff,0,hasRead));
            }
            fileInputStream.close();
            //将读取到的内容添加到textview中
            textView.append("\n文件读取的内容："+stringBuffer.toString());
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

运行效果图如下：

提示：内存卡存放方式还有两种较为特殊的数据存储方式，一种是存放缓存数据，此种方式文件存放于cache文件夹中；另一种存放原始数据，此种方式数据文件存放于res/raw/目录下，如音频文件等，只能读不能写。这两种方式具体方式见api docs，这里不做详细说明。

---

2.2、数据存放于扩展存储设备(如sd card)中的方式，此种方式数据是可以共享的。具体方法参看docs官方文档，这里不再赘述。

---

三、通过sqlite存取数据

与传统的数据库相似，对于结构化的数据我们也可以将数据存放于sqlite中，相关api在android.database.sqlite包中。程序运行后sqlite db数据库文件存放在android文件系统中databases文件夹中，如下图：

我们可以将db文件导出用专门的客户端程序访问来查看其中的数据，也可以用sdk中的adb+sqlite小程序直接访问其数据。

---

adb+sqlite方式访问数据库文件方法：

1、cmd下切换到sdk中的platform-tools目录下：

2、输入adb shell与虚拟机联机，没有可用设备会报错，多个需要指定设备，联机成功后以root用户登录到android系统中，观看其光标#，与linux系统的操作相似。

3、cd 到你的app应用目录，如cd data/data/com.jiaqian.dataoper/databases

4、使用sqlite3 数据库文件名(如 sqlite3 FeedReader.db，需要有后缀名.db) 打开数据库，进入到sql环境中，我们就可以直接输入sql语句进行查询了。

执行查询语句select * from entry;

这样我么可以直观地查看app的行为写入数据的情况。

---

程序中使用sqlite的步骤：
1、定义相关实体类或者表的规则（如表名称、列名称等）
2、定义对应实体类的辅助类，通过继承SQLiteOpenHelper类，来帮助创建、更新、删除数据表。
3、在业务逻辑中使用辅助类完成对数据库的操作。

---

1、定义规则类FeedReaderContract ，其中包含FeedEntry实体类，FeedEntry定义类表的相关属性。

package com.jiaqian.dataoper;
import android.provider.BaseColumns;

public final class FeedReaderContract {
    public FeedReaderContract(){}

    public static abstract class FeedEntry implements BaseColumns{
        public static final String TABLE_NAME = "entry";
        public static final String COLUMN_NAME_ENTRY_ID = "entryid";
        public static final String COLUMN_NAME_TITLE = "title";
        public static final String COLUMN_NAME_SUBTITLE = "subtitle";
    }
}

2、定义辅助类FeedReaderDbHelper，通过辅助类的实例化帮助创建表，删除表，更新表，通过其实例可以获得数据库的操作权限。

package com.jiaqian.dataoper;

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

public class FeedReaderDbHelper extends SQLiteOpenHelper {

    public static final int DATABASE_VERSION = 1;
    public static final String DATABASE_NAME = "FeedReader.db";

    private static final String TEXT_TYPE = " TEXT";
    private static final String COMMA_SEP = ",";
    private static final String SQL_CREATE_ENTRIES =
            "CREATE TABLE " + FeedReaderContract.FeedEntry.TABLE_NAME + " (" +
                    FeedReaderContract.FeedEntry._ID + " INTEGER PRIMARY KEY," +
                    FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID + TEXT_TYPE + COMMA_SEP +
                    FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE + TEXT_TYPE + COMMA_SEP +
                    FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE + TEXT_TYPE +
                    " )";
    private static final String SQL_DELETE_ENTRIES =
            "DROP TABLE IF EXISTS " + FeedReaderContract.FeedEntry.TABLE_NAME;

    public FeedReaderDbHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(SQL_CREATE_ENTRIES);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL(SQL_DELETE_ENTRIES);
        onCreate(db);
    }

    @Override
    public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        onUpgrade(db, oldVersion, newVersion);
    }
}

3、在activity中使用相关方法对数据库进行操作。

package com.jiaqian.dataoper;

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

import java.util.Date;

public class Main3Activity extends AppCompatActivity implements View.OnClickListener {

    private Button btn_add,btn_delete,btn_alter,btn_query;
    private TextView textView;
    FeedReaderDbHelper feedReaderDbHelper;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main3);
        feedReaderDbHelper=  new FeedReaderDbHelper(getApplicationContext());
        btn_add = (Button) findViewById(R.id.btn_add_data);
        btn_delete = (Button) findViewById(R.id.btn_delete_data);
        btn_alter = (Button) findViewById(R.id.btn_alter_data);
        btn_query = (Button) findViewById(R.id.btn_query_data);
        textView = (TextView) findViewById(R.id.tv);
        btn_add.setOnClickListener(this);
        btn_delete.setOnClickListener(this);
        btn_alter.setOnClickListener(this);
        btn_query.setOnClickListener(this);

    }

    @Override
    public void onClick(View v) {
        int vid =  v.getId();
        switch (vid){
            case R.id.btn_add_data:
                addData();
                break;
            case R.id.btn_delete_data:
                deleteData();
                break;
            case R.id.btn_alter_data:
                alterData();
                break;
            case R.id.btn_query_data:
                queryData();
                break;
            default:
                return;
        }
    }

    /**
     * 添加数据
     */
    private void addData() {
        //获取sqlite db的可写权限
        SQLiteDatabase db = feedReaderDbHelper.getWritableDatabase();
        //将需要写入数据放入ContentValues中
        ContentValues contentValues = new ContentValues();
        contentValues.put(FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID,new Date().getTime()+"");
        contentValues.put(FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE,"天气预报");
        contentValues.put(FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE,"有时有小雨");
        //插入数据
        long newRowId = db.insert(FeedReaderContract.FeedEntry.TABLE_NAME, null,contentValues);
        Toast.makeText(this,newRowId+"",Toast.LENGTH_LONG).show();
    }


    /**
     * 删除数据
     */
    private void deleteData(){
        SQLiteDatabase db =  feedReaderDbHelper.getWritableDatabase();
        //设置where条件语句
        String selection = FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE + " = ? ";
        //设置where条件语句中占位符的值
        String[] selectionArgs = {"有时有小雨"};
        //i代表此次修改所影响的行数
        int i =  db.delete(FeedReaderContract.FeedEntry.TABLE_NAME,selection,selectionArgs);
        Toast.makeText(this,i+"",Toast.LENGTH_LONG).show();
    }

    /**
     * 修改数据
     */
    private void alterData(){
        SQLiteDatabase db = feedReaderDbHelper.getWritableDatabase();
        //设置需要更新的数据
        ContentValues contentValues =  new ContentValues();
        contentValues.put(FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE,"有阵雨和雷雨");
        //设置where条件语句
        String selection = FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE + " = ? ";
        //设置where条件语句中占位符的值
        String[] selectionArgs = {"有时有小雨"};
        //i代表此次修改所影响的行数
        int i = db.update(FeedReaderContract.FeedEntry.TABLE_NAME,contentValues,selection,selectionArgs);
        Toast.makeText(this,i+"",Toast.LENGTH_LONG).show();
    }

    /**
     * 查询数据
     */
    private void queryData(){
        SQLiteDatabase db =  feedReaderDbHelper.getReadableDatabase();
        //设置查询包含的列
        String[] projection = {FeedReaderContract.FeedEntry._ID,FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID,
                FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE, FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE};
        //设置where条件语句
        String selection = FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE + " = ? ";
        //设置where条件语句中占位符的值
        String[] selectionArgs = {"天气预报"};
        //设置查询结果的排序方式
        String orderBy = FeedReaderContract.FeedEntry._ID + " DESC ";
        //通过游标查询
        Cursor cursor = db.query(FeedReaderContract.FeedEntry.TABLE_NAME,projection,selection,selectionArgs,null,null,orderBy);
        StringBuffer stringBuffer = new StringBuffer();
        //便利游标结果
        while (cursor.moveToNext()){
            stringBuffer.append("_id:"+cursor.getInt(cursor.getColumnIndex(FeedReaderContract.FeedEntry._ID)) + ","
                    + "entryid:" + cursor.getString(cursor.getColumnIndex(FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID)) + ","
                    + "title:" + cursor.getString(cursor.getColumnIndex(FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE)) + ","
                    + "subtitle:" + cursor.getString(cursor.getColumnIndex(FeedReaderContract.FeedEntry.COLUMN_NAME_SUBTITLE)) + ";"
            );
        }
        //将结果显示在textview中
        textView.setText(stringBuffer.toString());
    }
}

程序运行效果如下：