前言

像下图的搜索功能在Android开发中非常常见

今天我将手把手教大家如何实现具备历史搜索记录的搜索框

1. 使用场景

在敲下代码前，理解用户的功能使用场景是非常重要的，这样有助于我们更好地去进行功能的实现，使用场景如下：

用户需要进行某类事物的搜索（通过文字输入进行精确搜索）
在搜索框输入时，通过显示搜索历史从而降低用户二次搜索的成本

简单来说，就是输入过字段会保存，当用户再次搜索该字段时，能快速帮助用户输入

2. 功能业务流程

3. 明确功能点

功能1：关键字搜索
功能2：实时显示历史搜索记录
功能3：历史搜索记录保存
功能4：将软键盘上的”回车按钮“改为”搜索按钮“

4. 涉及到的知识点

4.1 SQLite数据库的增删改查操作

在数据库建立一个叫records的表用于存储搜索历史记录

里面只有一列name来存储历史记录

        db.execSQL("create table records(id integer primary key autoincrement,name varchar(200))");

通过插入和删除操作数据库里面的数据
通过查询操作来显示数据库里面的数据到ListView上

已搜索的关键字再次搜索不重复添加到数据库

注：对于SQLlite数据库的操作详情请看我写的文章： Android：SQLlite数据库操作最详细解析

4.2 ListView和ScrollView的嵌套冲突

问题：ListView和ScrollView一起使用会有冲突，导致ListView显示不全
解决方案：本人采用继承ListView并重写它的onMeasure()方法来解决冲突。
1. 至于两者的滑动冲突则暂时不需要处理（默认拉动ScrollView），这样用户就会感觉里面的搜索历史项和清空搜索记录项是在ListView里面一样，符合设计。
2. 更多解决方法请看：ListView和ScrollView的嵌套冲突解决方案
具体代码如下：

//解决ListView和ScrollView的冲突
public class Search_Listview extends ListView {public Search_Listview(Context context) {super(context);}//通过复写其onMeasure方法、达到对ScrollView适配的效果@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {int expandSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2,MeasureSpec.AT_MOST);super.onMeasure(widthMeasureSpec, expandSpec);}
}

4.3 监听软键盘回车按钮设置为搜索按钮

给搜索框EditText添加一个OnKeyListener监听器，重写里面的回车键，实现按下回车键搜索。

et_search.setOnKeyListener(new View.OnKeyListener() {// 输入完后按键盘上的搜索键// 修改回车键功能public boolean onKey(View v, int keyCode, KeyEvent event) {if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_DOWN) {写入搜索操作和数据库插入搜索记录操作
}});

4.4 使用TextWatcher实时筛选

给搜索框EditText添加一个TextWatcher来检测EditText里面的每个字符变化，根据变化之后的内容查询数据库得到结果。

 et_search.addTextChangedListener(new TextWatcher() {@Overridepublic void beforeTextChanged(CharSequence s, int start, int count, int after) {}@Overridepublic void onTextChanged(CharSequence s, int start, int before, int count) {}//输入有变化调用该方法@Overridepublic void afterTextChanged(Editable s) {       //设置查询数据库并显示在列表的操作    }});

5. 实例Demo

接下来，我将给出详细代码手把手教你实现具备历史搜索记录的搜索框

先下载Demo再进行阅读效果会更好：Carson的Search_Layout_Demo地址

5.1 目录结构

5.2 具体实现如下：

MainActivity.Java

作用：显示搜索框
具体代码如下：

package scut.carson_ho.search_layout;import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;public class MainActivity extends AppCompatActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);}
}

RccordSQLiteOpenHelper.java

作用：继承自SQLiteOpenHelper数据库类的子类，用于创建、管理数据库和版本控制
具体代码如下：

对于SQLlite数据库的操作详情请看我写的文章：Android：SQLlite数据库操作最详细解析

package scut.carson_ho.search_layout;import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;/*** Created by Carson_Ho on 16/11/15.*/
//SQLiteOpenHelper子类用于打开数据库并进行对用户搜索历史记录进行增删减除的操作
public class RecordSQLiteOpenHelper extends SQLiteOpenHelper {private static String name = "temp.db";private static Integer version = 1;public RecordSQLiteOpenHelper(Context context) {super(context, name, null, version);}@Overridepublic void onCreate(SQLiteDatabase db) {//打开数据库，建立了一个叫records的表，里面只有一列name来存储历史记录：db.execSQL("create table records(id integer primary key autoincrement,name varchar(200))");}@Overridepublic void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {}}

Search_ListView.java

作用：用于解决ListView和ScrollView的嵌套冲突
具体代码如下：

package scut.carson_ho.search_layout;import android.content.Context;
import android.util.AttributeSet;
import android.widget.ListView;/*** Created by Carson_Ho on 16/11/15.*/
//解决ListView和ScrollView的冲突
public class Search_Listview extends ListView {public Search_Listview(Context context) {super(context);}public Search_Listview(Context context, AttributeSet attrs) {super(context, attrs);}public Search_Listview(Context context, AttributeSet attrs, int defStyle) {super(context, attrs, defStyle);}//通过复写其onMeasure方法、达到对ScrollView适配的效果@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {int expandSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2,MeasureSpec.AT_MOST);super.onMeasure(widthMeasureSpec, expandSpec);}}

Search_View.java

作用：用于封装搜索框功能的所有操作（涵盖历史搜索记录的插入、删除、查询和显示）
具体代码如下：

package scut.carson_ho.search_layout;import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.text.Editable;
import android.text.TextWatcher;
import android.util.AttributeSet;
import android.view.KeyEvent;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.AdapterView;
import android.widget.BaseAdapter;
import android.widget.CursorAdapter;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.SimpleCursorAdapter;
import android.widget.TextView;
import android.widget.Toast;/*** Created by Carson_Ho on 16/11/15.*/
public class Search_View extends LinearLayout {private Context context;/*UI组件*/private TextView tv_clear;private EditText et_search;private TextView tv_tip;private ImageView iv_search;/*列表及其适配器*/private Search_Listview listView;private BaseAdapter adapter;/*数据库变量*/private RecordSQLiteOpenHelper helper ;private SQLiteDatabase db;/*三个构造函数*///在构造函数里直接对搜索框进行初始化 - init()public Search_View(Context context) {super(context);this.context = context;init();}public Search_View(Context context, AttributeSet attrs) {super(context, attrs);this.context = context;init();}public Search_View(Context context, AttributeSet attrs, int defStyleAttr) {super(context, attrs, defStyleAttr);this.context = context;init();}/*初始化搜索框*/private void init(){//初始化UI组件initView();//实例化数据库SQLiteOpenHelper子类对象helper = new RecordSQLiteOpenHelper(context);// 第一次进入时查询所有的历史记录queryData("");//"清空搜索历史"按钮tv_clear.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {//清空数据库deleteData();queryData("");}});//搜索框的文本变化实时监听et_search.addTextChangedListener(new TextWatcher() {@Overridepublic void beforeTextChanged(CharSequence s, int start, int count, int after) {}@Overridepublic void onTextChanged(CharSequence s, int start, int before, int count) {}//输入后调用该方法@Overridepublic void afterTextChanged(Editable s) {if (s.toString().trim().length() == 0) {//若搜索框为空,则模糊搜索空字符,即显示所有的搜索历史tv_tip.setText("搜索历史");} else {tv_tip.setText("搜索结果");}//每次输入后都查询数据库并显示//根据输入的值去模糊查询数据库中有没有数据String tempName = et_search.getText().toString();queryData(tempName);}});// 搜索框的键盘搜索键// 点击回调et_search.setOnKeyListener(new View.OnKeyListener() {// 输入完后按键盘上的搜索键// 修改回车键功能public boolean onKey(View v, int keyCode, KeyEvent event) {if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_DOWN) {// 隐藏键盘，这里getCurrentFocus()需要传入Activity对象，如果实际不需要的话就不用隐藏键盘了，免得传入Activity对象，这里就先不实现了
//                    ((InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE)).hideSoftInputFromWindow(
//                            getCurrentFocus().getWindowToken(), InputMethodManager.HIDE_NOT_ALWAYS);// 按完搜索键后将当前查询的关键字保存起来,如果该关键字已经存在就不执行保存boolean hasData = hasData(et_search.getText().toString().trim());if (!hasData) {insertData(et_search.getText().toString().trim());queryData("");}//根据输入的内容模糊查询商品，并跳转到另一个界面，这个需要根据需求实现Toast.makeText(context, "点击搜索", Toast.LENGTH_SHORT).show();}return false;}});//列表监听//即当用户点击搜索历史里的字段后,会直接将结果当作搜索字段进行搜索listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {@Overridepublic void onItemClick(AdapterView<?> parent, View view, int position, long id) {//获取到用户点击列表里的文字,并自动填充到搜索框内TextView textView = (TextView) view.findViewById(android.R.id.text1);String name = textView.getText().toString();et_search.setText(name);Toast.makeText(context, name, Toast.LENGTH_SHORT).show();}});//点击搜索按钮后的事件iv_search.setOnClickListener(new OnClickListener() {@Overridepublic void onClick(View v) {boolean hasData = hasData(et_search.getText().toString().trim());if (!hasData) {insertData(et_search.getText().toString().trim());//搜索后显示数据库里所有搜索历史是为了测试queryData("");}//根据输入的内容模糊查询商品，并跳转到另一个界面，这个根据需求实现Toast.makeText(context, "clicked!", Toast.LENGTH_SHORT).show();}});}/*** 封装的函数*//*初始化组件*/private void initView(){LayoutInflater.from(context).inflate(R.layout.search_layout,this);et_search = (EditText) findViewById(R.id.et_search);tv_clear = (TextView) findViewById(R.id.tv_clear);tv_tip = (TextView) findViewById(R.id.tv_tip);listView = (Search_Listview) findViewById(R.id.listView);iv_search = (ImageView) findViewById(R.id.iv_search);}/*插入数据*/private void insertData(String tempName) {db = helper.getWritableDatabase();db.execSQL("insert into records(name) values('" + tempName + "')");db.close();}/*模糊查询数据 并显示在ListView列表上*/private void queryData(String tempName) {//模糊搜索Cursor cursor = helper.getReadableDatabase().rawQuery("select id as _id,name from records where name like '%" + tempName + "%' order by id desc ", null);// 创建adapter适配器对象,装入模糊搜索的结果adapter = new SimpleCursorAdapter(context, android.R.layout.simple_list_item_1, cursor, new String[] { "name" },new int[] { android.R.id.text1 }, CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER);// 设置适配器listView.setAdapter(adapter);adapter.notifyDataSetChanged();}/*检查数据库中是否已经有该条记录*/private boolean hasData(String tempName) {//从Record这个表里找到name=tempName的idCursor cursor = helper.getReadableDatabase().rawQuery("select id as _id,name from records where name =?", new String[]{tempName});//判断是否有下一个return cursor.moveToNext();}/*清空数据*/private void deleteData() {db = helper.getWritableDatabase();db.execSQL("delete from records");db.close();}
}

search_layout.xml

作用：搜索框的布局
具体代码如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"android:focusableInTouchMode="true"android:orientation="vertical"><LinearLayout
        android:layout_width="fill_parent"android:layout_height="50dp"android:background="#E54141"android:orientation="horizontal"android:paddingRight="16dp"><ImageView
            android:layout_width="45dp"android:layout_height="45dp"android:layout_gravity="center_vertical"android:padding="10dp"android:src="@drawable/back" /><EditText
            android:id="@+id/et_search"android:layout_width="0dp"android:layout_height="fill_parent"android:layout_weight="264"android:background="@null"android:drawablePadding="8dp"android:gravity="start|center_vertical"android:hint="输入查询的关键字"android:imeOptions="actionSearch"android:singleLine="true"android:textColor="@android:color/white"android:textSize="16sp" /><ImageView
            android:layout_width="wrap_content"android:layout_height="wrap_content"android:src="@drawable/search"android:layout_gravity="center_vertical"android:id="@+id/iv_search"/></LinearLayout><ScrollView
        android:layout_width="wrap_content"android:layout_height="wrap_content"><LinearLayout
            android:layout_width="match_parent"android:layout_height="wrap_content"android:orientation="vertical"><LinearLayout
                android:layout_width="match_parent"android:layout_height="wrap_content"android:orientation="vertical"android:paddingLeft="20dp"><TextView
                    android:id="@+id/tv_tip"android:layout_width="match_parent"android:layout_height="50dp"android:gravity="left|center_vertical"android:text="搜索历史" /><View
                    android:layout_width="match_parent"android:layout_height="1dp"android:background="#EEEEEE"/><scut.carson_ho.search_layout.Search_Listview
                    android:id="@+id/listView"android:layout_width="match_parent"android:layout_height="wrap_content"></scut.carson_ho.search_layout.Search_Listview></LinearLayout><View
                android:layout_width="match_parent"android:layout_height="1dp"android:background="#EEEEEE"/><TextView
                android:id="@+id/tv_clear"android:layout_width="match_parent"android:layout_height="40dp"android:background="#F6F6F6"android:gravity="center"android:text="清除搜索历史" /><View
                android:layout_width="match_parent"android:layout_height="1dp"android:layout_marginBottom="20dp"android:background="#EEEEEE"/></LinearLayout></ScrollView>
</LinearLayout>

activity_main.xml

作用：显示搜索框
具体代码如下：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"android:paddingBottom="@dimen/activity_vertical_margin"android:paddingLeft="@dimen/activity_horizontal_margin"android:paddingRight="@dimen/activity_horizontal_margin"android:paddingTop="@dimen/activity_vertical_margin"tools:context="scut.carson_ho.search_layout.MainActivity"><scut.carson_ho.search_layout.Search_View
        android:layout_width="match_parent"android:layout_height="wrap_content"android:id="@+id/search_layout"/>
</RelativeLayout>

5.3 测试结果

5.4 Demo地址

Carson的Github地址：Search_Layout_Demo

实现搜索框（含历史搜索记录）相关推荐

position：搜索框显示历史浏览记录
absolute 生成绝对定位的元素,相对于 static 定位以外的第一个父元素进行定位. 元素的位置通过 "left", "top", "righ ...
有历史搜索记录的搜索框（百度搜索案例）
带有历史搜索词条的搜索框记录一下带有历史搜索词条的搜索框,具体效果类似百度搜索: 点击搜索框展示历史搜索词条列表: 点击搜索框以外的区域隐藏历史搜索词条列表: 点击删除除去对应词条. 效果图: ...
Android开源实战：简单好用、含历史搜索记录的智能搜索框
前言 Android开发中,类似下图的搜索功能非常常见今天,我将带来一款封装了历史搜索记录功能 & 样式的Android 自定义搜索框开源库,希望你们会喜欢. 已在Github开源: ...
Android开源实战：SearchView搜索框（含历史搜索记录）
前言 Android开发中,类似下图的搜索功能非常常见搜索功能今天,我将手把手教大家实现一款封装了历史搜索记录功能 & 样式的Android 自定义搜索框开源库,希望你们会喜欢. ...
Android常用：手把手教你实现搜索框（含历史搜索记录）
http://blog.csdn.net/carson_ho/article/details/53366570 前言像下图的搜索功能在Android开发中非常常见今天我将手把手教大家如何实现具备历 ...
Android 系统搜索框（有浏览记录）
实现Android 系统搜索框(有浏览记录),先看下效果: 一.配置搜索描述文件要在res中的xml文件加创建sreachable.xml,内容如下: <?xml version=" ...
百度搜索结果的URL参数搜索框提示词搜索方式(rsv_sug2)
通过百度搜索框提示,看到可能想找的关键词之后,百度提供了2种方式供选择,并且用参数 rsv_sug2 记录了用户的选择. 百度搜索结果网址参数搜索框提示词搜索方式(rsv_sug2) 名称 rsv_ ...
百度搜索引擎结果网址参数搜索框提示词搜索方式(rsv_sug2)
通过百度搜索框提示,看到可能想找的关键词之后,百度提供了2种方式供选择,并且用参数 rsv_sug2 记录了用户的选择. [b]百度搜索结果网址参数搜索框提示词搜索方式(rsv_sug2)[/b] ...
百度搜索结果页面的参数搜索框提示词搜索方式(rsv_sug2)
通过百度搜索框提示,看到可能想找的关键词之后,百度提供了2种方式供选择,并且用参数 rsv_sug2 记录了用户的选择. 百度搜索结果网址参数搜索框提示词搜索方式(rsv_sug2) 名称 rsv_ ...
如何清除搜索框内的搜索历史记录？
如何清除搜索框内的搜索历史记录? 答:这是网页浏览器的一项功能.进入IE浏览器的相关菜单选项设置: ·如果您使用IE4.0浏览器,则由"查看→internet选项→内容→自动完成→清除表单→ ...

实现搜索框（含历史搜索记录）

前言

目录