使用MarkLogic Java API替代已弃用的KeyValueQueryDefinition搜索XML节点

嘿，刚好碰到过类似的问题！既然KeyValueQueryDefinition已经被MarkLogic弃用了，咱们换用现在官方推荐的方式来实现这个需求就行，主要有两种简单的方法，我给你详细说下：

Query Builder是MarkLogic Java API里最直观的查询构建工具，专门用来替代旧的KeyValueQuery这类弃用的API，写起来非常清爽。

直接上代码示例：

import com.marklogic.client.query.QueryManager;
import com.marklogic.client.query.StructuredQueryBuilder;
import com.marklogic.client.query.StructuredQueryDefinition;
import com.marklogic.client.query.SearchHandle;

// 假设你已经完成了client的初始化（比如通过DatabaseClientFactory创建）
QueryManager queryMgr = client.newQueryManager();
StructuredQueryBuilder qb = new StructuredQueryBuilder();

// 核心：构建查询，匹配<name>元素的值为"Shiv"
StructuredQueryDefinition query = qb.value(qb.element("name"), "Shiv");

// 执行查询并获取结果
SearchHandle resultsHandle = queryMgr.search(query, new SearchHandle());

// 处理结果，比如打印匹配数量或者遍历文档
System.out.println("找到匹配的文档总数：" + resultsHandle.getTotalResults());

这里的qb.value()方法就是专门用来匹配元素值的，完全覆盖了原来KeyValueQueryDefinition的功能，而且更灵活。

如果之后你需要叠加更多查询条件（比如同时匹配邮箱、地址），可以手动组合结构化查询，灵活性更高：

import com.marklogic.client.query.QueryManager;
import com.marklogic.client.query.StructuredQueryBuilder;
import com.marklogic.client.query.StructuredQueryDefinition;
import com.marklogic.client.query.SearchHandle;
import com.marklogic.client.query.ValueQueryDefinition;

QueryManager queryMgr = client.newQueryManager();
StructuredQueryBuilder qb = new StructuredQueryBuilder();

// 先创建单个值查询：匹配name=Shiv
ValueQueryDefinition nameQuery = qb.value(qb.element("name"), "Shiv");
// 可以再加其他查询条件，比如匹配某个邮箱后缀
// ValueQueryDefinition emailQuery = qb.value(qb.element("email"), "*@example.com");

// 把查询条件组合起来（这里只用了name查询，复杂场景可以加多个）
StructuredQueryDefinition finalQuery = qb.and(nameQuery);

// 执行查询
SearchHandle resultsHandle = queryMgr.search(finalQuery, new SearchHandle());

// 后续处理结果逻辑
// ...

额外注意点 #

• 确保你的MarkLogic Java API版本是9.0及以上，这些类都是当前官方支持的，没有弃用风险。
• 如果需要模糊匹配、范围查询之类的进阶功能，可以用qb.word()、qb.range()等方法扩展。

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