android源码解析 ---- Mms 短信息，如何使用系统浮动搜索框

1.配置search bar的相关信息，位置res/xml/searchable.xml

<searchable xmlns:android="http://schemas.android.com/apk/res/android" android:label="@string/search_label" android:hint="@string/search_hint" android:searchSettingsDescription="@string/search_setting_description" android:searchSuggestAuthority="com.android.mms.SuggestionsProvider" android:searchSuggestSelection="pattern" android:searchSuggestIntentAction="android.intent.action.SEARCH" android:includeInGlobalSearch="true" />

说明：label和hint要有，其中label默认没有显示，如果想要显示，添加：

android:searchMode ="showSearchLabelAsBadge" 一般不用。

searchSettingsDescription为搜索设置项中短信息搜索列表项的说明

searchSuggestAuthority为对应的权限声明，其值与manifest.xml中SuggestionsProvider类的android:authorities的值相同。

includeInGlobalSearch为是否包含在全局搜索中，为true时，搜索设置项可以检索到它。

2.manifest.xml搜索结果activity配置

 <activity android:name=".ui.SearchActivity"
            android:label="@string/search"
            android:configChanges="orientation|keyboardHidden" >
            <intent-filter>
                <action android:name="android.intent.action.SEARCH" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>
            <meta-data android:name="android.app.searchable"
                android:resource="@xml/searchable" />
        </activity>


说明：此activity用来显示搜索结果列表界面，继承自ListActivity。

固定配置要有。



3.是所有的应用程序都可以调用搜索键


<meta-data android:name="android.app.default_searchable"

            android:value=".ui.SearchActivity" />

其中SearchActivity为执行并显示搜索结果的activity。

4.提供搜索功能的provider
<!-- Search Suggestions Provider -->
        <provider android:name="SuggestionsProvider"
            android:readPermission="android.permission.READ_SMS"
            android:authorities="com.android.mms.SuggestionsProvider" >
            <path-permission
                    android:pathPrefix="/search_suggest_query"
                    android:readPermission="android.permission.GLOBAL_SEARCH" />
            <path-permission
                    android:pathPrefix="/search_suggest_shortcut"
                    android:readPermission="android.permission.GLOBAL_SEARCH" />
        </provider>

5.搜索键响应函数

在当前的应用程序界面，按下搜索键时，会自动调用onSearchRequested()方法，你可以重写这个方法，做你想要的操作。如果不重写，

会掉用其父类startSearch(...)

如果想在某个activity中屏蔽掉搜索框，重写

        @Override

	public boolean onSearchRequested() {

		return false;

	}即可。

或者如果你想进行一些操作

@Override

public boolean onSearchRequested() {

    doSomeThing();//some thing you want to do

   return super.onSearchRequested();

}


6.响应搜索功能
public class SearchActivity extends ListActivity{
    @Override
    public void onCreate(Bundle icicle){
        super.onCreate(icicle);
        setContentView(R.layout.search_activity);
        String searchStringParameter = getIntent().getStringExtra(SearchManager.QUERY);
        //做你自己的查询数据操作
        doMySearch(searchStringParameter);
       ...
    }
...
}

 7.自己写了个搜索结果界面，分享一下，仿照短信息写的
public class NoteSearchableActivity extends ListActivity{

	private ListView searchList;
	private TextView mTextView;
	String searchString;
	private AsyncQueryHandler mQueryHandler;
    private Uri mUri;
	
	@Override
	public void onCreate(Bundle savedInstanceState) {
	    super.onCreate(savedInstanceState);
	    setContentView(R.layout.search_activity);
	 
	    mTextView = (TextView) findViewById(android.R.id.empty);
        mTextView.setVisibility(View.GONE);
        
        searchList = getListView();
        searchList.setItemsCanFocus(true);
        searchList.setFocusable(true);
        searchList.setClickable(true);
        
        ContentResolver cr = getContentResolver();
        
	    Intent intent = getIntent();
	    if (Intent.ACTION_SEARCH.equals(intent.getAction())) {	
	      searchString = intent.getStringExtra(SearchManager.QUERY).trim();	  	     
	    }
	    
	    mQueryHandler = new AsyncQueryHandler(cr) {
            protected void onQueryComplete(int token, Object cookie, Cursor c) {
                if (c == null) {
                	mTextView.setVisibility(View.VISIBLE);
                    return;
                }
                int cursorCount = c.getCount();
                
                setTitle(getString(R.string.search_activity_title,searchString));

                if(cursorCount>=1){
                	mTextView.setVisibility(View.VISIBLE);
                }
              
                setListAdapter(new CursorAdapter(NoteSearchableActivity.this,
                        c, false /* no auto-requery */) {
                	
                    @Override
                    public void bindView(View view, Context context, Cursor cursor) {
                    	
                    	TextView noteTitle = (TextView) view.findViewById(R.id.note_list_title);
            			TextView noteData = (TextView) view.findViewById(R.id.note_list_time);            			
            		
            			noteTitle.setText(cursor.getString(3));
//            			noteData.setText(getDate(cursor.getLong(2)));
            			
                        view.setOnClickListener(new View.OnClickListener() {
                            public void onClick(View v) {
                                final Intent onClickIntent = new Intent(NoteSearchableActivity.this, EditNote.class);
//                                onClickIntent.putExtra("thread_id", threadId);
//                                onClickIntent.putExtra("highlight", searchString);
//                                onClickIntent.putExtra("select_id", rowid);
                                startActivity(onClickIntent);
                            }
                        });
                    }

                    @Override
                    public View newView(Context context, Cursor cursor, ViewGroup parent) {
                        LayoutInflater inflater = LayoutInflater.from(context);
                        View v = inflater.inflate(R.layout.note_item, parent, false);                      
                        return v;
                    }

                });              

                // Remember the query if there are actual results
//                if (cursorCount > 0) {
//                    SearchRecentSuggestions recent = ((MmsApp)getApplication()).getRecentSuggestions();
//                    if (recent != null) {
//                        recent.saveRecentQuery(
//                                searchString,
//                                getString(R.string.search_history,
//                                        cursorCount, searchString));
//                    }
//                }
            }
        };

//        mUri = NoteProvider.CONTENT_URI.buildUpon()
//        .appendQueryParameter("pattern", searchString).build();
	}
	
	@Override
	protected void onStart() {
		// TODO Auto-generated method stub
		mQueryHandler.startQuery(0, null, NoteProvider.CONTENT_URI, null, "content"+" like "+"'%"+searchString+"%'", null, null);
		super.onStart();
	}
		
}

8.构建Content Provider

  在QuickSearchBox中通过ContentResolver调用内容提供者的query(Uri, String[], String, String[], String)方法进行信息搜索，

  应用程序必须实现这个方法并且返回搜索到的Cursor对象。

        下面将对ContentProvider的query方法的参数进行说明：

         第一个参数(uri)：   

         content://authority/suggestion.path/search_suggest_query /queryStr？limit=50

         authority：对应searchable.xml文件中的android:searchSuggestAuthority属性。

         suggestion.path：对应searchable.xml文件中的android:searchSuggestPath属性。

         search_suggest_query ： 固定字符串。

         queryStr： 查询字符串。

         limit : 查询条数。

        第二个参数（projection）：一直为null。

        第三个参数（selection）：对应searchable.xml文件中android:searchSuggestSelection属性,ContentProvider的query方法将会调用SQLite数据

        库的Query方法，用这个参数组成SQL语句中where后面的条件，如：where name like ?，”name like ? ”就是selection参数的值，注意，

        android:searchSuggestSelection属性中配置的查询条件不能用“AND”或“OR”等符号连接多个条件（不能写成：“name like ? AND age like ?”）。

        第四个参数（selectionArgs）：如果searchable.xml文件中android:searchSuggestSelection属性值不为空，程序会将查询字符串做为这个数组

        的第一个元素，也是唯一的元素，在上面第三个参数中定义了查询条件，这个参数的作用是给查询条件中的问号赋值。

        第五个参数：一直为null。

        该方法将搜索到的数据以cursor对象的形式返回。