Android DataBinding：Toolbar中SearchView的Query属性绑定问题

我刚好碰到过类似的问题，你的核心问题确实是SearchView的query字段没有对应的DataBinding Adapter——Android默认没给这个属性做绑定支持，所以ViewModel里调用setQuery后，值根本没法同步到SearchView，提交查询时自然拿不到正确的参数。下面是一步步的解决办法：

1. 自定义SearchView的BindingAdapter #

首先要写一个自定义的BindingAdapter，让DataBinding知道如何把ViewModel里的字段和SearchView的query关联起来，还要支持双向绑定（SearchView输入变化同步到ViewModel，ViewModel设置值同步到SearchView）。

创建一个工具类（比如SearchViewBindingAdapters）：

object SearchViewBindingAdapters {
    // 单向绑定：把ViewModel的query值设置到SearchView
    @BindingAdapter("query")
    @JvmStatic
    fun setSearchViewQuery(searchView: SearchView, query: String?) {
        // 避免无限循环：只有当值不同时才更新
        if (searchView.query.toString() != query) {
            searchView.setQuery(query ?: "", false)
        }
    }

    // 反向绑定：从SearchView获取当前query值给ViewModel
    @InverseBindingAdapter(attribute = "query", event = "queryAttrChanged")
    @JvmStatic
    fun getSearchViewQuery(searchView: SearchView): String {
        return searchView.query.toString()
    }

    // 监听SearchView的query变化，通知DataBinding更新ViewModel
    @BindingAdapter("queryAttrChanged")
    @JvmStatic
    fun setQueryChangeListener(searchView: SearchView, listener: InverseBindingListener?) {
        if (listener == null) {
            searchView.setOnQueryTextListener(null)
            return
        }

        searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
            override fun onQueryTextSubmit(submittedQuery: String?): Boolean {
                // 提交时通知ViewModel更新字段
                listener.onChange()
                // 这里可以根据需求返回true（拦截默认提交）或false
                return true
            }

            override fun onQueryTextChange(newText: String?): Boolean {
                // 实时输入时同步更新ViewModel字段
                listener.onChange()
                return false
            }
        })
    }
}

如果是Java版本的话，代码如下：

public class SearchViewBindingAdapters {
    @BindingAdapter("query")
    public static void setSearchViewQuery(SearchView searchView, String query) {
        if (!searchView.getQuery().toString().equals(query)) {
            searchView.setQuery(query == null ? "" : query, false);
        }
    }

    @InverseBindingAdapter(attribute = "query", event = "queryAttrChanged")
    public static String getSearchViewQuery(SearchView searchView) {
        return searchView.getQuery().toString();
    }

    @BindingAdapter("queryAttrChanged")
    public static void setQueryChangeListener(SearchView searchView, final InverseBindingListener listener) {
        if (listener == null) {
            searchView.setOnQueryTextListener(null);
            return;
        }

        searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
            @Override
            public boolean onQueryTextSubmit(String query) {
                listener.onChange();
                return true;
            }

            @Override
            public boolean onQueryTextChange(String newText) {
                listener.onChange();
                return false;
            }
        });
    }
}

2. 改造你的传统ViewModel #

因为是传统ViewModel（非Jetpack ViewModel），我们用ObservableField来实现数据变化通知（这是DataBinding原生支持的可观察类型）：

public class MySearchViewModel {
    // 可观察的搜索query字段
    public final ObservableField<String> searchQuery = new ObservableField<>("");

    // 你需要的setQuery方法，直接更新ObservableField
    public void setQuery(String query) {
        searchQuery.set(query);
    }

    // 提交查询的处理方法，直接用ViewModel里的searchQuery
    public void handleSearchSubmit() {
        String currentQuery = searchQuery.get();
        if (currentQuery != null && !currentQuery.trim().isEmpty()) {
            // 这里写你的查询处理逻辑
            // 比如发起网络请求、过滤本地数据等
        }
    }
}

3. 在布局中绑定ViewModel和SearchView #

在你的Toolbar布局里，给SearchView设置双向绑定的query属性，同时绑定提交事件：

<androidx.appcompat.widget.Toolbar
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize">

    <androidx.appcompat.widget.SearchView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        <!-- 双向绑定ViewModel的searchQuery字段 -->
        app:query="@={viewModel.searchQuery}"
        <!-- 绑定提交事件到ViewModel的处理方法 -->
        app:onQueryTextSubmit="@{() -> viewModel.handleSearchSubmit()}" />

</androidx.appcompat.widget.Toolbar>

4. 在Activity/Fragment中完成DataBinding初始化 #

最后在你的页面里绑定ViewModel到DataBinding：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 初始化DataBinding
        ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
        // 创建ViewModel实例
        MySearchViewModel viewModel = new MySearchViewModel();
        // 绑定ViewModel到布局
        binding.setViewModel(viewModel);
        // 如果需要生命周期感知（可选，传统ViewModel也可以设置）
        binding.setLifecycleOwner(this);

        // 测试调用setQuery，现在SearchView会同步显示这个值
        viewModel.setQuery("测试搜索内容");
    }
}

这样改造后，你在ViewModel里调用setQuery时，SearchView的query会同步更新；用户在SearchView输入或提交时，ViewModel里的searchQuery也会实时更新，提交查询时直接用这个字段就不会为空了。

内容的提问来源于stack exchange，提问作者Minsky