Android SearchBar 搜索框介绍SearchManager

feiyang10086

Android SearchBar 搜索框介绍SearchManager

浮动搜索框的使用其实并不难，而是在于它的配置非常之繁琐，对于它的使用主要是方便开发者对于程序中有搜索业务时，更好的设计UI

SearchManager具体使用步骤如下：

（1）配置search bar的相关信息，新建一个位于res/xml下的一个searchable.xml的配置文件，如默认值、是否有搜索建议或者语音搜索。

1. 
   
2. 01.<searchable xmlns:android=http://schemas.android.com/apk/res/android
   
3. 
   
4. 02.　　<!-- label为搜索框上方的文本，hint搜索框里面的提示文本，显示label -->
   
5. 
   
6. 03.    android:label="@string/search_label"
   
7. 
   
8. 04.    android:hint="@string/search_hint"
   
9. 
   
10. 05.    android:searchMode="showSearchLabelAsBadge"
    
11. 
    
12. 06.   
    
13. 
    
14. 07.　　<!-- 语音搜索配置 -->
    
15. 
    
16. 08.    android:voiceSearchMode="showVoiceSearchButton|launchRecognizer"
    
17. 
    
18. 09.    android:voiceLanguageModel="free_form"
    
19. 
    
20. 10.    android:voicePromptText="@string/search_invoke"
    
21. 
    
22. 11.
    
23. 
    
24. 12.    <!-- 配置搜索建议，配置错误将不会显示，这里的searchSuggestAuthority的值必须是
    
25. 
    
26. 13.    继承自SearchRecentSuggestionsProvider的完整路径名 -->
    
27. 
    
28. 14.　　 android:searchSuggestAuthority="com.android.cbin.SearchSuggestionSampleProvider"
    
29. 
    
30. 15.    android:searchSuggestSelection=" ? "
    
31. 
    
32. 16./>

复制代码

（2） manifest.xml配置，搜索结果处理的Activity将出现两种情况，一种是从其他Activity中的search bar打开一个Activtiy

专门处理搜索结果，第二种是就在当前Activity就是处理结果的Activity，先介绍第一种配置：

1. 
   
2. 01.<activity android:name="SearchResultActivity">
   
3. 
   
4. 02.   
   
5. 
   
6. 03.        <intent-filter>
   
7. 
   
8. 04.            <action android:name="android.intent.action.SEARCH"></action>
   
9. 
   
10. 05.        </intent-filter>
    
11. 
    
12. 06.
    
13. 
    
14. 07.　　　　　
    
15. 
    
16. 08.　　　　 <!-- 指定上面的searchable.xml文件 -->
    
17. 
    
18. 09.　　　<meta-data android:resource="@xml/searchable"
    
19. 
    
20. 10.　　　　　　　　 android:name="android.app.searchable"></meta-data>
    
21. 
    
22. 11.
    
23. 
    
24. 12.    </activity>

复制代码

<!-- 为了使每一个Activity都能使用search bar,一定要将这个标签放到启动Activity中，里面的value指定 的是前面的搜索结果Activity--> <meta-data android:name="android.app.default_searchable"
                       android:value=".SearchResultActivity" />（3）搜索建议在manifest.xml中相关的配置<!--之前searchable.xml中有一个searchSuggestAuthority的值其实和这里的
authorities指向的都是name中所关联的SearchSuggestionSampleProvider，他是一个
SearchRecentSuggestionsProvider的子类-->
<provider android:name="SearchSuggestionSampleProvider"
  android:authorities="com.android.cbin.SearchSuggestionSampleProvider"></provider>
上面authorities指向的都是name中所关联的SearchSuggestionSampleProvider，他是一个
SearchRecentSuggestionsProvider的子类

1. 01.public class SearchSuggestionSampleProvider extends
   
2. 
   
3. 02.        SearchRecentSuggestionsProvider {
   
4. 
   
5. 03.
   
6. 
   
7. 04.    final static String AUTHORITY="com.android.cbin.SearchSuggestionSampleProvider";
   
8. 
   
9. 05.    final static int MODE=DATABASE_MODE_QUERIES;
   
10. 
    
11. 06.   
    
12. 
    
13. 07.    public SearchSuggestionSampleProvider(){
    
14. 
    
15. 08.        super();
    
16. 
    
17. 09.        setupSuggestions(AUTHORITY, MODE);
    
18. 
    
19. 10.    }
    
20. 
    
21. 11.}

复制代码

（4）为了能够使用search bar 我们必须重写Activity的onSearchRequested的方法，在界面上启动一个search bar

但是这个动作不会自动触发，必须通过一个按钮或者菜单的点击事件触发；

1. 
   
2. 01.@Override
   
3. 
   
4. 02.    public boolean onSearchRequested(){
   
5. 
   
6. 03.        
   
7. 
   
8. 04.        String text=etdata.getText().toString();
   
9. 
   
10. 05.        Bundle bundle=new Bundle();
    
11. 
    
12. 06.        bundle.putString("data", text);
    
13. 
    
14. 07.        
    
15. 
    
16. 08.        //打开浮动搜索框（第一个参数默认添加到搜索框的值）
    
17. 
    
18. 09.        //bundle为传递的数据
    
19. 
    
20. 10.        startSearch("mm", false, bundle, false);
    
21. 
    
22. 11.        //这个地方一定要返回真 如果只是super.onSearchRequested方法不但
    
23. 
    
24. 12.　　　　 //onSearchRequested（搜索框默认值）无法添加到搜索框中,bundle也无法传递出去
    
25. 
    
26. 13.        return true;
    
27. 
    
28. 14.    }
    
29. 复制代码（5）接收query和bundle、保存query值（即搜索建议的列表值）
    
30. 
    
31. 
    
32. 01.public void doSearchQuery(){
    
33. 
    
34. 02.        final Intent intent = getIntent();
    
35. 
    
36. 03.        //获得搜索框里值
    
37. 
    
38. 04.        String query=intent.getStringExtra(SearchManager.QUERY);
    
39. 
    
40. 05.        tvquery.setText(query);
    
41. 
    
42. 06.        //保存搜索记录
    
43. 
    
44. 07.        SearchRecentSuggestions suggestions=new SearchRecentSuggestions(this,
    
45. 
    
46. 08.                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
    
47. 
    
48. 09.        suggestions.saveRecentQuery(query, null);
    
49. 
    
50. 10.        if(Intent.ACTION_SEARCH.equals(intent.getAction())){
    
51. 
    
52. 11.            //获取传递的数据
    
53. 
    
54. 12.            Bundle bundled=intent.getBundleExtra(SearchManager.APP_DATA);
    
55. 
    
56. 13.            if(bundled!=null){
    
57. 
    
58. 14.                String ttdata=bundled.getString("data");
    
59. 
    
60. 15.                tvdata.setText(ttdata);
    
61. 
    
62. 16.
    
63. 
    
64. 17.            }else{
    
65. 
    
66. 18.                tvdata.setText("no data");
    
67. 
    
68. 19.            }
    
69. 
    
70. 20.        }
    
71. 
    
72. 21.    }

复制代码

之前说到了处理结果的Activity将可能出现的两种情况的两种，现在就处理第二种状况，就是假如invoke search bar的Activity同时也是处理搜索结果的Activity，如果按照之前的方式处理则会出现一种情况，搜索一次就实例化一次Activity,当按返回键的时候会发现老是同一个Activity,其实为了使它只有一个实例化对象，只需简单的配置和代码就能实现第一:在处理搜索结果Activity的manifest.xml中添加android:launchMode="singleTop"属性第二:重写Activity的onNewIntent(Intent intent)

1. 01.@Override
   
2. 
   
3. 02.    public void onNewIntent(Intent intent){
   
4. 
   
5. 03.        super.onNewIntent(intent);
   
6. 
   
7. 04.        //获得搜索框里值
   
8. 
   
9. 05.        String query=intent.getStringExtra(SearchManager.QUERY);
   
10. 
    
11. 06.        tvquery.setText(query);
    
12. 
    
13. 07.        //保存搜索记录
    
14. 
    
15. 08.        SearchRecentSuggestions suggestions=new SearchRecentSuggestions(this,
    
16. 
    
17. 09.                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
    
18. 
    
19. 10.        suggestions.saveRecentQuery(query, null);
    
20. 
    
21. 11.        if(Intent.ACTION_SEARCH.equals(intent.getAction())){
    
22. 
    
23. 12.            //获取传递的数据
    
24. 
    
25. 13.            Bundle bundled=intent.getBundleExtra(SearchManager.APP_DATA);
    
26. 
    
27. 14.            if(bundled!=null){
    
28. 
    
29. 15.                String ttdata=bundled.getString("data");
    
30. 
    
31. 16.                tvdata.setText(ttdata);
    
32. 
    
33. 17.
    
34. 
    
35. 18.            }else{
    
36. 
    
37. 19.                tvdata.setText("no data");
    
38. 
    
39. 20.            }
    
40. 
    
41. 21.        }
    
42. 
    
43. 22.    }

复制代码

相关知识：上面讲到了将最近的搜索值添加到搜索建议中，但却没有提到如果清理搜索建议中的值，与保存相似，SearchRecentSuggestion对象提供了一个clearHistory()方法

1. 01.private void clearSearchHistory() {
   
2. 
   
3. 02.        SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
   
4. 
   
5. 03.                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
   
6. 
   
7. 04.        suggestions.clearHistory();
   
8. 
   
9. 05.    }
   

复制代码