Android 搜索框 search dialog 和 search widget

时间  2019-11-13
标签 android 搜索 search dialog widget 栏目 Android 繁體版
原文   原文链接

分为search dialog和search widgethtml

区别：android

A,search dialog是一个被系统控制的UI组件。但他被用户激活的时候，它老是出如今activity的上。

B,Android系统负责处理search dialog上全部的事件，当用户提交了查询，系统会把这个查询请求传输到咱们的searchable activity，让searchable activity在处理真正的查询。当用户在输入的时候，search dialog还能提供搜索建议。

C,search widget是SearchView的一个实例，你能够把它放在你的布局的任何地方。

D,默认的，search widget和一个标准的EditText widget同样，不能作任何事情。
可是你能够配置它，让android系统处理全部的按键事件，把查询请求传输给合适的activity,能够配置它让它像search dialog同样提供search suggestions。

E,search widget在 Android 3.0或更高版本才可用. search dialog没有此项限制

##search dialog基础##git

原理：github

当用户在search dialog或search widget中执行一个搜索的时候，系统会建立一个Intent，并把查询关键字保存在里面，而后启动咱们在AndroidManifest.xml中声明好的searchable activity，并把Intent传送给它。数据库

步骤：数组

一、res/menu 目录下 建立menu资源文件 menu_main.xmlapp

<item
	android:id="@+id/menu_search"
	android:title="查询"
	app:actionViewClass="android.support.v7.widget.SearchView"
	app:showAsAction="collapseActionView|ifRoom"
	/>

二、重写onCreateOptionsMenu方法ide

[@Override](https://my.oschina.net/u/1162528)
	public boolean onCreateOptionsMenu(Menu menu) {
	
		MenuInflater menuInflater = getMenuInflater();
		menuInflater.inflate(R.menu.menu_main, menu);
		SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();
		searchView.setIconifiedByDefault(false); // 是否默认显示图标
		searchView.setSubmitButtonEnabled(false); // 是否显示提交按钮
	}

三、建立处理搜索的searchable activity布局

<activity android:name=".SearchResultsActivity" 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>

四、建立res/xml/searchable.xml资源文件ui

<searchable xmlns:android="http://schemas.android.com/apk/res/android"
			android:label="@string/app_name"
			android:hint="@string/search_hint"
			android:icon="@mipmap/icon"
	>

	</searchable>

五、onCreateOptionsMenu中增长处理代码

SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);
	// 设置处理搜索的activity
	//ComponentName componentName = getComponentName(); // 当前Activity
	ComponentName componentName = new ComponentName(this, SearchResultsActivity.class); // 指定Activity
	SearchableInfo searchableInfo = searchManager.getSearchableInfo(componentName);
	searchView.setSearchableInfo(searchableInfo);

六、在SearchResultsActivity中处理搜索

@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_search_results);

		handleIntent(getIntent());
	}

	@Override
	protected void onNewIntent(Intent intent) {
		setIntent(intent);
		handleIntent(getIntent());
	}

	private void handleIntent(Intent intent) {

		if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
			String query = intent.getStringExtra(SearchManager.QUERY);
			Log.d(TAG, query + "==");
		}
	}

##search dialog 最近搜索提示##

一、建立搜索提示的SuggestionProvider内容提供者

public class MySuggestionProvider extends SearchRecentSuggestionsProvider {

		private static final String TAG = "MySuggestionProvider";
		
		public final static String AUTHORITY = "com.df.searchview.MySuggestionProvider";
		public final static int MODE = SearchRecentSuggestionsProvider.DATABASE_MODE_QUERIES;

		public MySuggestionProvider(){
			Log.d(TAG, "=MySuggestionProvider=");
			setupSuggestions(AUTHORITY, MODE);
		}
	}

二、配置manifest

<provider
        android:name=".MySuggestionProvider"
        android:authorities="com.df.searchview.MySuggestionProvider"
        />

三、SearchResultsActivity中添加最近搜索数据

private void handleIntent(Intent intent) {

		if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
			Log.d(TAG, "=Intent.ACTION_SEARCH=");
			String query = intent.getStringExtra(SearchManager.QUERY);
			Log.d(TAG, query + "==");

			SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
					MySuggestionProvider.AUTHORITY, MySuggestionProvider.MODE);
			suggestions.saveRecentQuery(query, null);  // 保存最近的数据
		}
	}

四、配置searchable

<searchable xmlns:android="http://schemas.android.com/apk/res/android"
        android:label="@string/app_name"
        android:hint="@string/search_hint"
        android:icon="@mipmap/icon"
        android:searchSuggestAuthority="com.df.searchview.MySuggestionProvider"
        android:searchSuggestSelection=" ?"
		>

	</searchable>

五、清除查询数据

SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
    MySuggestionProvider.AUTHORITY, MySuggestionProvider.MODE);
	suggestions.clearHistory();

##search dialog 自定义Suggestions##

一、建立自定义内容提供者

public class MyCustomSuggestionProvider extends ContentProvider {
	
		private static final String TAG = "CustomSugProvider";

		public final static String AUTHORITY = "com.df.searchview.MyCustomSuggestionProvider";

		public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/suggest");

		private SuggestDao suggestDao; // 数据库访问类

		private static final UriMatcher uriMatcher = buildUriMatcher();

		private static UriMatcher buildUriMatcher() {

			UriMatcher matcher =  new UriMatcher(UriMatcher.NO_MATCH);

			// 查询
			matcher.addURI(AUTHORITY, "suggest", 0);
			matcher.addURI(AUTHORITY, "suggest/#", 1);

			// 搜索提示
			matcher.addURI(AUTHORITY, "dfoptional/" + SearchManager.SUGGEST_URI_PATH_QUERY, 0);
			matcher.addURI(AUTHORITY, "dfoptional/" + SearchManager.SUGGEST_URI_PATH_QUERY + "/*", 0);

			// 点击提示
			matcher.addURI(AUTHORITY, "item/#", 3);

			return matcher;
		}

		@Override
		public boolean onCreate() {
			suggestDao = new SuggestDao(getContext());
			return true;
		}

		/*
		* 当系统向你的Content Provider请求suggestion的时候，它将调用你的Content Provider的query()方法
		* */
		@Nullable
		@Override
		public Cursor query(@NonNull Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {

			Log.d(TAG, "uri = "+ uri);
			Log.d(TAG, "projection =" + projection +",selection =" + selection);
			//若是在searchable配置文件设置了android:searchSuggestSelection属性的话,
			// query text就以作为selectionArgs字符串数组的第一个元素的形式传过来.
			if(selectionArgs != null){
				Log.d(TAG, "selectionArgs[0]=" + selectionArgs[0] + ", sortOrder =" + sortOrder);
			}
			/*
			* 搜索提示：
			* uri = content://com.df.searchview.MyCustomSuggestionProvider/dfoptional/search_suggest_query?limit=50
			* (结构：content:// searchSuggestAuthority / searchSuggestPath / search_suggest_query )
			* projection =null,selection = ?
			* selectionArgs=呃, sortOrder =null
			*
			* 查询：
			* uri = content://com.df.searchview.MyCustomSuggestionProvider/suggest
			*
			* 提示item点击
			* uri = content://com.df.searchview.MyCustomSuggestionProvider/item/2
			*/

			String query = uri.getLastPathSegment().toLowerCase();
			Log.d(TAG, "query=" + query);

			switch (uriMatcher.match(uri)){
				case 0:
					// 查询建议列表
					return getSuggestions(selectionArgs[0]);
				case 1:
					// 获取所选单词
					return getWord(uri);
				case 3:
					// 获取所选单词
					return getWord(uri);
				default:
					throw new IllegalArgumentException("Unknown Uri: " + uri);
			}
		}

二、编辑配置文件

1) AndroidManifest.xml
	
		<!--自定义搜索提示-->
		<provider
			android:name=".MyCustomSuggestionProvider"
			android:authorities="com.df.searchview.MyCustomSuggestionProvider"
			/>
	
	2) searchable.xml
	
		<searchable xmlns:android="http://schemas.android.com/apk/res/android"
			android:label="@string/app_name"
			android:hint="@string/search_hint"
			android:icon="@mipmap/icon"
			android:searchSuggestAuthority="com.df.searchview.MyCustomSuggestionProvider"
			android:searchSuggestPath="dfoptional"
			android:searchSuggestIntentAction="android.intent.action.VIEW"
			android:searchSuggestSelection="word MATCH ?"
			android:searchSuggestIntentData="content://com.df.searchview.MyCustomSuggestionProvider/item"
			>

		</searchable>

二、在SearchResultsActivity中处理

private void handleIntent(Intent intent) {

			String intentAction = intent.getAction();
			Log.d(TAG, "=IntentAction = " + intentAction);

			if (Intent.ACTION_SEARCH.equals(intentAction)) {
				String query = intent.getStringExtra(SearchManager.QUERY);
				Log.d(TAG,  "=query=" + query);

				// 自定义搜索记录
				showResults(query);

				// 系统保存搜索记录
				//SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
				//		MySuggestionProvider.AUTHORITY, MySuggestionProvider.MODE);
				//suggestions.saveRecentQuery(query, null); // 保存最近的数据
			} else if(Intent.ACTION_VIEW.equals(intentAction)){
				// 点击搜索提示的条目
				Uri data = intent.getData();
				Intent wordIntent = new Intent(this, WordActivity.class);
				wordIntent.setData(data);
				startActivity(wordIntent);
			}
		}
		
		private void showResults(String query) {

			Log.d(TAG, "=======showResults========");

			Cursor cursor =  getContentResolver().query(MyCustomSuggestionProvider.CONTENT_URI, null, null,
					new String[] {query}, null);
			//Cursor cursor = managedQuery(MyCustomSuggestionProvider.CONTENT_URI, null, null,
			//		new String[] {query}, null);

			if (cursor == null) {
				// 没结果
				mTextView.setText(getString(R.string.no_results, new Object[] {query}));
			} else {
				// 显示结果
				int count = cursor.getCount();
				String countString = getResources().getQuantityString(R.plurals.search_results,
						count, count, query);
				mTextView.setText(countString);

				// 指定想显示的列
				String[] from = new String[] { SuggestDao.COLUMN_TEXT1, SuggestDao.COLUMN_TEXT2 };

				// 对应控件
				int[] to = new int[] { R.id.word, R.id.definition };

				// 填充数据
				SimpleCursorAdapter wordAdapter = new SimpleCursorAdapter(this, R.layout.result, cursor, from, to);
				mListView.setAdapter(wordAdapter);

				// 单击
				mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {

					@Override
					public void onItemClick(AdapterView<?> parent, View view, int position, long id) {

						Log.d(TAG, "id = " + id);
						Intent wordIntent = new Intent(getApplicationContext(), WordActivity.class);
						Uri data = Uri.withAppendedPath(MyCustomSuggestionProvider.CONTENT_URI,
								String.valueOf(id));
						wordIntent.setData(data);
						startActivity(wordIntent);
					}
				});
			}
		}

参考：

官方文档
    https://developer.android.com/guide/topics/search/search-dialog.html
    http://blog.csdn.net/hudashi/article/details/7052815（中文）

    搜索配置文件
    http://blog.csdn.net/suichukexun/article/details/7590732

    android （MD）v7.widget.SearchView的使用解析。
    https://zhuanlan.zhihu.com/p/22388833

    Android API指南(二)Search篇（待看)
    http://wangkuiwu.github.io/2014/06/17/Search/

Demo参考：

googleDemo：android-sdk\samples\android-23\legacy\SearchableDictionary
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程