手把手教你写一个搜索功能（支持模糊搜索和显示搜索历史）

作者: 码客_Yang | 来源:发表于2017-05-15 17:20 被阅读1207次

手把手教你写一个搜索功能（支持模糊搜索和显示搜索历史）
29.工具 - fzf
微信小程序搜索组件wxSearch
小程序文字搜索版
Android开源实战：一个简单 & 好用的搜索框（含历史搜索记
开发技巧分享—教你用拼音首字母快速搜索 & 函数编写增强
element UI cascader组件 filter-met
2018-08-13
你读懂小程序搜索法则了吗？优化关键词，轻松引流
Android开源实战：一个简单 & 好用的搜索框（含历

个人签名

从五一放假回来就一直在搞上线的项目，也没怎么写文章，上周五算是基本结束了。现在有时间研究其他技术，我在逛网页时，无意间看到了一个搜索功能，有点类似淘宝搜索功能。废话不多说，直奔主题。

效果截图

效果图

显示搜索历史

支持模糊搜索

点击搜索，数据插入数据库

回车键改为搜索键

使用场景

当用户开始搜索时，显示搜索历史（根据需求，可以显示所有搜索历史，也可以显示固定条数）
用户输入内容是，模糊搜索数据库内容，并实时显示
用户可以使用软键盘上的搜索键进行搜索

涉及知识点

SQLite数据库的增删改查
Scrollview嵌套ListView的冲突解决
LinearLayout的重写
修改软键盘上的回车键为搜索键
用户用软键盘搜索时，隐藏软键盘
EditText光标显示最后字符上

demo展示

代码结构

demo结构

布局结构

布局结构

代码展示

MainActivity.java

package com.yt.searchdemo;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

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

RecoedSQLiteOpenHelper.java

package com.yt.searchdemo;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

/**
 * Created by Administrator on 2017/5/8.
 */

public class RecoedSQLiteOpenHelper extends SQLiteOpenHelper {

    private static String name = "temp.db";//数据库名字
    private static Integer version = 1;//数据库版本号

    public RecoedSQLiteOpenHelper(Context context) {
        super(context, name, null, version);
    }

    @Override
    public void onCreate(SQLiteDatabase sqLiteDatabase) {
        sqLiteDatabase.execSQL("create table records(id integer primary key autoincrement,name varchar(200))");//创建表名
    }

    @Override
    public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) {

    }
}

Search_LinearLayout.java

package com.yt.searchdemo;

import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.support.annotation.Nullable;
import android.text.Editable;
import android.text.Selection;
import android.text.TextWatcher;
import android.util.AttributeSet;
import android.view.KeyEvent;
import android.view.LayoutInflater;
import android.view.View;
import android.view.inputmethod.InputMethodManager;
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.ScrollView;
import android.widget.SimpleCursorAdapter;
import android.widget.TextView;
import android.widget.Toast;

/**
 * @describe 自定义LinearLayout，整个搜索布局都在这里
 * @author yangliu
 */

public class Search_LinearLayout extends LinearLayout {

    private Context context;

    /*UI组件*/
    private TextView tv_clear;//清空搜索历史
    private EditText et_search;//搜索框
    private TextView tv_tip;//搜索提示，eg:"搜索历史"或"搜索结果"
    private ImageView iv_search;//搜索按钮
    private ScrollView scroll_showSearchResult;

    /*列表及其适配器*/
    private Search_ListView listView;
    private BaseAdapter adapter;

    /*数据库变量*/
    private RecoedSQLiteOpenHelper helper;
    private SQLiteDatabase db;

    public Search_LinearLayout(Context context) {
        super(context);
        this.context = context;
        init();
    }

    public Search_LinearLayout(Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        this.context = context;
        init();
    }

    public Search_LinearLayout(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        this.context = context;
        init();
    }

    /**
     * 初始化搜索框
     * */
    private void init(){

        //初始化UI组件
        initView();

        //实例化数据库SQLiteOpenHelper子类对象
        helper = new RecoedSQLiteOpenHelper(context);

        //第一次进入时，查询所有的历史记录
        queryData("");

        //"清空搜索历史"按钮
        tv_clear.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View view) {
                //清空数据库
                deleteData();
                queryData("");
            }
        });

        //搜索框获得焦点时，显示搜索历史
        et_search.setOnFocusChangeListener(new OnFocusChangeListener() {
            @Override
            public void onFocusChange(View view, boolean b) {
                //获得焦点，显示搜索历史
                if (b){
                    scroll_showSearchResult.setVisibility(VISIBLE);
                    queryData("");
                }else {//失去焦点，隐藏搜索历史
                    scroll_showSearchResult.setVisibility(INVISIBLE);
                }

            }
        });

        //搜索框的文本变化实时监听
        et_search.addTextChangedListener(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence charSequence, int i, int i1, int i2) {

            }

            @Override
            public void onTextChanged(CharSequence charSequence, int i, int i1, int i2) {
                //当输入框为空时，再显示搜索历史
                if (charSequence.toString().length()==0) {
                    scroll_showSearchResult.setVisibility(VISIBLE);
                }
            }

            //输入后调用的该方法
            @Override
            public void afterTextChanged(Editable editable) {
                if (editable.toString().trim().length() == 0){
                    //若搜索框为空，则模糊搜索空字符，即显示所有的搜索历史
                    tv_tip.setText("搜索历史");
                }else {
                    tv_tip.setText("搜索结果");
                }
                //每次输入后都查询数据库并显示
                //根据输入的值去模糊查询数据库中有没有数据
                String tempName = et_search.getText().toString().trim();
                queryData(tempName);
                // 输入框，输入时将光标移到最后
                int pos = editable.length();
                Selection.setSelection(editable, pos);
            }
        });

        //键盘监听事件（回车键改成搜索键）
        et_search.setOnKeyListener(new OnKeyListener() {

            @Override
            public boolean onKey(View view, int i, KeyEvent keyEvent) {

                //软键盘上的回车键，改成搜索键
                if (i == KeyEvent.KEYCODE_ENTER && keyEvent.getAction() == KeyEvent.ACTION_DOWN){
                    // 隐藏键盘，这里getCurrentFocus()需要传入Activity对象，如果实际不需要的话就不用隐藏键盘了，免得传入Activity对象，这里就先不实现了
                    ((InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE))
                            .hideSoftInputFromWindow(view.getWindowToken(),
                                    InputMethodManager.HIDE_NOT_ALWAYS);
                    //判空操作
                    if (et_search.getText().toString().trim().length()==0){
                        Toast.makeText(context,"请输入搜索内容",Toast.LENGTH_SHORT).show();
                        return false;
                    }
                //按完搜索键后，将当前查询的关键字保存起来，如果关键字已经存在，就不执行保存
                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() {
            @Override
            public void onItemClick(AdapterView<?> adapterView, View view, int i, long l) {

                TextView textView = (TextView) view.findViewById(android.R.id.text1);
                String name = textView.getText().toString();
                et_search.setText(name);
                scroll_showSearchResult.setVisibility(INVISIBLE);//选中item时，隐藏搜索历史
                Toast.makeText(context,"选择搜索"+name,Toast.LENGTH_SHORT).show();
            }
        });
//       // 插入数据，便于测试，否则第一次进入没有数据怎么测试呀？
//        Date date = new Date();
//        long time = date.getTime();
//        insertData("Leo" + time);

        //点击搜索按钮
        iv_search.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View view) {
                if (et_search.getText().toString().trim().length()==0){
                    Toast.makeText(context,"请输入搜索内容",Toast.LENGTH_SHORT).show();
                    return;
                }
                boolean hasData = hasData(et_search.getText().toString().trim());
                if (!hasData){
                    insertData(et_search.getText().toString().trim());

                    //搜索后显示数据库里所有搜索历史是为了测试
                    queryData("");
                }
                //根据输入的内容模糊查询商品，并跳转到另一个界面，这个根据需求实现
                Toast.makeText(context, "搜索"+et_search.getText(), Toast.LENGTH_SHORT).show();
            }
        });


    }



    /**
     * 查询数据库是否包含该数据
     * */
    private boolean hasData(String s) {
        //从record这个表里找到name = s的id
        Cursor cursor = helper.getReadableDatabase().rawQuery("select id as _id,name from records where name =?", new String[]{s});
        //判断是否有下一个
        return cursor.moveToNext();
    }

    /**
     * 清空数据
     * */
    private void deleteData() {
        db = helper.getWritableDatabase();
        db.execSQL("delete from records");//删除表
        db.close();
    }

    /**
     * 查询数据,并显示在ListView列表上
     * */
    private void queryData(String s) {
        //模糊搜索
        Cursor cursor = helper.getReadableDatabase().rawQuery(
                "select id as _id,name from records where name like '%" + s + "%' order by id desc",null);
//                "select id as _id from records",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 void insertData(String s) {
        db = helper.getWritableDatabase();
        db.execSQL("insert into records(name) values ('" + s + "')");
        db.close();
    }
    /**
     * 初始化组件
     * */
    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);
        scroll_showSearchResult = (ScrollView) findViewById(R.id.scrllView_search);
        scroll_showSearchResult.setVisibility(INVISIBLE);
    }

}

Search_ListView.java

package com.yt.searchdemo;

import android.content.Context;
import android.util.AttributeSet;
import android.widget.ListView;


/**
 * @describe 自定义ListView
 * @author yangliu
 * */
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适配的效果
    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        int expandSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
        super.onMeasure(widthMeasureSpec, expandSpec);
    }

}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.yt.searchdemo.MainActivity">

    <com.yt.searchdemo.Search_LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/search_layout">

    </com.yt.searchdemo.Search_LinearLayout>

</RelativeLayout>

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"
              xmlns:tools="http://schemas.android.com/tools"
              android:focusableInTouchMode="true"
              android:orientation="vertical">

    <LinearLayout
        android:layout_width="fill_parent"
        android:layout_height="50dp"
        android:background="#6888e7"
        android:orientation="horizontal"
        android:paddingRight="16dp">

        <ImageView
            android:layout_width="35dp"
            android:layout_height="35dp"
            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="40dp"
            android:layout_weight="264"
            android:background="@drawable/corners_edit_text"
            android:drawablePadding="8dp"
            android:gravity="left|center_vertical"
            android:layout_gravity="center_vertical"
            android:hint=" 输入查询的关键字"
            android:imeOptions="actionSearch"
            android:singleLine="true"
            android:textSize="16sp" />

        <ImageView
            android:layout_width="30dp"
            android:layout_height="30dp"
            android:src="@drawable/search"
            android:layout_gravity="center_vertical"
            android:layout_marginLeft="20dp"
            android:id="@+id/iv_search"/>

    </LinearLayout>


    <ScrollView
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:id="@+id/scrllView_search">

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            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"/>

                <com.yt.searchdemo.Search_ListView
                    android:id="@+id/listView"
                    android:scrollbars="none"
                    android:layout_width="match_parent"
                    
                    android:layout_height="wrap_content">

                </com.yt.searchdemo.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>

使用总结

这里使用的难点在于
1、对数据库的操作
这里操作用到的都是SQL语句，其实安卓也提供了增删改查的方法，如果你对sql语句不是很熟，用安卓提供的方法还是很不错的。更多数据库操作，请参考：Android：SQLlite数据库操作最详细解析
2、ScrollView嵌套listview滑动冲突解决
重写listview的onMesure方法，达到适配ScrollView的效果。更多解决方法请看：ListView和ScrollView的嵌套冲突解决方案
3、更改软键盘回车键为搜索键，代码中两处关键点

已经把回车键更改为搜索键

搜索操作

结尾：如果这篇文章对你有用，在收藏的同时，记得添加个关注，并留下宝贵意见。

手把手教你写一个搜索功能（支持模糊搜索和显示搜索历史）
从五一放假回来就一直在搞上线的项目，也没怎么写文章，上周五算是基本结束了。现在有时间研究其他技术，我在逛网页时，无...
29.工具 - fzf
参考模糊搜索神器fzf Github 官方wiki 功能模糊搜索神器场景搜索输入命令历史(history)...
微信小程序搜索组件wxSearch
wxSearch优雅的微信小程序搜索框一、功能支持自定义热门key支持搜索历史支持搜索建议支持搜索历史(记录)缓存...
小程序文字搜索版
注意： 1、现在搜索功能对模糊搜索的支持不算很好，请严格按照以下列表的名称进行搜索。 2、有写小程序后面还有个“+...
Android开源实战：一个简单 & 好用的搜索框（含历史搜索记
前言 Android开发中，类似下图的搜索功能非常常见搜索功能今天，我将手把手教大家实现一款封装了历史搜索记...
开发技巧分享—教你用拼音首字母快速搜索 & 函数编写增强
FileMaker 不支持中文拼音在 FileMaker 中有非常丰富的搜索功能，可以满足模糊搜索、精确搜索、多...
element UI cascader组件 filter-met
在使用 elementUI cascader 组件搜索功能时，组件默认是不支持大小写模糊搜索，需要通过自定义搜索...
2018-08-13
学习了一个微信小程序开源组件--wxSearch。功能：支持自定义热门key 支持搜索历史支持搜索建议支...
你读懂小程序搜索法则了吗？优化关键词，轻松引流
目前微信内小程序搜索，是小程序用户一大主力入口。从一开始不支持模糊搜索，到现在支持模糊搜索功能。从一开始在发...
Android开源实战：一个简单 & 好用的搜索框（含历
前言 Android开发中，类似下图的搜索功能非常常见今天，我将手把手教大家实现一款封装了历史搜索记录功能 ...