警告用户

你可能注意到了，按下 EditorActivity 的“上一个”(UP) 或“返回”(back) 按钮会使你离开 EditorActivity，但不会保存你的更改。你想要明确保存数据库更改的方法，那么我们只在用户点击“保存”(Save) 按钮的时候保存更改。

那么，当用户在添加一些编辑时不小心按下“上一个”(UP) 或“返回”(back) 按钮时会怎样呢？为避免用户丢失工作，我们可以跳出一个对话框，警告用户其在离开编辑器时有未保存的更改。

下面是联系人应用中的警告演示。当你输入新的联系人信息，然后在未保存的情况下点击了“上一个”(UP) 按钮时，你会看到此行为：

期望的行为

在我们的应用中，我们所期望的行为是跳出一个对话框，用消息“是否放弃更改并退出编辑”(Discard your changes and quit editing?) 来警告用户。用户可以选择“继续编辑”(Keep Editing)（即留在此活动）或“放弃”(Discard)（即结束活动）。

步骤

第 1 步：监听是否进行了更改

第一步是决定什么时候显示“放弃更改”对话框。这应仅在用户更改了表格的某一个部分时发生。你可以做的是创建一个名为 mPetHasChanged 的 boolean，如果用户更新了 pet 表的任何部分则为 true。

  private boolean mPetHasChanged = false;

你可以添加 OnTouchListener 来检查是否发生了更改：

   private View.OnTouchListener mTouchListener = new View.OnTouchListener() {@Overridepublic boolean onTouch(View view, MotionEvent motionEvent) { mPetHasChanged = true; return false; } }; 

在 onCreate 中：

   mNameEditText.setOnTouchListener(mTouchListener);mBreedEditText.setOnTouchListener(mTouchListener); mWeightEditText.setOnTouchListener(mTouchListener); mGenderSpinner.setOnTouchListener(mTouchListener); 

第 2 步：编写创建“放弃更改”对话框的方法

我们在下面编写一个创建此对话框的方法：

private void showUnsavedChangesDialog(DialogInterface.OnClickListener discardButtonClickListener) {// Create an AlertDialog.Builder and set the message, and click listeners// for the positive and negative buttons on the dialog.AlertDialog.Builder builder = new AlertDialog.Builder(this);builder.setMessage(R.string.unsaved_changes_dialog_msg);builder.setPositiveButton(R.string.discard, discardButtonClickListener);builder.setNegativeButton(R.string.keep_editing, new DialogInterface.OnClickListener() {public void onClick(DialogInterface dialog, int id) {// User clicked the "Keep editing" button, so dismiss the dialog// and continue editing the pet.if (dialog != null) {dialog.dismiss();}}});// Create and show the AlertDialogAlertDialog alertDialog = builder.create();alertDialog.show();
}

此代码使用 AlertDialogBuilder 创建了一个 AlertDialog。此方法接受放弃按钮的 OnClickListener。我们这样做是因为点击“返回”(back) 或“上一个”(up) 的行为略有不同。

并且注意，我们还使用了很多 R.string，你可以添加这些：

Discard your changes and quit editing?DiscardKeep Editing

第 3 步：连接“返回”（Back）按钮

这是“返回”按钮的代码。你需要覆盖此活动的正常返回按钮。如果宠物发生了变化，你建立会关闭当前活动的放弃点击侦听器。然后将此侦听器传入刚创建的 showUnsavedChangesDialog 方法。

@Override
public void onBackPressed() {// If the pet hasn't changed, continue with handling back button pressif (!mPetHasChanged) {super.onBackPressed();return;}// Otherwise if there are unsaved changes, setup a dialog to warn the user.// Create a click listener to handle the user confirming that changes should be discarded.DialogInterface.OnClickListener discardButtonClickListener =new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialogInterface, int i) {// User clicked "Discard" button, close the current activity.finish();}};// Show dialog that there are unsaved changesshowUnsavedChangesDialog(discardButtonClickListener);
}

第 4 步：连接“上一个”（Up）按钮

这里是“上一个”按钮的代码。它在 onOptionsItemSelected 方法中。如果宠物发生变化，你建立一个会导航至“上一个”的放弃点击侦听器。然后将此侦听器传入刚创建的 showUnsavedChangesDialog 方法。

case android.R.id.home:// If the pet hasn't changed, continue with navigating up to parent activity// which is the {@link CatalogActivity}.if (!mPetHasChanged) {NavUtils.navigateUpFromSameTask(EditorActivity.this);return true;}// Otherwise if there are unsaved changes, setup a dialog to warn the user.// Create a click listener to handle the user confirming that// changes should be discarded.DialogInterface.OnClickListener discardButtonClickListener =new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialogInterface, int i) {// User clicked "Discard" button, navigate to parent activity.NavUtils.navigateUpFromSameTask(EditorActivity.this);}};// Show a dialog that notifies the user they have unsaved changesshowUnsavedChangesDialog(discardButtonClickListener);return true;

练习完成前后的差异

有用链接：

要向“返回”（back）按钮被点击的情况添加行为，参阅此 StackOverflow 帖子。

要向“上一个”（Up）按钮被点击的情况添加行为，参阅此文章。你还需要向 android.R.id.home 按钮被点击的情况添加代码。

如何创建 AlertDialog。

14

如果宠物还不存在，则无法删除它

我们当前的代码还有一个“问题”，那就是当你处于 EditorActivity 的插入模式时，会在菜单中看到一个“删除”(Delete) 选项。由于你当前在插入宠物，因此没有宠物可供删除，那么这个选项是多余的。

我们来解决这个问题。我们要删除“插入模式”中的删除选项。

如何选择运行应用时的菜单

当你第一次打开活动时，会调用 onCreateOptionsMenu 方法。它会用所有可见的菜单项填充菜单。要更改它，你需要做的是在确定它是一个新宠物后（mPetContentUri 为空值），你要使选项菜单无效。

所以在 onCreate 中……

    if (mCurrentPetUri == null) {// This is a new pet, so change the app bar to say "Add a Pet"setTitle(getString(R.string.editor_activity_title_new_pet));// Invalidate the options menu, so the "Delete" menu option can be hidden.// (It doesn't make sense to delete a pet that hasn't been created yet.) invalidateOptionsMenu(); } else { //other stuff } 

然后，onPrepareOptionsMenu 会被调用，你可以在它是新宠物时隐藏删除菜单选项来修改菜单对象。 此操作的代码如下：

    @Overridepublic boolean onPrepareOptionsMenu(Menu menu) { super.onPrepareOptionsMenu(menu); // If this is a new pet, hide the "Delete" menu item. if (mCurrentPetUri == null) { MenuItem menuItem = menu.findItem(R.id.action_delete); menuItem.setVisible(false); } return true; } 

练习完成前后的差异

有用链接：

Android开发文档：菜单选项

Stack Overflow 提问：如何改变菜单项

15

• 查看答案
• 提交答案

解答

在复制代码片段后，首先我们要通过在按下删除按钮时调用 showDeleteConfirmationDialog 方法来确保触发它。方法是前往 onOptionsItemSelected 并在 action.delete 下添加对 showDeleteConfirmationDialog 的调用。

        // Respond to a click on the "Delete" menu optioncase R.id.action_delete:// Pop up confirmation dialog for deletionshowDeleteConfirmationDialog();

showDeleteConfirmationDialog 会创建一个对话框，在删除按钮被按下时调用 deletePet。首先，我确保我们是对现有宠物执行删除。因为对数据库中尚不存在的新宠物执行删除是没有意义的。所以我检查是否存在现有宠物（mCurrentPetUri 是否等于 null）。然后使用 content resolver 和当前的宠物 uri 删除宠物。

/*** Perform the deletion of the pet in the database.*/
private void deletePet() {// Only perform the delete if this is an existing pet.if (mCurrentPetUri != null) { // Call the ContentResolver to delete the pet at the given content URI. // Pass in null for the selection and selection args because the mCurrentPetUri // content URI already identifies the pet that we want. int rowsDeleted = getContentResolver().delete(mCurrentPetUri, null, null); 

delete 方法和 update 方法一样，会返回被删除的行数。我可以通过检查被删除的行数是否为 0 来确定删除成功与否。若为 0，则删除失败，我会显示一条 toast 消息，说明“删除宠物时出错”(Error with deleting pet)。 否则，操作将是成功的，且我跳出一条 toast 消息说“宠物已删除”(Pet deleted)。

        // Show a toast message depending on whether or not the delete was successful.if (rowsDeleted == 0) {// If no rows were deleted, then there was an error with the delete.Toast.makeText(this, getString(R.string.editor_delete_pet_failed), Toast.LENGTH_SHORT).show(); } else { // Otherwise, the delete was successful and we can display a toast. Toast.makeText(this, getString(R.string.editor_delete_pet_successful), Toast.LENGTH_SHORT).show(); } 

完成操作后，调用 finish() 方法关闭此 activity。

    // Close the activityfinish();

到此，我们就能成功从 EditorActivity 中删除宠物了！

练习完成前后的差异.

16

现在，我要你添加当用户从 CatalogActivity 上的溢出菜单点击“删除所有宠物”(Delete All Pets) 选项时，用于删除所有宠物的代码。无需添加确认消息，但是如果你想，也可以自行实现。

完成后，菜单看起来应该是这样的：

这里的变更较小，所以我就不多做讲解，由你自己来完成。

Android 中的 菜单选项。

• 查看答案
• 提交答案

解答

对于此练习，我们在 CatalogActivity.java 文件中进行。

此菜单按钮与 R.id.action_delete_all_entries 关联，所以在 onOptionsMenuSelected 方法的该 case 下，我将添加对名为“deleteAllPets()”方法的调用。

        case R.id.action_delete_all_entries:deleteAllPets();return true;

然后在该方法中，我将使用 ContentResolver 的 delete 方法，并传入PetEntry.CONTENT_URI。为什么要用内容 URI？因为这是一个一般 __/pets uri，在我们的 内容提供程序中将删除所有宠物。

/*** Helper method to delete all pets in the database.*/
private void deleteAllPets() {int rowsDeleted = getContentResolver().delete(PetEntry.CONTENT_URI, null, null); Log.v("CatalogActivity", rowsDeleted + " rows deleted from pet database"); } 

此菜单按钮与R.id.action_delete_all_entries 关联，所以在 onOptionsMenuSelected 方法的该 case 下，我将添加对名为“deleteAllPets()”方法的调用。

练习完成前后的差异.

17

对于我们的最后一项更新，你需要解决 UI 中的另一个奇怪的行为。当品种未知时，宠物列表看起来总觉得缺点什么。因为宠物名下就是一片空白。

在未提供品种信息的情况下，比起留白，显示一个语句“品种未知”(Unknown breed) 会提供更好的用户体验。

完成此步后应用看起来应该是这个样子的：

注意，这只是 CatalogActivity 中的一个 UI 变化，文本“Unknown breed”不应保存在数据库中。如果你在编辑器中打开此宠物，“品种”(breed) 字段应该是空白的：

提示：如果输入字符串为空值或空字符串TextUtils.isEmpty(String s) 将返回 true。

• 查看答案
• 提交答案

解答

首先，由于我们要添加字符串“Unknown breed”，我们在 strings.xml 文件中保存它。

<!-- Label for the pet's breed if the breed is unknown [CHAR LIMIT=20] -->
<string name="unknown_breed">Unknown breed</string> 

接下来，我们移至 PetCursorAdapter.java 文件。当我们在 CatalogActivity 中显示宠物时，我们要检查是否有使用 TextUtils.isEmpty 方法的品种。如果没有，我们将列表项的 TextView 设为显示“Unknown breed”。

In PetCursorAdapter.java:

/*** This method binds the pet data (in the current row pointed to by cursor) to the given* list item layout. For example, the name for the current pet can be set on the name TextView* in the list item layout.** @param view    Existing view, returned earlier by newView() method* @param context app context* @param cursor  The cursor from which to get the data. The cursor is already moved to the*                correct row.*/
@Override public void bindView(View view, Context context, Cursor cursor) { // Find individual views that we want to modify in the list item layout TextView nameTextView = (TextView) view.findViewById(R.id.name); TextView summaryTextView = (TextView) view.findViewById(R.id.summary); // Find the columns of pet attributes that we're interested in int nameColumnIndex = cursor.getColumnIndex(PetEntry.COLUMN_PET_NAME); int breedColumnIndex = cursor.getColumnIndex(PetEntry.COLUMN_PET_BREED); // Read the pet attributes from the Cursor for the current pet String petName = cursor.getString(nameColumnIndex); String petBreed = cursor.getString(breedColumnIndex); // If the pet breed is empty string or null, then use some default text // that says "Unknown breed", so the TextView isn't blank. if (TextUtils.isEmpty(petBreed)) { petBreed = context.getString(R.string.unknown_breed); } // Update the TextViews with the attributes for the current pet nameTextView.setText(petName); summaryTextView.setText(petBreed); } 

练习完成前后的差异.