本文旨在解决在MarkLogic数据库中使用Java API进行通配符查询时，结果不符合预期的问题。通过分析问题代码，并结合MarkLogic的查询机制，详细介绍了如何正确配置和使用`cts:json-property-value-query`和`cts:field-value-query`来实现精确的通配符匹配，同时提供了代码示例和注意事项，帮助开发者避免常见的错误，高效地进行数据检索。
在使用MarkLogic数据库进行数据检索时，通配符查询是一种常用的技术，特别是在需要模糊匹配字符串时。然而，不正确的配置和使用可能导致查询结果不准确，返回不符合预期的文档。本文将深入探讨如何在Java项目中使用MarkLogic Client API创建正确的通配符查询，以解决类似“请求字符串 '50' 返回所有JSON，即使那些 'icsList' 字段不包含 '50' 的文档”的问题。
理解MarkLogic的通配符查询机制
MarkLogic的通配符查询依赖于数据库的索引配置。默认情况下，MarkLogic可能需要特定的索引设置才能有效地处理短字符串的通配符查询。例如，如果启用了Two Character Searches，则可以搜索 "50*"，但这也可能显著增加索引的大小和影响数据摄取性能。此外，还可以考虑启用 Three Character Searches 或 Trailing Wildcard Searches。
使用 cts:json-property-value-query 实现精确匹配
与使用 cts:word-query 不同，cts:json-property-value-query 允许更精确的匹配，尤其是在结合通配符使用时。cts:json-property-value-query 将属性值视为短语，并应用相应的通配符和词干规则。
立即学习“Java免费学习笔记（深入）”；
以下是一个使用 cts:json-property-value-query 的示例：
StructuredQueryBuilder sqb = new StructuredQueryBuilder();
String[] options = {"wildcarded"};
StructuredQueryDefinition queryDefinitionIcs = sqb.value(sqb.jsonProperty("icsList"),
null, options, 1, searchText + "*");在这个例子中，searchText 变量包含了需要匹配的字符串前缀。options 数组指定了使用通配符。
注意：
- 在 cts:json-property-value-query 中，通配符匹配不会跨越单词边界。例如，如果属性值为 "hello friend"，则 "he*" 将不会匹配，但 "hello *" 将会匹配。
- 如果启用了词干提取，则词干规则将应用于每个术语。
利用 Field 索引优化查询
另一种方法是创建一个具有适当索引设置的 field，以支持该字段的两字符通配符搜索。这允许更精细的控制索引行为，而无需更改整个数据库的设置。
首先，在MarkLogic中创建一个名为 "icsList" 的field，并启用 field value searches、trailing wildcard searches 和 two character searches。
然后，可以使用 cts:field-value-query 查询该 field：
StructuredQueryDefinition queryDefinitionIcs = sqb.value(sqb.field("icsList"),
null, options, 1, searchText + "* *");代码示例
以下是一个完整的代码示例，演示了如何使用 cts:field-value-query：
import com.marklogic.client.query.StructuredQueryBuilder;
import com.marklogic.client.query.StructuredQueryDefinition;
public class WildcardQueryExample {
public static StructuredQueryDefinition createWildcardQuery(String searchText) {
StructuredQueryBuilder sqb = new StructuredQueryBuilder();
String[] options = {"wildcarded"};
StructuredQueryDefinition queryDefinitionIcs = sqb.value(sqb.field("icsList"),
null, options, 1, searchText + "* *");
return queryDefinitionIcs;
}
public static void main(String[] args) {
String searchText = "50";
StructuredQueryDefinition query = createWildcardQuery(searchText);
// 使用 query 进行 MarkLogic 数据库查询
System.out.println(query.toString()); // 输出查询语句，用于调试
}
}注意事项：
- 确保在 MarkLogic 数据库中正确配置了所需的索引设置。
- 根据实际需求选择 cts:json-property-value-query 或 cts:field-value-query。
- 仔细考虑通配符的位置和模式，以避免不必要的匹配。
总结
通过本文的介绍，您应该能够理解如何在MarkLogic数据库中使用Java Client API创建更精确的通配符查询。关键在于理解MarkLogic的查询机制，选择合适的查询函数（cts:json-property-value-query 或 cts:field-value-query），并正确配置数据库的索引设置。通过这些方法，可以避免常见的错误，并获得更准确的查询结果。
