小米开源便签Notes-源码研究(1)-导出功能整体思路

NotesListActivity是入口Activity。

响应菜单事件，我的手机是“左键菜单”。
如果菜单项的ID是“R.id.menu_export_text”，就执行导出，保存到/mnt/sdcard/MIUI/notes目录下。

@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.menu_new_folder: {
showCreateOrModifyFolderDialog(true);
break;
}
case R.id.menu_export_text: {
exportNoteToText();
break;
}
case R.id.menu_sync: {
if (isSyncMode()) {
if (TextUtils.equals(item.getTitle(),
getString(R.string.menu_sync))) {
GTaskSyncService.startSync(this);
} else {
GTaskSyncService.cancelSync(this);
}
} else {
startPreferenceActivity();
}
break;
}
case R.id.menu_setting: {
startPreferenceActivity();
break;
}
case R.id.menu_new_note: {
createNewNote();
break;
}
case R.id.menu_search:
onSearchRequested();
break;
default:
break;
}
return true;
}

NotesListActivity中的导出方法。
传入上下文，获得备份工具类BackupUtils的一个实例（单例）。
然后，新建一个异步任务AsyncTask，执行具体的备份功能。
后台方法执行在doInBackground，调用BackupUtils的exportToText方法。
onPostExecute给出用户反馈，3种情况：
a.SDCard没有挂在，警告对话框AlertDialog提示出错。
b.STATE_SYSTEM_ERROR，运行时错误。
c.成功，(*^__^*) 。

private void exportNoteToText() {
final BackupUtils backup = BackupUtils
.getInstance(NotesListActivity.this);
new AsyncTask<Void, Void, Integer>() {

@Override
protected Integer doInBackground(Void... unused) {
return backup.exportToText();
}

@Override
protected void onPostExecute(Integer result) {
if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
AlertDialog.Builder builder = new AlertDialog.Builder(
NotesListActivity.this);
builder.setTitle(NotesListActivity.this
.getString(R.string.failed_sdcard_export));
builder.setMessage(NotesListActivity.this
.getString(R.string.error_sdcard_unmounted));
builder.setPositiveButton(android.R.string.ok, null);
builder.show();
} else if (result == BackupUtils.STATE_SUCCESS) {
AlertDialog.Builder builder = new AlertDialog.Builder(
NotesListActivity.this);
builder.setTitle(NotesListActivity.this
.getString(R.string.success_sdcard_export));
builder.setMessage(NotesListActivity.this.getString(
R.string.format_exported_file_location,
backup.getExportedTextFileName(),
backup.getExportedTextFileDir()));
builder.setPositiveButton(android.R.string.ok, null);
builder.show();
} else if (result == BackupUtils.STATE_SYSTEM_ERROR) {
AlertDialog.Builder builder = new AlertDialog.Builder(
NotesListActivity.this);
builder.setTitle(NotesListActivity.this
.getString(R.string.failed_sdcard_export));
builder.setMessage(NotesListActivity.this
.getString(R.string.error_sdcard_export));
builder.setPositiveButton(android.R.string.ok, null);
builder.show();
}
}

}.execute();
}

接下来深入看
BackupUtils的导出方法。

public int exportToText() {
return mTextExport.exportToText();
}

mTextExport是一个静态内部类。

具体的导出逻辑如下：
1.从内容提供器ContentProvider中查询，根目录下的文件夹，
备份文件夹和文件夹下的便签notes。

2.从内容提供器ContentProvider中查询，根目录下便签notes，
备份便签。

查询语句，类似

Cursor folderCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
"(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+ NoteColumns.PARENT_ID + "<>"
+ Notes.ID_TRASH_FOLER + ") OR " + NoteColumns.ID
+ "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);

在整个导出功能中，最难的是内容提供器的查询。

AndroidManifest.xml中有配置NotesProvider，继承自ContentProvider。

<provider
android:name="net.micode.notes.data.NotesProvider"
android:authorities="micode_notes"
android:multiprocess="true" />

public class NotesProvider extends ContentProvider {
｝

本篇就先介绍到这，整体的导出思路已经比较清楚了，今后在单独详细介绍ContentProvider的实现。