手把手教你使用SearchView实现搜索歌曲功能

以下源码来自于Timber开源APP的SearchActivity：
https://github.com/JakeWharton/timber

---

要实现的效果：

没有关键词的情况

搜索结果

一、在Toolbar上添加返回按钮并添加点击事件

首先，如图，我们最上面的那个是一个Toolbar，先要设置最左边的那个返回按钮（见代码注释）

//Toolbar设置
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
//设置toolbar最左边那个android.R.id.home的图标是否显示，若设为true，则
// 显示一个向左的小箭头
getSupportActionBar().setDisplayHomeAsUpEnabled(true); 

为这个返回按钮添加点击事件：

@Override
    public boolean onOptionsItemSelected(final MenuItem item)
    {
        switch (item.getItemId())
        {
            case android.R.id.home:
                finish();
                return true;
            default:
                break;
        }
        return super.onOptionsItemSelected(item);
    }

二、在toolbar上添加searchView

SearchView是谷歌自己就已经实现了的View，可以直接创建，但是注意SearchView的创建过程是在onCreateOptionsMenu()这个方法中（我猜是因为这个searchView是显示在Toolbar上的原因）：

mSearchView = (SearchView) MenuItemCompat.getActionView(menu.findItem(R.id.menu_search));

（这个具体到底为什么是这么写现在还不是很清楚，先记下了了）

//添加searchView
    @Override
    public boolean onCreateOptionsMenu(final Menu menu)
    {
        //把“搜索”图标加载上去
        getMenuInflater().inflate(R.menu.menu_search, menu);


        mSearchView = (SearchView) MenuItemCompat.getActionView(menu.findItem(R.id.menu_search));

        //searchView设置输入的监听器
        mSearchView.setOnQueryTextListener(this);
        //hint
        mSearchView.setQueryHint(getString(R.string.search_library));

        //当iconifiedByDefault属性被设置为true时（java代码使用setIconifiedByDefault (true)设置），搜索栏的默认
        //表现为一个单一的搜索图标，当点击这个图标后，才会展开显示完整的搜索图标、搜索输入框、关闭X按钮。
        mSearchView.setIconifiedByDefault(false);
        mSearchView.setIconified(false);

        //这里应该是设置右上角返回按钮的点击事件，但是这个又与下面onOptionsItemSelected方法中的功能重复了····
        MenuItemCompat.setOnActionExpandListener(menu.findItem(R.id.menu_search), new MenuItemCompat.OnActionExpandListener()
        {
            @Override
            public boolean onMenuItemActionExpand(MenuItem item)
            {
                return true;
            }

            @Override
            public boolean onMenuItemActionCollapse(MenuItem item)
            {
                finish();
                return false;
            }
        });
        
        //这行代码不知道什么意思
        menu.findItem(R.id.menu_search).expandActionView();

        return super.onCreateOptionsMenu(menu);
    }

searchView的输入监听：

    //以下2个方法都是继承自SearchView.OnQueryTextListener
    // 输入完成后，提交时触发的方法，一般情况是点击输入法中的搜索按钮才会触发。表示现在正式提交了
    @Override
    public boolean onQueryTextSubmit(final String query)
    {
        onQueryTextChange(query);
        hideInputManager();

        return true;
    }

    //在输入时触发的方法，当字符真正显示到searchView中才触发，像是拼音，在输入法组词的时候不会触发
    @Override
    public boolean onQueryTextChange(final String newText)
    {
        //防止相同内容被多次重复搜索
        if (newText.equals(queryString))
        {
            return true;
        }

        if (mSearchTask != null)
        {
            mSearchTask.cancel(false);
            mSearchTask = null;
        }
        queryString = newText;

        if (queryString.trim().equals("")) //searchView中内容为空，就清除adapter中的内容
        {
            searchResults.clear();
            adapter.updateSearchResults(searchResults);
            adapter.notifyDataSetChanged();
        }
        else
        {
            //开始搜索输入的内容
            mSearchTask = new SearchTask().executeOnExecutor(mSearchExecutor, queryString);
            // executeOnExecutor使用线程池来处理，一个线程池可以有多个线程，可能会出现多个线程对同一文件的竞争读取
            //详见：http://blog.csdn.net/hitlion2008/article/details/7983449
        }

        return true;
    }

三、搜索任务的AsyncTask

private class SearchTask extends AsyncTask>
    {

        @Override
        protected ArrayList