ShelockActionBar的SearchView的学习

效果展示。search的suggest展示



点击键盘右下角的搜索 进入搜索结果界面展示：



首先我们定义了BaseActivity用于search 就是图1展示suggestion的

package com.mengqi.base.ui;

import android.app.SearchManager;
import android.content.Context;
import android.os.Bundle;

import com.actionbarsherlock.app.SherlockFragmentActivity;
import com.actionbarsherlock.view.Menu;
import com.actionbarsherlock.widget.SearchView;
import com.actionbarsherlock.widget.SearchView.OnQueryTextListener;
import com.mengqi.base.R;

public class BaseActivity extends SherlockFragmentActivity implements OnQueryTextListener
{

@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);

setContentView(R.layout.base_frame_left);
}

//			如果要正常搜索必须返回false。如果返回true那么就不执行搜索。
//			看searchView的源码。只有这个监听器为空或者onQueryTextSubmit返回false才执行下面的
//			if (mOnQueryChangeListener == null
//	                || !mOnQueryChangeListener.onQueryTextSubmit(query.toString())) {
//	            if (mSearchable != null) {
//	                launchQuerySearch(KeyEvent.KEYCODE_UNKNOWN, null, query.toString());  搜索跳转
//	                setImeVisibility(false);
//	            }
//	            dismissSuggestions();
//	        }
@Override
public boolean onQueryTextSubmit(String query)
{
return false;
}

//	这个返回什么都没有影响
@Override
public boolean onQueryTextChange(String newText)
{
return false;
}

@Override
public boolean onCreateOptionsMenu(Menu menu)
{
menu.add(0, R.id.menu_settings, 12, R.string.settings);

getSupportMenuInflater().inflate(R.menu.search, menu);

SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);
SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();
//        这个SearchableInfo 是在AndroidManifest.xml进行初始化的
searchView.setSearchableInfo(searchManager.getSearchableInfo(getComponentName()));
searchView.setQueryHint(getString(R.string.search_hint));
//        searchView.setOnQueryTextListener(this); 这个按照需求要不要处理。如果设置请注意onQueryTextSubmit返回false
return super.onCreateOptionsMenu(menu);
}
}

menu的xml文件 menu_search

<?xml version="1.0" encoding="utf-8"?>
<menu
xmlns:android="http://schemas.android.com/apk/res/android">
<item android:icon="@drawable/ic_action_search"
android:id="@id/menu_search"
android:orderInCategory="10"
android:title="@string/search"
android:actionViewClass="com.actionbarsherlock.widget.SearchView"
android:showAsAction="ifRoom|collapseActionView" />
</menu>

这个时候界面上ActionBar有了searchView的界面展示但是不能搜索，因为还没有配置SearchableInfo
所以res/xml/searchable.xml 新建

<?xml version="1.0" encoding="utf-8"?>
<searchable android:label="@string/app_name" android:hint="@string/search_hint"
android:searchSuggestAuthority="com.mengqi.base.provider"
android:searchSuggestPath="newsearch" android:searchSuggestSelection="like ?"
android:searchSuggestIntentAction="com.mengqi.base.view"
android:voiceSearchMode="showVoiceSearchButton|launchRecognizer"
android:searchSuggestThreshold="2" android:includeInGlobalSearch="true"
xmlns:android="http://schemas.android.com/apk/res/android" />

这个设置要了解过contentProvider的人才会熟悉。如果不会先去补补吧，，，，，

contentprovider是通过uri进行数据查找的。

uri包含 scheme+authority+path 对应这个里面searchSuggest的相关配置。

如果searchSuggestSelection像上面设置。并且搜索‘187’ ，那么suggest发起的请求uri就是：（可以在自定义的contentProvider的query方法进行打印）

content://com.mengqi.base.provider/newsearch/search_suggest_query?limit=50 并且selectionArgs[0] 的值就是 187

如果没有设置searchSuggestSelection。一样搜索'187'，那么suggest发起的uri就是:

content://com.mengqi.base.provider/newsearch/search_suggest_query/187?limit=50并且selectionArgs为null

searchSuggestThreshold表示suggest展示需要最小位数，这我设置的是2.那么我只搜索‘1’那么不会显示。搜索‘18’才开始有显示。（要显示必须是suggest的查询有数据可以返回哈）。

searchSuggestIntentAction 表示展示的suggest的item点击 点击触发一个intent，这个intent的action就是在这设置。

具体这个跳转后面还有详细讲到。

searchableInfo还有配置完成。还要到AndroidManifest.xml继续设置。

<activity android:name="com.mengqi.base.ui.search.SearchActivity"
android:launchMode="singleTop" >
<intent-filter>
<action android:name="android.intent.action.SEARCH" />
</intent-filter>
<meta-data android:name="android.app.searchable"
android:resource="@xml/searchable"/>
</activity>
<meta-data android:name="android.app.default_searchable"
android:value="com.mengqi.base.ui.search.SearchActivity" />

其中searchActivity就是search的结果展示界面。就是点击键盘右下角的搜索键跳转的界面。

/**
* CopyRight	2014 ZhuYan
*	@author Zhu Yan
*
*	All right reserved
*
*	Created	on	2014-2-20  下午2:59:04
*/
package com.mengqi.base.ui.search;

import android.app.SearchManager;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.support.v4.app.LoaderManager.LoaderCallbacks;
import android.support.v4.content.Loader;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;

import com.actionbarsherlock.app.SherlockFragmentActivity;
import com.actionbarsherlock.view.Menu;
import com.actionbarsherlock.view.MenuItem;
import com.actionbarsherlock.widget.SearchView;
import com.mengqi.base.R;
import com.mengqi.base.adapter.SearchAdapter;

/**
* @author Zhu Yan
*
* Created	on	2014-2-20  下午2:59:04
*/
public class SearchActivity extends SherlockFragmentActivity implements LoaderCallbacks<Cursor>,OnItemClickListener
{
private final static String TAG = "SearchActivity";

private final static String ACTION_VIEW = "com.mengqi.base.view";

private SearchAdapter adapter;
private ListView listView;

private String query = null;

/**
* @return the query
*/
public String getQuery()
{
return query;
}

@Override
protected void onCreate(Bundle arg0)
{
super.onCreate(arg0);

// get and process search query here
if(!handlerIntent(getIntent())){
finish();
return;
}

getSupportActionBar().setDisplayHomeAsUpEnabled(true);
setContentView(R.layout.fragment_empty_list);

listView = (ListView) findViewById(android.R.id.list);
//虽然我的search结果界面的 跟Suggest的item ui很想但是。这个adpter跟suggest没有关系。我是模仿suggest写的ui
adapter = new SearchAdapter(this);
listView.setAdapter(adapter);
listView.setOnItemClickListener(this);
}

/**
*
* @param intent
* @return  如果是suggest的item点击跳转那么返回false，是展示搜索结果 返回true
*/
private boolean handlerIntent(Intent intent)
{
final String queryAction = intent.getAction();
if (Intent.ACTION_SEARCH.equals(queryAction)) {
//            doSearchQuery(queryIntent, "onCreate()");
query = intent.getStringExtra(SearchManager.QUERY);
System.out.println( "handlerIntent " +query);
getSupportLoaderManager().restartLoader(0, null, this);
return true;
}else {
System.out.println(queryAction);
System.out.println("data:"+intent.getDataString());
redirectToActivity(intent.getDataString());
return false;
}
}

/**
* @param dataString
*/
private void redirectToActivity(String data)
{
//根据传入的data做出不同的跳转。data来自query查询
}

@Override
protected void onNewIntent(Intent intent)
{
// get and process search query here
handlerIntent(intent);
super.onNewIntent(intent);
}

//我的searchActivity的actionbar一样有searchview控件
@Override
public boolean onCreateOptionsMenu(Menu menu)
{
getSupportMenuInflater().inflate(R.menu.search, menu);
SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);
SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();
searchView.setSearchableInfo(searchManager.getSearchableInfo(getComponentName()));
searchView.setQueryHint(getString(R.string.search_hint));
return super.onCreateOptionsMenu(menu);
}

@Override
public boolean onOptionsItemSelected(MenuItem item)
{
switch (item.getItemId()) {
//	        case R.id.menu_search:
//	        	System.out.println( "click search");
//	            onSearchRequested();
//	            return true;
case android.R.id.home:
finish();
return true;
}
return super.onOptionsItemSelected(item);
}

@Override
public Loader<Cursor> onCreateLoader(int id, Bundle arg1)
{
//		System.out.println( "create loader()");
if(id == 0){
return new SearchLoader(SearchActivity.this);
}
return null;
}

@Override
public void onLoadFinished(Loader<Cursor> arg0, Cursor cursor)
{
//		System.out.println( "no loader finished()");
adapter.changeCursor(cursor);
}

//主要是销毁 activity的时候 关闭cursor
@Override
protected void onDestroy()
{
if(adapter != null){
adapter.changeCursor(null);
}
super.onDestroy();
}

@Override
public void onLoaderReset(Loader<Cursor> loader)
{
loader.reset();
}

@Override
public void onItemClick(AdapterView<?> parent, View view, int position,
long id)
{
Object object = adapter.getItem(position);
if(object != null && object instanceof Cursor){
Cursor cursor = (Cursor) object;
//我的search查询和suggest的返回的数据一样。后面有讲到suggest查询的数据返回
redirectToActivity(cursor.getString(cursor
.getColumnIndexOrThrow(SearchManager.SUGGEST_COLUMN_INTENT_DATA)));
}
}

}

好了现在就是配置suggest的数据模型。suggest因为adapter都是系统提供的。所以我们给suggest查询返回的cursor必须是固定数据格式的。

private final static String[] SearchQuery = new String[]{BaseColumns._ID,
SearchManager.SUGGEST_COLUMN_TEXT_1,SearchManager.SUGGEST_COLUMN_TEXT_2,
SearchManager.SUGGEST_COLUMN_ICON_1,SearchManager.SUGGEST_COLUMN_INTENT_DATA};

这就是我的suggest查询的数据库表项。

_id是必须要的。而且每一项都不一样。

SearchManager.SUGGEST_COLUMN_TEXT_1,是指suggest显示的item的标题。SearchManager.SUGGEST_COLUMN_TEXT_2是副标题。

SearchManager.SUGGEST_COLUMN_ICON_1是指显示的ICON 这个值可以是R.drawable的id值。或者是资源文件的URI。

SearchManager.SUGGEST_COLUMN_INTENT_DATA 是值我们点击suggest的item时候 产生一个intent。intent的action就是在searchable.xml设置的。

intent携带的数据就是这个表象的值。这个值通过intent.getDataString();获取。点击suggest的item产生的item会传递到searchActivity进行处理。

所以在SearchActivity中我有handlerIntent()方法对点击suggest的item或者是点击search进行区分处理。

如果你是要对suggest查询的数据库表没有刚才的 表项可以用别名查询。简单举例:select id as _id,name as suggest_text_1 from .....

如果你是多张表查询让后放到suggest中。我这边想到的是查询表 然后得到cursor 然后读取cursor的数据放到MatrixCursor中。反复操作。最后返回MatrixCursor。

SearchActivity还用到了Loader 看不明白就去查询一下吧。

这个是官网的SearchView讲解，比我说的详细。

http://developer.android.com/guide/topics/search/adding-custom-suggestions.html