android 搜索框

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

SearchManager具体使用步骤如下：

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

代码

   
   


    
    <
    
    searchable 
    
    xmlns:android
    
    =http://schemas.android.com/apk/res/android

   
   
   
   


    
     
    
    　　<!-- label为搜索框上方的文本，hint搜索框里面的提示文本，显示label -->
    android:label
    
    ="@string/search_label"
    
    
    android:hint
    
    ="@string/search_hint"
    
     
    android:searchMode
    
    ="showSearchLabelAsBadge"
    
    
    

   
   
   
   


    
    　　<!-- 语音搜索配置 -->
    android:voiceSearchMode
    
    ="showVoiceSearchButton|launchRecognizer"
    
    
    android:voiceLanguageModel
    
    ="free_form"
    
    
    android:voicePromptText
    
    ="@string/search_invoke"

   
   
   
   

    
     
   
   
   
   

    
        <!-- 配置搜索建议，配置错误将不会显示，这里的searchSuggestAuthority的值必须是
   
   
   
   

    
        继承自SearchRecentSuggestionsProvider的完整路径名 -->
   
   
   
   


    
     
    
    　　 android:searchSuggestAuthority
    
    ="com.android.cbin.SearchSuggestionSampleProvider"
    
    
    android:searchSuggestSelection
    
    =" ? "
    
    

    
    />

   
   

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

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

代码

   
   


    
    <
    
    activity 
    
    android:name
    
    ="SearchResultActivity"
    
    >
    
    
    
        
    
    <
    
    intent-filter
    
    >
    
    
            
    
    <
    
    action 
    
    android:name
    
    ="android.intent.action.SEARCH"
    
    ></
    
    action
    
    >
    
    
        
    
    </
    
    intent-filter
    
    >

   
   
 
   
   

    
    　　　　　
   
   

   
   

    
    　　　　 <!-- 指定上面的searchable.xml文件 -->
   
   

   
   


    
     
    
    　　　<meta-data android:resource="@xml/searchable"

   
   

   
   


    
     　　　　　　　　 android:name
    
    ="android.app.searchable"
    
    ></
    
    meta-data
    
    >
    
    

    
    
    
    
    </
    
    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的子类

代码

   
   


    
    public
    
     
    
    class
    
     SearchSuggestionSampleProvider 
    
    extends
    
    
        SearchRecentSuggestionsProvider {

    
    
    final
    
     
    
    static
    
     String AUTHORITY
    
    =
    
    "
    
    com.android.cbin.SearchSuggestionSampleProvider
    
    "
    
    ;
    
    
    final
    
     
    
    static
    
     
    
    int
    
     MODE
    
    =
    
    DATABASE_MODE_QUERIES;
    
    
    
    public
    
     SearchSuggestionSampleProvider(){
        
    
    super
    
    ();
        setupSuggestions(AUTHORITY, MODE);
    }
}

   
   

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

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

代码

   
   


    
       @Override
    
    
    public
    
     
    
    boolean
    
     onSearchRequested(){
        
        String text
    
    =
    
    etdata.getText().toString();
        Bundle bundle
    
    =
    
    new
    
     Bundle();
        bundle.putString(
    
    "
    
    data
    
    "
    
    , text);
        
        
    
    //
    
    打开浮动搜索框（第一个参数默认添加到搜索框的值）
        
    
    //
    
    bundle为传递的数据
    
    

    
            startSearch(
    
    "
    
    mm
    
    "
    
    , 
    
    false
    
    , bundle, 
    
    false
    
    );
        
    
    //
    
    这个地方一定要返回真 如果只是super.onSearchRequested方法
    
    不但

   
   
   
   


    
    　　　　 //onSearchRequested（搜索框默认值）无法添加到搜索框中,
    
    bundle也无法传递出去
    
    

    
            
    
    return
    
     
    
    true
    
    ;
    }

   
   

（5）接收query和bundle、保存query值（即搜索建议的列表值）

代码

   
   


    
        
    
    public
    
     
    
    void
    
     doSearchQuery(){
        
    
    final
    
     Intent intent 
    
    =
    
     getIntent();
        
    
    //
    
    获得搜索框里值
    
    

    
            String query
    
    =
    
    intent.getStringExtra(SearchManager.QUERY);
        tvquery.setText(query);
        
    
    //
    
    保存搜索记录
    
    

    
            SearchRecentSuggestions suggestions
    
    =
    
    new
    
     SearchRecentSuggestions(
    
    this
    
    ,
                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
        suggestions.saveRecentQuery(query, 
    
    null
    
    );
        
    
    if
    
    (Intent.ACTION_SEARCH.equals(intent.getAction())){
            
    
    //
    
    获取传递的数据
    
    

    
                Bundle bundled
    
    =
    
    intent.getBundleExtra(SearchManager.APP_DATA);
            
    
    if
    
    (bundled
    
    !=
    
    null
    
    ){
                String ttdata
    
    =
    
    bundled.getString(
    
    "
    
    data
    
    "
    
    );
                tvdata.setText(ttdata);

            }
    
    else
    
    {
                tvdata.setText(
    
    "
    
    no data
    
    "
    
    );
            }
        }
    }

   
   

之前说到了处理结果的Activity将可能出现的两种情况的两种，现在就处理第二种状况，就是假如invoke search bar的

Activity同时也是处理搜索结果的Activity，如果按照之前的方式处理则会出现一种情况，搜索一次就实例化一次Activity,当按返回

键的时候会发现老是同一个Activity,其实为了使它只有一个实例化对象，只需简单的配置和代码就能实现

第一:在处理搜索结果Activity的manifest.xml中添加android:launchMode="singleTop"属性

第二:重写Activity的onNewIntent(Intent intent)

代码

   
   


    
        @Override
    
    
    public
    
     
    
    void
    
     onNewIntent(Intent intent){
        
    
    super
    
    .onNewIntent(intent);
        
    
    //
    
    获得搜索框里值
    
    

    
            String query
    
    =
    
    intent.getStringExtra(SearchManager.QUERY);
        tvquery.setText(query);
        
    
    //
    
    保存搜索记录
    
    

    
            SearchRecentSuggestions suggestions
    
    =
    
    new
    
     SearchRecentSuggestions(
    
    this
    
    ,
                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
        suggestions.saveRecentQuery(query, 
    
    null
    
    );
        
    
    if
    
    (Intent.ACTION_SEARCH.equals(intent.getAction())){
            
    
    //
    
    获取传递的数据
    
    

    
                Bundle bundled
    
    =
    
    intent.getBundleExtra(SearchManager.APP_DATA);
            
    
    if
    
    (bundled
    
    !=
    
    null
    
    ){
                String ttdata
    
    =
    
    bundled.getString(
    
    "
    
    data
    
    "
    
    );
                tvdata.setText(ttdata);

            }
    
    else
    
    {
                tvdata.setText(
    
    "
    
    no data
    
    "
    
    );
            }
        }
    }

   
   

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

代码

   
   


    
        
    
    private
    
     
    
    void
    
     clearSearchHistory() {
        SearchRecentSuggestions suggestions 
    
    =
    
     
    
    new
    
     SearchRecentSuggestions(
    
    this
    
    , 
                SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
        suggestions.clearHistory();
    }

   
   

忘了上效果图：oye