Android实现SQLite数据库联系人列表
Android实现SQLite数据库联系人列表
开发工具：Andorid Studio 1.3
运行环境：Android 4.4 KitKat
工程内容
实现一个通讯录查看程序：
- 要求使用SQLite数据库保存通讯录，使得每次运行程序均能显示当前联系人的列表
- 主界面包含一个添加联系人按钮和一个联系人列表，每一项显示联系人学号，姓名，手机号码。
- 点击添加联系人按钮能添加新的联系人。
- 在次界面输入联系人信息之后点击确定按钮后会返回主界面。（前提输入正确）
- 长按某个联系人，弹出对话框，询问是否删除该联系人。
- 单击某个联系人，弹出修改联想人的界面。
代码实现
为联系人添加一个类Contact，封装学号姓名手机号码三个字段，并重构三个构造函数，给每个字段设置公有的get、set函数，这是类最标准的做法。
public class Contact {
private String no;
private String name;
private String phoneNumber;
public Contact() {}
public Contact(String _name, String _phoneNumber) {
this.name = _name;
this.phoneNumber = _phoneNumber;
}
public Contact(String _no, String _name, String _phoneNumber) {
this.no = _no;
this.name = _name;
this.phoneNumber = _phoneNumber;
}
public String getNo() { return no; }
public void setNo(String _no) { this.no = _no; }
public String getName() { return name; }
public void setName(String _name) { this.name = _name; }
public String getPhoneNumber() { return phoneNumber; }
public void setPhoneNumber(String _phoneNumber) { this.phoneNumber = _phoneNumber; }
}
为接下来要用到的数据库方法新建一个类MyDatabaseHelper继承自SQLiteOpenHelper，设置好数据库名称和表格名称以及比较重要的版本号，封装好以便后面使用。
public class MyDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "Contacts.db";
private static final String TABLE_NAME = "Contacts";
private static final int DB_VERSION = 1;
public MyDatabaseHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
}
一开始是创建数据库，这里使用自增的id字段为关键字，其余学号姓名手机为基本字段，创建
一个表格存储，当这个MyDatabaseHelper被实例化的时候即创建表格，因此在onCreate()中做
@Override
public void onCreate(SQLiteDatabase db) {
String CREATE_TABLE = "create table " + TABLE_NAME
+ " (_id integer primary key autoincrement, "
+ "_no text not null, "
+ "_name text not null, "
+ "_pnumber text);";
db.execSQL(CREATE_TABLE);
}
为了能创建实例需要重载onUpgrade()函数，这里简单地重载，但是调用会出事，整张表格内容会丢失，但在这次程序里面不会被调用，先暂且写着
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
String DROP_TABLE = "DROP TABLE IF EXITS " + TABLE_NAME;
db.execSQL(DROP_TABLE);
onCreate(db);
}
在数据库中插入一个联系人，传入一个联系人对象即可，插入一个数据库项
public long insert(Contact entity) {
SQLiteDatabase db = getWritableDatabase();
ContentValues values = new ContentValues();
values.put("_no", entity.getNo());
values.put("_name", entity.getName());
values.put("_pnumber", entity.getPhoneNumber());
long id = db.insert(TABLE_NAME, null, values);
db.close();
return id;
}
在数据库中更新联系人，根据传入的联系人学号查找数据库，将新的数据覆盖原来数据库中的数据即可更新
public int update(Contact entity) {
SQLiteDatabase db = getWritableDatabase();
String whereClause = "_no = ?";
String[] whereArgs = { entity.getNo() };
ContentValues values = new ContentValues();
values.put("_no", entity.getNo());
values.put("_name", entity.getName());
values.put("_pnumber", entity.getPhoneNumber());
int rows = db.update(TABLE_NAME, values, whereClause, whereArgs);
db.close();
return rows;
}
在数据库中删除联系人，根据传入的联系人的学号查找数据库，找到后删除即可
public int delete(Contact entity) {
SQLiteDatabase db = getWritableDatabase();
String whereClause = "_no = ?";
String[] whereArgs = { entity.getNo() };
int rows = db.delete(TABLE_NAME, whereClause, whereArgs);
db.close();
return rows;
}
在数据库中查询数据库表头，使用query方法参数全部为空即可匹配数据库表的第一项，返回内容是指向第一项的指针类，可以向后遍历表格中的项
public Cursor query() {
SQLiteDatabase db = getReadableDatabase();
return db.query(TABLE_NAME, null, null, null, null, null, null);
}
为ListView建立一个MySimpleAdapter类继承自SimpleAdapter，可以方便地绑定到ListView中
public class MySimpleAdapter extends SimpleAdapter {
private ArrayList<Map<String, String>> mData;
public MySimpleAdapter(Context context, List<? extends Map<String, ?>> data,
int resource, String[] from, int[] to) {
super(context, data, resource, from, to);
this.mData = (ArrayList<Map<String, String>>)data;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
final int mPosition = position;
return super.getView(position, convertView, parent);
}
}
准备工作已经做好了，剩下的就是程序的逻辑编写。
进入主界面需要更新ListView的内容，使用刚才写好的query方法访问数据库中全部的内容，加入到一个List中，并通过该List和之前写好的ListView Item Layout创建一个MySimpleAdapter绑定到ListView中，完成更新。由于这步工作在后续的添加联系人、修改联系人和删除联系人中都使用到，因此封装成一个函数以便调用。
private void setData(List<Map<String, String>> mDataList) {
Map<String, String> mData;
Cursor c = myDatabaseHelper.query();
while (c.moveToNext()) {
mData = new HashMap<String, String>();
mData.put("no", c.getString(c.getColumnIndex("_no")));
mData.put("name", c.getString(c.getColumnIndex("_name")));
mData.put("pnumber", c.getString(c.getColumnIndex("_pnumber")));
mDataList.add(mData);
}
}
private void updateListView() {
dataList.clear();
setData(dataList);
MySimpleAdapter mySimpleAdapter = new MySimpleAdapter(this, dataList, R.layout.contact_item,
new String[] { "no", "name", "pnumber" },
new int[] { R.id.contact_no, R.id.contact_name, R.id.contact_phonenumber });
ListView lv = (ListView)this.findViewById(R.id.lv_contact);
lv.setAdapter(mySimpleAdapter);
}
当用户点击添加按钮的时候，跳转到次界面，并传递消息给次界面是通过Add按钮跳转到这里来的，使用startActivityForResult方法，并设定Add按钮的requestCode为1
Button btnAdd = (Button)this.findViewById(R.id.btn_add);
btnAdd.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Intent intent = new Intent(MainActivity.this, DetailActivity.class);
Bundle bundle = new Bundle();
bundle.putBoolean("AddorNot", true);
intent.putExtras(bundle);
int requestCode = 1;
startActivityForResult(intent, requestCode);
}
});
次界面中根据主界面传递进来的消息，更新界面，显示是否是添加联系人或者修改联系人，如果是添加联系人，界面全部字段为空，如果是修改联系人，填入原本的联系人信息到界面字段中
Bundle bundle = getIntent().getExtras();
final boolean addOrNot = bundle.getBoolean("AddorNot");
if (addOrNot) {
tvTitle.setText(getResources().getString(R.string.titleAdd));
edtNo.setText("");
edtName.setText("");
edtPNumber.setText("");
} else {
tvTitle.setText(getResources().getString(R.string.titleModify));
edtNo.setText(bundle.getString("oldNo"));
edtName.setText(bundle.getString("oldName"));
edtPNumber.setText(bundle.getString("oldPNumber"));
}
当用户在次界面点击按钮的时候，用正则表达式判断输入是否符合学号和手机号码的规则，以及姓名不能为空，然后根据是添加联系人或者修改联系人设定返回信息，并传递联系人消息回主界面
Button btnConfirm = (Button)this.findViewById(R.id.btn_confirm);
btnConfirm.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
String newNo = edtNo.getText().toString();
String newName = edtName.getText().toString();
String newPNumber = edtPNumber.getText().toString();
if (!newNo.matches("^[1-9]\\d{7}$")
|| !newPNumber.matches("^[1-9]\\d{10}$")
|| newName.isEmpty()) {
Toast.makeText(getApplicationContext(), getResources().getString(R.string.msgWarning),
Toast.LENGTH_SHORT).show();
return;
}
Intent intent = new Intent();
intent.putExtra("_newNo", newNo);
intent.putExtra("_newName", newName);
intent.putExtra("_newPNumber", newPNumber);
int resultCode = 0;
if (addOrNot) resultCode = 1;
else resultCode = 2;
DetailActivity.this.setResult(resultCode, intent);
DetailActivity.this.finish();
}
});
主界面需要重载onActivityResult方法捕获从次界面传递回来的消息，判断是否为更新联系人或者添加联系人，然后均需要更新整个界面
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
Log.d("Hint", "requestCode = " + requestCode);
Log.d("Hint", "resultCode = " + resultCode);
if (resultCode == 0)
return;
String newNo = data.getStringExtra("_newNo");
String newName = data.getStringExtra("_newName");
String newPNumber = data.getStringExtra("_newPNumber");
switch (requestCode) {
case 1:
myDatabaseHelper.insert(new Contact(newNo, newName, newPNumber));
break;
case 2:
myDatabaseHelper.update(new Contact(newNo, newName, newPNumber));
break;
default:
break;
}
updateListView();
}
点击联系人进入修改联系人界面（次界面），传递消息告诉次界面为修改联系人，设置相应的requestCode为2
ListView lv = (ListView)this.findViewById(R.id.lv_contact);
lv.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
ListView listView = (ListView) parent;
HashMap<String, String> map = (HashMap<String, String>)listView.getItemAtPosition(position);
Intent intent = new Intent(MainActivity.this, DetailActivity.class);
Bundle bundle = new Bundle();
bundle.putBoolean("AddorNot", false);
bundle.putString("oldNo", map.get("no"));
bundle.putString("oldName", map.get("name"));
bundle.putString("oldPNumber", map.get("pnumber"));
intent.putExtras(bundle);
int requestCode = 2;
startActivityForResult(intent, requestCode);
}
});
当长按联系人的时候，弹出弹窗询问是否需要删除联系，如果用户选择是删除联系人，则使用数据库的delete方法，并更新界面
lv.setOnItemLongClickListener(new AdapterView.OnItemLongClickListener() {
@Override
public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
ListView listView = (ListView) parent;
final HashMap<String, String> map = (HashMap<String, String>)listView.getItemAtPosition(position);
AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
builder.setMessage("确认删除吗？");
builder.setTitle("提示");
builder.setPositiveButton("确认", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialogInterface, int i) {
try {
myDatabaseHelper.delete(new Contact(map.get("no"), map.get("name"), map.get("pnumber")));
updateListView();
} catch (Exception e) {
Log.d("Hint", "Remove failed!");
}
}
});
builder.setNegativeButton("取消", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialogInterface, int i) {
// nothing to do
}
});
builder.show();
return true;
}
});
基本逻辑完成，但是程序有bug，在下面会说到
效果图
初始化界面->点击添加->填入错误信息点击确定->填入正确信息
正确信息确定后主界面增加->点击张三进入修改->修改为正确内容->确定确定后更新
长按李四提示是否删除->点击确认删除后更新界面
一些总结
当用户在次界面点击返回按钮的时候，因为主界面会捕获消息并进行相应的处理，但是返回键是没有消息返回的，因此需要重载返回按钮，否则整个程序会崩溃。通过设置resultCode为0，以区分是用返回键返回的
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if(keyCode == KeyEvent.KEYCODE_BACK) {
int resultCode = 0;
DetailActivity.this.setResult(resultCode);
DetailActivity.this.finish();
}
return true;
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
Log.d("Hint", "requestCode = " + requestCode);
Log.d("Hint", "resultCode = " + resultCode);
if (resultCode == 0)
return;
}
工程下载
传送门：下载
