AutoCompleteTextView实现历史记录提示

今天心血来潮用as自动创建了一个登陆界面，一看xml布局,卧槽原来google用的是AutoCompleteTextView来当账号的控件的。马上查资料,应用场景就很多了,比如历史记录提示、搜索联想、文字自动完成（邮箱自动下拉一堆@qq.com，@163.com后缀）等等。

言归正传，文字自动完成需要实现写好字符集，搜索联想需要服务器配合获取数据，为了巩固记忆，今天实现把用户输入的作为历史记录保存，然后显示。

效果图：

布局代码

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    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="com.yang.app.autocompletetextview.MainActivity">

    <android.support.design.widget.TextInputLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <AutoCompleteTextView
            android:id="@+id/auto_main_text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:hint="@string/hint"
            android:maxLines="1"
            android:singleLine="true" />
    </android.support.design.widget.TextInputLayout>

    <Button
        android:background="#119999"
        android:layout_gravity="center"
        android:id="@+id/btn_main_save"
        android:layout_width="150dp"
        android:layout_height="wrap_content"
        android:text="save" />

</LinearLayout>

代码

public class MainActivity extends AppCompatActivity {

    private AutoCompleteTextView mAutoTv;
    private Button mBtnSave;

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

    private void initView() {
        mAutoTv = (AutoCompleteTextView) findViewById(R.id.auto_main_text);
        mBtnSave = (Button) findViewById(R.id.btn_main_save);
    }

    private void initData() {
        initHistory();
    }

    private void initEvent() {
        //有焦点时才会显示记录
        mAutoTv.setOnFocusChangeListener(new View.OnFocusChangeListener() {
            @Override
            public void onFocusChange(View v, boolean hasFocus) {
                AutoCompleteTextView view = (AutoCompleteTextView) v;
                if (hasFocus) {
                    SharedPreferences sp = getSharedPreferences("auto_text", MODE_PRIVATE);
                    String history = sp.getString("history", "");
                    //history不为空才显示
                    if (!TextUtils.isEmpty(history))
                        view.showDropDown();
                }
            }
        });
        mBtnSave.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                saveHistory(mAutoTv);
            }
        });
    }

    /**
     * 初始化历史记录，最多显示3项提示，采用sp保存
     */
    int nearHistory = 3;//显示记录条数

    private void initHistory() {
        SharedPreferences sp = getSharedPreferences("auto_text", MODE_PRIVATE);
        String history = sp.getString("history", "");
        String[] hisArrays = history.split(",");
        ArrayAdapter<String> hisAdapter = new ArrayAdapter<>(this, android.R.layout.simple_dropdown_item_1line, hisArrays);
        //TODO:这个字符串会越来越长,开发中最好提供清理历史记录的功能
        if (hisArrays.length > nearHistory) {
            String[] newArrays = new String[nearHistory];
            System.arraycopy(hisArrays, 0, newArrays, 0, nearHistory);
             //布局可以自己创建,用android自带的也行
            hisAdapter = new ArrayAdapter<>(this, android.R.layout.simple_dropdown_item_1line, newArrays);
        }
        mAutoTv.setAdapter(hisAdapter);//这里要传递的adapter参数必须是继承ListAdapter和Filterable的
//        mAutoTv.setDropDownHeight(350);//设置提示下拉框的高度，注意，这只是限制了提示下拉框的高度，提示数据集的个数并没有变化
        mAutoTv.setThreshold(1);//当输入一个字符时就开始搜索历史,默认是2个
        mAutoTv.setCompletionHint("最近的3条记录");

//        TODO:一些AutoCompleteTextView的方法解释
//        clearListSelection，去除selector样式，只是暂时的去除，当用户再输入时又重新出现
//        dismissDropDown，关闭下拉提示框
//        enoughToFilter，这是一个是否满足过滤条件的方法，sdk建议我们可以重写这个方法
//        getAdapter，得到一个可过滤的列表适配器
//        getDropDownAnchor，得到下拉框的锚计的view的id
//        getDropDownBackground，得到下拉框的背景色
//        setDropDownBackgroundDrawable，设置下拉框的背景色
//        setDropDownBackgroundResource，设置下拉框的背景资源
//        setDropDownVerticalOffset，设置下拉表垂直偏移量，即是list里包含的数据项数目
//        getDropDownVerticalOffset ，得到下拉表垂直偏移量
//        setDropDownHorizontalOffset，设置水平偏移量
//        setDropDownAnimationStyle，设置下拉框的弹出动画
//        getThreshold，得到过滤字符个数
//        setOnItemClickListener，设置下拉框点击事件
//        getListSelection，得到下拉框选中为位置
//        getOnItemClickListener。得到单项点击事件
//        getOnItemSelectedListener得到单项选中事件
//        getAdapter，得到那个设置的适配器


    }

    /**
     * 把内容保存到sp中
     */
    private void saveHistory(AutoCompleteTextView autoTv) {
        String text = autoTv.getText().toString();
        SharedPreferences sp = getSharedPreferences("auto_text", MODE_PRIVATE);
        String history = sp.getString("history", "");
        //先判断是否已经存过一样的文字
        if (!TextUtils.isEmpty(text)&&!history.contains(text + ",")) {
            StringBuilder sb = new StringBuilder(history);
            sb.insert(0, text + ",");//插入到第一个,代表最新
            sp.edit().putString("history", sb.toString()).apply();
            Toast.makeText(MainActivity.this, "存好了", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(MainActivity.this, "存过了", Toast.LENGTH_SHORT).show();
        }
    }
}

是不是很简单，并没有多少需要写的。但是特别注意的是：控件的setAdapter（）方法，参数必须是继承ListAdapter和Filterable的，其中arrayAdapter和simpleAdapter都能满足要求，推荐用arrayAdapter，simpleAdapte还要设置他的显示位置和textview组件。

另外还查到了MultiAutoCompleteTextView，一个可支持选择多个值（在多次输入的情况下）,分别用分隔符分开，并且在每个值选中的时候再次输入值时会自动去匹配。这个可用在发短信，发邮件时选择联系人这种类型当中。使用时需要执行设置分隔符方法。

Demo：AutoCompleteTextViewDemo