6. 功能详细设计

下面将给出详细的功能逻辑

6.1 关键字搜索

描述：根据用户输入的搜索字段进行结果搜索
原型图

注：关键字搜索功能是因人而异的，所以本源码仅留出接口供开发者实现，不作具体实现

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YEaskzAt-1651121171314)(https://user-gold-cdn.xitu.io/2018/1/29/1613f6d25f1d1440?imageView2/0/w/1280/h/960/ignore-error/1)]

源码分析

分析1：EditText_Clear.java

作用：自定义EdiText，与系统自带的EdiText对比：多了左侧图片 & 右侧图片设置、一键清空EdiText内容功能
具体代码如下：

public class EditText_Clear extends android.support.v7.widget.AppCompatEditText {
/**

步骤1：定义左侧搜索图标 & 一键删除图标
*/
private Drawable clearDrawable,searchDrawable;

public EditText_Clear(Context context) {
super(context);
init();
// 初始化该组件时，对EditText_Clear进行初始化 ->>步骤2
}

public EditText_Clear(Context context, AttributeSet attrs) {
super(context, attrs);
init();
}

public EditText_Clear(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
init();
}

/**

步骤2：初始化图标资源
*/
private void init() {
clearDrawable = getResources().getDrawable(R.drawable.delete);
searchDrawable = getResources().getDrawable(R.drawable.search);

setCompoundDrawablesWithIntrinsicBounds(searchDrawable, null,
null, null);
// setCompoundDrawablesWithIntrinsicBounds(Drawable left, Drawable top, Drawable right, Drawable bottom)介绍
// 作用：在EditText上、下、左、右设置图标（相当于android:drawableLeft=“” android:drawableRight=“”）
// 注1：setCompoundDrawablesWithIntrinsicBounds（）传入的Drawable的宽高=固有宽高（自动通过getIntrinsicWidth（）& getIntrinsicHeight（）获取）
// 注2：若不想在某个地方显示，则设置为null
// 此处设置了左侧搜索图标

// 另外一个相似的方法：setCompoundDrawables(Drawable left, Drawable top, Drawable right, Drawable bottom)介绍
// 与setCompoundDrawablesWithIntrinsicBounds（）的区别：可设置图标大小
// 传入的Drawable对象必须已经setBounds(x,y,width,height)，即必须设置过初始位置、宽和高等信息
// x:组件在容器X轴上的起点 y:组件在容器Y轴上的起点 width:组件的长度 height:组件的高度
}

/**

步骤3：通过监听复写EditText本身的方法来确定是否显示删除图标
监听方法：onTextChanged（） & onFocusChanged（）
调用时刻：当输入框内容变化时 & 焦点发生变化时
*/

@Override
protected void onTextChanged(CharSequence text, int start, int lengthBefore, int lengthAfter) {
super.onTextChanged(text, start, lengthBefore, lengthAfter);
setClearIconVisible(hasFocus() && text.length() > 0);
// hasFocus()返回是否获得EditTEXT的焦点，即是否选中
// setClearIconVisible（） = 根据传入的是否选中 & 是否有输入来判断是否显示删除图标->>关注1
}

@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
super.onFocusChanged(focused, direction, previouslyFocusedRect);
setClearIconVisible(focused && length() > 0);
// focused = 是否获得焦点
// 同样根据setClearIconVisible（）判断是否要显示删除图标
}

/**

关注1
作用：判断是否显示删除图标
*/
private void setClearIconVisible(boolean visible) {
setCompoundDrawablesWithIntrinsicBounds(searchDrawable, null,
visible ? clearDrawable : null, null);
}

/**

步骤4：对删除图标区域设置点击事件，即"点击 = 清空搜索框内容"
原理：当手指抬起的位置在删除图标的区域，即视为点击了删除图标 = 清空搜索框内容
*/
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
// 原理：当手指抬起的位置在删除图标的区域，即视为点击了删除图标 = 清空搜索框内容
case MotionEvent.ACTION_UP:
Drawable drawable = clearDrawable;
if (drawable != null && event.getX() <= (getWidth() - getPaddingRight())
&& event.getX() >= (getWidth() - getPaddingRight() - drawable.getBounds().width())) {
setText(“”);
}
// 判断条件说明
// event.getX() ：抬起时的位置坐标
// getWidth()：控件的宽度
// getPaddingRight():删除图标图标右边缘至EditText控件右边缘的距离
// 即：getWidth() - getPaddingRight() = 删除图标的右边缘坐标 = X1
// getWidth() - getPaddingRight() - drawable.getBounds().width() = 删除图标左边缘的坐标 = X2
// 所以X1与X2之间的区域 = 删除图标的区域
// 当手指抬起的位置在删除图标的区域（X2=<event.getX() <=X1），即视为点击了删除图标 = 清空搜索框内容
// 具体示意图请看下图
break;
}
return super.onTouchEvent(event);
}

}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4YCO2kvL-1651121171315)(https://user-gold-cdn.xitu.io/2018/1/29/1613f6d27bc4db3c?imageView2/0/w/1280/h/960/ignore-error/1)]

对于含有一键清空功能 & 更多自定义样式的EditText自定义控件具体请看我的另外一个简单 & 好用的开源组件：[Android自定义EditText：手把手教你做一款含一键删除&自定义样式的SuperEditText](()

分析2：SearchListView.java

作用：解决 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适配的效果
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
int expandSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2,
MeasureSpec.AT_MOST);
super.onMeasure(widthMeasureSpec, expandSpec);
}

}

分析3： search_layout.xml

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

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout
android:id=“@+id/search_block”
android:layout_width=“match_parent”
android:layout_height=“10dp”
android:orientation=“horizontal”
android:paddingRight=“10dp”

// 返回按钮

// 搜索框（采用上面写的自定义EditText
<scut.carson_ho.searchview.EditText_Clear
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:imeOptions=“actionSearch”
android:singleLine=“true”
// 最后2行 = 更换输入键盘按钮：换行 ->>搜索
/>

// 下方搜索记录布局 = ScrollView+Listview

// Listview布局（采用上述讲解的SearchListView，解决了与ScrollView的冲突）
<scut.carson_ho.searchview.SearchListView
android:id=“@+id/listView”
android:layout_width=“match_parent”
android:layout_height=“wrap_content”>

</scut.carson_ho.searchview.SearchListView>

分析4：ICallBack.java、bCallBack.java

作用：搜索按键、返回按键回调接口
具体代码如下：

/**

ICallBack.java
*/
public interface ICallBack {
void SearchAciton(String string);

}

/**

bCallBack.java
*/
public interface bCallBack {
void BackAciton();
}

分析5：SearchView.java

作用：涵盖搜索框中所有功能，此处主要讲解关键字搜索功能实现
具体代码如下：

/**

步骤1：初始化成员变量
*/

// 搜索框组件
private EditText et_search; // 搜索按键
private LinearLayout search_block; // 搜索框布局
private ImageView searchBack; // 返回按键

// 回调接口
private ICallBack mCallBack;// 搜索按键回调接口
private bCallBack bCallBack; // 返回按键回调接口

// ListView列表 & 适配器
private SearchListView listView;
private BaseAdapter adapter;

/**

步骤2：绑定搜索框组件
*/

private void initView(){

// 1. 绑定R.layout.search_layout作为搜索框的xml文件
LayoutInflater.from(context).inflate(R.layout.search_layout,this);

// 2. 绑定搜索框EditText
et_search = (EditText) findViewById(R.id.et_search);

// 3. 搜索框背景颜色
search_block = (LinearLayout)findViewById(R.id.search_block);

// 4. 历史搜索记录 = ListView显示
listView = (Search_Listview) findViewById(R.id.listView);

// 5. 删除历史搜索记录按钮
tv_clear = (TextView) findViewById(R.id.tv_clear);
tv_clear.setVisibility(INVISIBLE); // 初始状态 = 不可见

}

/**

步骤3
监听输入键盘更换后的搜索按键
调用时刻：点击键盘上的搜索键时
*/
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) {

// 点击搜索按键后，根据输入的搜索字段进行查询
// 注：由于此处需求会根据自身情况不同而不同，所以具体逻辑由开发者自己实现，此处仅留出接口
if (!(mCallBack == null)){
mCallBack.SearchAciton(et_search.getText().toString());
}
Toast.makeText(context, “需要搜索的是” + et_search.getText(), Toast.LENGTH_SHORT).show();

}
return false;
}
});

/**

步骤4：回调接口
*/

// 搜索按键回调接口
public interface ICallBack {
void SearchAciton(String string);
}

// 返回按键接口回调
public void setOnClickBack(bCallBack bCallBack){
this.bCallBack = bCallBack;

}

6.2 实时显示历史搜索记录

描述：包括最近搜索记录 & 相似搜索记录
原型图

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Dt4sEUXh-1651121171316)(https://user-gold-cdn.xitu.io/2018/1/29/1613f6d27d11623a?imageView2/0/w/1280/h/960/ignore-error/1)]

源码分析

分析1：RccordSQLiteOpenHelper.java

作用：创建、管理数据库 & 版本控制

该数据库用于存储用户的搜索历史记录

具体代码如下：

对于Android SQLlite数据库的操作请看文章：[Android：SQLlite数据库操作最详细解析](()

// 继承自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);
}

@Override
public void onCreate(SQLiteDatabase db) {
// 打开数据库 & 建立一个名为records的表，里面只有一列name来存储历史记录：
db.execSQL(“create table records(id integer primary key autoincrement,name varchar(200))”);
}

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}

分析2：SearchView.java

作用：涵盖搜索框中所有功能，此处主要讲解实时显示历史搜索记录功能实现
具体代码如下：

/**

步骤1：初始化变量
*/
// 用于存放历史搜索记录
private RecordSQLiteOpenHelper helper ;
private SQLiteDatabase db;

// ListView列表 & 适配器
private SearchListView listView;
listView = (SearchListView) findViewById(R.id.listView);
private BaseAdapter adapter;

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

/**

步骤2：搜索框的文本变化实时监听
*/
et_search.addTextChangedListener(new TextWatcher() {
@Override
public void beforeTextChanged(CharSequence s, int start, int count, int after) {

}

@Override
public void onTextChanged(CharSequence s, int start, int before, int count) {

}

// 输入文本后调用该方法
@Override
public void afterTextChanged(Editable s) {
// 每次输入后，模糊查询数据库 & 实时显示历史搜索记录
// 注：若搜索框为空,则模糊搜索空字符 = 显示所有的搜索历史
String tempName = et_search.getText().toString();
queryData(tempName); // ->>关注1

}
});

/**

步骤3：搜索记录列表（ListView）监听
即当用户点击搜索历史里的字段后,会直接将结果当作搜索字段进行搜索
*/
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {

// 获取用户点击列表里的文字,并自动填充到搜索框内
TextView textView = (TextView) view.findViewById(android.R.id.text1);
空,则模糊搜索空字符 = 显示所有的搜索历史
String tempName = et_search.getText().toString();
queryData(tempName); // ->>关注1

}
});

/**

步骤3：搜索记录列表（ListView）监听
即当用户点击搜索历史里的字段后,会直接将结果当作搜索字段进行搜索
*/
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {

// 获取用户点击列表里的文字,并自动填充到搜索框内
TextView textView = (TextView) view.findViewById(android.R.id.text1);

Android开源实战：手把手教你实现一个简单好用的搜索框（含历史搜索记录相关推荐

手把手教你制作一个简单的聊天机器人(图灵api)
前言:在无聊的时候打打游戏.听听歌还不如来找个人来陪你聊天,今天来教大家制作一个聊天机器人,这样就不会无聊了,在线聊天机器人地址借愁哥哥机器人(可能有点丑,大家将就一下 (
C语言能干什么？手把手教你写一个简单的聊天软件
一.服务端代码因为端口号容易被占用的原因,所以IP地址和端口号采用参数传递的方法,即 int main(int argc,char **argv) 1.头文件 #include <stdio. ...
android 自定义心电图,手把手教你打造一个心电图效果View Android自定义View
大家好,看我像不像蘑菇-因为我在学校呆的发霉了. 思而不学则殆丽丽说得对,我有奇怪的疑问,大都是思而不学造成的,在我书读不够的情况下想太多,大多等于白想 ,所以革命没成功,同志仍需努力. 好了废话不 ...
android 自定义心电图,手把手教你打造一个心电图效果View Android自定义View(示例代码)...
大家好,看我像不像蘑菇-因为我在学校呆的发霉了. 思而不学则殆丽丽说得对,我有奇怪的疑问,大都是思而不学造成的,在我书读不够的情况下想太多,大多等于白想 ,所以革命没成功,同志仍需努力. 好了废话不 ...
实战|手把手教你训练一个基于Keras的多标签图像分类器
图片来自 pexels,作者:Jean-Christophe André 2019 年第 63 篇文章,总第 87 篇文章原文链接:https://www.pyimagesearch.com/201 ...
samp服务器信息获取,手把手教你写一个简单的服务器
该楼层疑似违规已被系统折叠隐藏此楼查看此楼 //第八步,玩家杀人得分得金钱,死亡扣分扣金钱 public OnPlayerDeath(playerid, killerid, reason)//玩家被 ...
手把手教你做一个简单WEB系统———在线考试
软件开发中经常会用的三层架构MVC: VO层 package vo;public class Student {private String id;private String stuName;pri ...
Android开源实战：简单好用、含历史搜索记录的智能搜索框
前言 Android开发中,类似下图的搜索功能非常常见今天,我将带来一款封装了历史搜索记录功能 & 样式的Android 自定义搜索框开源库,希望你们会喜欢. 已在Github开源: ...
手把手教你编写一个上位机
关注+星标公众号,不错过精彩内容转自 | 嵌入式大杂烩嵌入式开发,基本都会用到有一些上位机工具,比如串口助手就是最常用的工具之一. 那么,今天分享有一篇由ZhengN整理的用Qt写的简单上位机教程 ...
Android 开发之手把手教你写 ButterKnife 框架（三）
系列文章目录导读: Android开发之手把手教你写ButterKnife框架(一) Android开发之手把手教你写ButterKnife框架(二) Android开发之手把手教你写ButterKn ...

Android开源实战：手把手教你实现一个简单好用的搜索框（含历史搜索记录

6. 功能详细设计

6.1 关键字搜索

6.2 实时显示历史搜索记录

Android开源实战：手把手教你实现一个简单好用的搜索框（含历史搜索记录相关推荐

最新文章

热门文章

Android开源实战：手把手教你实现一个简单 好用的搜索框（含历史搜索记录

6. 功能详细设计

6.1 关键字搜索

6.2 实时显示历史搜索记录

Android开源实战：手把手教你实现一个简单 好用的搜索框（含历史搜索记录相关推荐

最新文章

热门文章

Android开源实战：手把手教你实现一个简单好用的搜索框（含历史搜索记录

Android开源实战：手把手教你实现一个简单好用的搜索框（含历史搜索记录相关推荐