Android编程权威指南（第二版）学习笔记（二十五）—— 第25章 搜索

本章主要讲了 ToolBar 中的 SearchView 的使用以及 SharedPreferences 的简单使用。

GitHub 地址：
完成第25章

1. SearchView

SearchView 是一个 ActionView（操作视图），所谓操作视图，就是可以内置在工具栏中的视图。SearchView 可以让整个搜索界面完全内置在应用的工具栏中。

1.1 SearchView 的建立

首先我们建立菜单资源：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/menu_item_search"
        android:title="@string/search"
        app:actionViewClass="android.support.v7.widget.SearchView"
        app:showAsAction="ifRoom" />
</menu>

可以发现我们多了一个 app:actionViewClass 属性，这个就是指定这个 item 的 actionView 类。

现在只要我们在 onCreateOptionsMenu 中引用该菜单资源，就能看到 SearchView 了。

1.2 SearchView 的使用

我们现在能看到 SearchView，当然还要让其能够进行相应的工作：首先获取实例，然后设置回调方法。

@Override
public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {
    super.onCreateOptionsMenu(menu, inflater);
    inflater.inflate(R.menu.fragment_photo_gallery, menu);

    // 在这里获取这个 ActionView
    MenuItem searchItem = menu.findItem(R.id.menu_item_search);
    final SearchView searchView = (SearchView) searchItem.getActionView();

    searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
        @Override
        public boolean onQueryTextSubmit(String query) {
            // 点击提交后
            return true;
        }

        @Override
        public boolean onQueryTextChange(String newText) {
            // 文字改变时调用
            Log.d(TAG, "QueryTextChange: " + newText);
            return false;
        }
    });

    searchView.setOnSearchClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            String query = QueryPreferences.getStoredQuery(getActivity());
            searchView.setQuery(query, false);
        }
    });
}

2. 使用 SharedPreferences 实现轻量级数据存储

shared preferences 本质上就是文件系统中的文件，可使用 SharedPreferences 类读写它。 SharedPreferences 实例用起来更像一个键值对仓库(类似于 Bundle)，但它可以通过持久化存储保存数据。键值对中的键为字符串，而值是原子数据类型。进一步查看 shared preferences 文件可知，它们实际上是一种简单的 XML 文件，但 SharedPreferences 类已屏蔽了读写文件的实现细节。shared preferences 文件保存在应用沙盒中，所以，类似密码这样的敏感信息不应该用它来保存。
要获得定制的 SharedPreferences 实例 ， 可使用 Context.getSharedPreferences (String,int)方法。然而，在实际开发中，我们并不关心具体是什么样的 SharedPreferences 实例，只要它能共享于整个应用就可以了。这种情况下，最好使用PreferenceManager. getDefaultSharedPreferences(Context)方法，该方法会返回具有私有权限和默认名称的实例(仅在当前应用内可用)。

一个示例的 SharedPreferences 操作类如下：

public class QueryPreferences {
    private static final String PREF_SEARCH_QUERY = "searchQuery";

    public static String getStoredQuery(Context context) {
        return PreferenceManager.getDefaultSharedPreferences(context)
                .getString(PREF_SEARCH_QUERY, null);
    }

    public static void setStoredQuery(Context context, String query) {
        PreferenceManager.getDefaultSharedPreferences(context)
                .edit()
                .putString(PREF_SEARCH_QUERY, query)
                .apply();
    }
}