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());
}
}
程序运行效果如下: