前言
ListView与数据库结合使用也是一种非常常见的手段。例如歌单的ListView，在我们重新启动应用的时候数据依旧存在，如下图：
具体实现
一、准备Activity和ListView
- Activity要继承ListActivity或AppCompatActivity（推荐后者）
- ListView不需要先准备适配器Adapter，只需要初始化好ListView就行了
二、创建数据库
- 新建一个类MySQLite继承自SQLiteOpenHelper，然后去实现未实现的3个方法，分别是：
1、构造方法
MySQLite(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
super(context, name, factory, version);
//this.mContext = context; //自定义变量mContext
}
其中形式参数的意义分别是：
- context：上下文，即当前Activity的对象 this
- name：即将创建的数据库的表的名字，例如："user.db"、"music_msg.db"
- factory：游标，一般都是 null
- version：数据库版本号，用于更新数据库版本， 例如：1
所以也可以写成
MySQLite(Context context) {
super(context, "music_msg.db", null, 1);
this.mContext = context;
}
2、onCreate方法，用于创建数据库的表
@Override
public void onCreate(SQLiteDatabase sqLiteDatabase) {
sqLiteDatabase.execSQL("create table music_msg(_id integer primary key autoincrement, singer varchar, songname varchar, url varchar)");
}
通过execSQL()方法执行SQL语句创建数据库的表
如果你不懂数据库，那你只需要改变下图框出的部分，第一个是表名，第二个是变量名和数据类型
3、onUpgrade方法，用于升级软件时更新数据库表结构，此方法在数据库的版本发生变化时会被调用
@Override
public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) {
Toast.makeText(mContext, "onUpgrade", Toast.LENGTH_SHORT).show();
}
该方法这里不做演示分析，只是弹个Toast，想具体了解的可自行谷歌百度
三、关联ListView与数据库
- 关联的关键就是ListView的适配器SimpleCursorAdapter，构造方法与SimpleAdapter有些类似
SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to, int flags)
其中形式参数的意义分别是：
-
context：上下文，即当前Activity的对象 this
-
layout：ListView对应的布局文件
-
c：游标对象，此处可以设为 null
-
from：想从数据库表中拿的数据的列名，放在new出来的String数组中
-
to：将 layout 里面的控件的 id 写进new出来的 int 数组中，分别对应 from 里的数据
-
flags：标志用于确定适配器的行为，用常量CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER
-
代码如下：
SimpleCursorAdapter mSimpleCursorAdapter = new SimpleCursorAdapter(MyListviewActivity.this, R.layout.listview_sql_item, null,
new String[]{"songname", "singer"}, new int[]{R.id.songname, R.id.singer}, CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER);
mListView.setAdapter(mSimpleCursorAdapter); //给ListView设置适配器
refreshListview(); //自定义的方法，用于当数据列表改变时刷新ListView
四、刷新ListView（很关键）
- 当我们对数据进行增删改的时候，就需要将ListView刷新显示
-
自定义一个方法refreshListview()，里面关键的方法是适配器对象mSimpleCursorAdapter的changeCursor(Cursor cursor)方法，因为需要传递一个参数cursor，所以我们需要得到这个Cursor对象，通过数据库对象的查询方法query就能返回一个Cursor对象，query方法如下图：
这里我们暂时只需要设置table参数，即数据库的表名，先不管另外6个参数是什么（后面会再详细说明），此处全部设置为null就行了，即：
Cursor mCursor = mDbWriter.query("music_msg", null, null, null, null, null, null);
上面说到要用数据库的对象去调用query方法，所以我们就得先拿到数据库的对象。数据库对象的获取有两个方法——getWritableDatabase() 和 getReadableDatabase()
- SQLiteDatabase getWritableDatabase() ：以读写的方式打开数据库对应的SQLiteDatabase对象，如果打开的数据库磁盘满了，此时只能读不能写，此时调用了 getWritableDatabase 的实例，那么将会发生错误（异常）
- SQLiteDatabase getReadableDatabase()：以读写的方式打开数据库对应的SQLiteDatabase对象，如果数据库的磁盘空间满了，就会打开失败，当打开失败后会继续尝试以只读方式打开数据库。如果该问题成功解决，则只读数据库对象就会关闭，然后返回一个可读写的数据库对象
要调用这两个方法，先再Activity的onCreate()方法里实例化之前自定义的MySQLite类，代码如下：
MySQLite mMySQLite = new MySQLite(this);
SQLiteDatabase mDbWriter = mMySQLite.getWritableDatabase();
SQLiteDatabase mDbReader = mMySQLite.getReadableDatabase();
- 接着就可以写出refreshListview()方法了，代码如下：
//刷新数据列表
public void refreshListview() {
Cursor mCursor = mDbWriter.query("music_msg", null, null, null, null, null, null);
mSimpleCursorAdapter.changeCursor(mCursor);
}
五、增
- 实现往数据库中增加一条数据并在ListView中显示
-
先简单写一个UI界面：在有ListView的Activity的底部增加两个文本输入框和一个按钮，如图：
这里的ListView没有数据所以看不见，两个EditText的对象分别为 mEt_songName 和 mEt_singer ，Button的对象为 btn_insert，这三个对象后面要用到
- 数据的存储是通过ContentValues 类实现的，ContentValues 类跟Hashtable 类很相似，也是通过put(key, value) 方法暂存的，其中键值对的键key只能是String类型，值value只能是基本类型。于是我们可以new出ContentValues 类的对象，然后将EditText上的数据作为值value存起来，再通过数据库对象的 insert() 方法将数据插入数据库表中，最后调用refreshListview()方法刷新数据列表，将数据在ListView中显示出来，代码如下：
//增
public void insertData() {
ContentValues mContentValues = new ContentValues();
mContentValues.put("songname", mEt_songName.getText().toString().trim());
mContentValues.put("singer", mEt_singer.getText().toString().trim());
mDbWriter.insert("music_msg", null, mContentValues);
refreshListview();
}
其中的insert()方法的3个参数
-
table：想插入的数据库的表名
-
nullColunmHack：代表强行插入null值的数据列的列名，这里设置为 null 就行
-
values：存放了数据的ContentValues 对象
-
这里将其封装成一个insertData()方法，然后在添加按钮mBtn_insert的点击事件中调用，代码如下：
mBtn_insert.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
insertData();
mEt_songName.setText(""); //数据添加完成后，把文本输入框清空，方便下次输入
mEt_singer.setText("");
}
});
-
效果如图：
六、删
- 实现删除ListView的一条数据并将数据库对应的数据也删除
- 这里我们实现长按ListView的某一项item，然后弹出一个对话框，确认是否删除，确定的话就删除该数据，取消的话就不做任何处理
-
要想删除数据库的某一条数据，我们就得先知道是ListView的哪一项，所以我们先写ListView的长按事件监听，并且添加一个AlertDialog，代码如图：
可以注意到上面有3个红色的框框，第一个框框是 final关键字，因为其修饰的position变量在匿名内部类中需要被使用到，所以需要在前面添加 final 关键字。第二个框框是一个自定义的方法，其作用是删除LIstView的第 position 项数据，后面会具体介绍。第三个框框是布尔变量，返回true代表响应该次监听事件
- 从长按监听中我们可以知道 position 就是我们要删除项的位置，所以我们现在可以开始写删除功能。我们自定义一个 deleteData(int positon) 方法，参数就是刚才那个 position 。思路是这样的，拿到数据库表的游标，让它移动到 position 的位置，然后拿到对应的 _id 列的 id ，最后用数据库对象的 delete方法删除该id的这一行数据，代码如下：
//删
public void deleteData(int positon) {
Cursor mCursor = mSimpleCursorAdapter.getCursor();
mCursor.moveToPosition(positon);
int itemId = mCursor.getInt(mCursor.getColumnIndex("_id"));
mDbWriter.delete("music_msg", "_id=?", new String[]{itemId + ""});
refreshListview();
}
这里主要说一下数据库对象的 delete方法的3个参数
- table：数据库的表名
- whereClause：代表要删除哪一列上的哪一行，这里出于安全性考虑，只告诉了“_id”列，然后用“=?”代替具体哪一行
- whereArgs：该参数给出具体哪一行
-
效果如图：
七、改
- 学会了增和删，其实就会了改，所谓的改就是移动游标到需要更改数据的位置，然后用ContentValues 存新的数据，最后用update方法进行数据替换更改，这里希望读者自己试着靠自己去理解，代码如下：
//改
public void updateData(int positon) {
Cursor mCursor = mSimpleCursorAdapter.getCursor();
mCursor.moveToPosition(positon);
int itemId = mCursor.getInt(mCursor.getColumnIndex("_id"));
ContentValues mContentValues = new ContentValues();
mContentValues.put("songname", mEt_dialog_songName.getText().toString().trim());
mContentValues.put("singer", mEt_dialog_singer.getText().toString().trim());
mDbWriter.update("music_msg", mContentValues, "_id=?", new String[]{itemId + ""});
refreshListview();
}
- 具体我实现单击ListView的某一项，然后弹出一个AlertDialog进行更改，代码如下：
//单击修改item
mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> adapterView, final View view, final int position, long l) {
View mView = View.inflate(MyListviewActivity.this, R.layout.dialog_et_layout, null); //将放置了两个EditText的布局dialog_et_layout渲染成view对象
mEt_dialog_songName = (EditText) mView.findViewById(R.id.et_dialog_songname); //要用对应布局的view对象去findViewById获取控件对象
mEt_dialog_singer = (EditText) mView.findViewById(R.id.et_dialog_singer);
mEt_dialog_songName.setText(((TextView) view.findViewById(R.id.songname)).getText()); //获取并显示原来的歌曲
mEt_dialog_singer.setText(((TextView) view.findViewById(R.id.singer)).getText()); //获取并显示原来的歌手
new AlertDialog.Builder(MyListviewActivity.this)
.setTitle("提示")
.setMessage("是否修改数据")
.setView(mView)
.setPositiveButton("确定", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialogInterface, int i) {
updateData(position);
}
})
.setNegativeButton("取消", null)
.show();
}
});
-
效果如图：
八、查
- 实现输入歌曲或歌手进行查询
-
首先我们需要一个输入框和一个查询按钮，对象分别为 mEt_input 和 btn_query，像这样的就行
- 跟增删改一样，我们还是自定义一个方法 queryData()，然后首先获取输入框 mEt_input 的值，代码如下：
String mInput = mEt_input.getText().toString().trim();
- 我们的思路是这样的：由于不知道输入进来的 mInput 是歌曲还是歌手，我们需要进行判断，如果是歌曲，那么就去数据库中找该歌曲名字对应的所有歌手，放在List<Map>里，最后用 AlertDialog 进行对话框列表显示；如果是歌手，也是用同样的方法。
-
那么如何判断呢？还记得我们再介绍第四部分“刷新ListView”的时候用到的数据库对象的 query() 方法吗？当时没作具体参数分析，现在就来介绍一下
- table：代表想要查询的数据库表名
- columns：代表想要查询的结果的列（相当于select语句的select关键字后面的部分）
- selection：代表想要通过这些列作为查询的条件（相当于select语句的where关键字后面的部分，允许使用占位符“？”）
- selectionArgs：与上面的 selection 参数有关，用于为 selection 子句中的占位符传入参数值，代表是这些列的具体的数据，也就知道是哪些行了
- groupBy：用于控制分组（相当于select语句的group by关键字后面的部分）
- having：用于对分组进行过滤（相当于select语句的having关键字后面的部分）
- orderBy：用于对记录进行排序（相当于select语句的order by关键字后面的部分）
- 正如上面所说的，因为不知道输入的是歌曲还是歌手，所以要查询两次
Cursor mCursor1 = mDbReader.query("music_msg", new String[]{"singer"}, "songname=?", new String[]{mInput}, null, null, null);
Cursor mCursor2 = mDbReader.query("music_msg", new String[]{"songname"}, "singer=?", new String[]{mInput}, null, null, null);
若mCursor1.getCount() > 0，表示输入的是歌曲，并且有查询到结果，这时定义一个全局变量List<Map<String, String>> mStringList = new ArrayList<>();然后通过游标的向下滑动，把歌曲和歌名都存进List里面，最后别忘了关闭游标。具体看代码去理解：
//查
public void queryData() {
String mInput = mEt_input.getText().toString().trim();
//第二个参数是你需要查找的列
//第三和第四个参数确定是从哪些行去查找第二个参数的列
Cursor mCursor1 = mDbReader.query("music_msg", new String[]{"singer"}, "songname=?", new String[]{mInput}, null, null, null);
Cursor mCursor2 = mDbReader.query("music_msg", new String[]{"songname"}, "singer=?", new String[]{mInput}, null, null, null);
if (mCursor1.getCount() > 0) {
mStringList.clear(); //清空List
while (mCursor1.moveToNext()) { //游标总是在查询到的上一行
Map<String, String> mMap = new HashMap<>();
String output_singer = mCursor1.getString(mCursor1.getColumnIndex("singer"));
mMap.put("tv1", mInput);
mMap.put("tv2", output_singer);
mStringList.add(mMap);
}
mCursor1.close();
} else if (mCursor2.getCount() > 0) {
mStringList.clear(); //清空List
while (mCursor2.moveToNext()) { //游标总是在查询到的上一行
Map<String, String> mMap = new HashMap<>();
String output_songname = mCursor2.getString(mCursor2.getColumnIndex("songname"));
mMap.put("tv1", output_songname);
mMap.put("tv2", mInput);
mStringList.add(mMap);
}
mCursor2.close();
} else {
mStringList.clear(); //清空List
Map<String, String> mMap = new HashMap<>();
mMap.put("tv1", "未能查询到结果");
mStringList.add(mMap);
}
}
- 最后通过查询按钮 btn_query 的点击监听事件去调用上面的 queryData()方法，然后用AlertDialog 进行对话框列表显示，代码如下：
mBtn_query.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
queryData();
mEt_input.setText(""); //清空输入框
new AlertDialog.Builder(MyListviewActivity.this)
.setTitle("查询结果")
.setAdapter(new SimpleAdapter(MyListviewActivity.this, mStringList, R.layout.dialog_tv_layout, new String[]{"tv1", "tv2"}, new int[]{R.id.tv1_dialog, R.id.tv2_dialog}), null)
.setPositiveButton("确定", null)
.show();
}
});
其中AlertDialog的setAdapter方法跟ListView设置SimpleAdapter基本一样，只是最后那个点击监听设置为null。
-
效果如图：
后话
- 完整代码已上传Github，如有疑问或表述有误的地方，欢迎在评论区交流。
- Github：https://github.com/TheCoffeeNoSugar/ListviewAndDatabase
网友评论