本文旨在解决在 MarkLogic 数据库中使用 Java API 进行通配符查询时，结果不准确的问题。通过详细的代码示例和配置说明，指导开发者如何利用 `cts:json-property-value-query` 或创建带有特定索引设置的字段，实现精确的通配符匹配，从而获得期望的查询结果。
在使用 MarkLogic 数据库时，经常需要进行模糊查询，特别是针对 JSON 属性中的字符串列表。本文将深入探讨如何使用 MarkLogic 的 Java API 创建正确的通配符查询，以确保获得准确的搜索结果。我们将讨论使用 cts:json-property-value-query 以及创建具有特定索引设置的字段这两种方法，并提供详细的代码示例和注意事项。
理解通配符查询的问题
在使用通配符查询时，可能会遇到一些问题，例如：
- 结果不准确： 查询返回的结果可能包含不符合通配符模式的文档。
- 性能问题： 不正确的通配符查询可能导致性能下降，特别是当数据量很大时。
- 索引配置： 数据库的索引配置会影响通配符查询的结果。
解决方案一：使用 cts:json-property-value-query
cts:json-property-value-query 允许你直接在 JSON 属性上执行值查询，并支持通配符。这种方法通常比使用 cts:word-query 更精确，尤其是在处理包含多个单词或特殊字符的字符串时。
立即学习“Java免费学习笔记（深入）”；
代码示例：
import com.marklogic.client.query.StructuredQueryBuilder;
import com.marklogic.client.query.StructuredQueryDefinition;
import com.marklogic.client.query.StringQueryDefinition;
import com.marklogic.client.query.QueryManager;
import com.marklogic.client.DatabaseClient;
import com.marklogic.client.DatabaseClientFactory;
import com.marklogic.client.io.JacksonHandle;
import com.fasterxml.jackson.databind.JsonNode;
import com.marklogic.client.document.JSONDocumentManager;
import com.marklogic.client.pojo.annotation.Id;
import java.util.List;
import java.util.Arrays;
public class WildcardQueryExample {
public static void main(String[] args) {
// 替换为你的 MarkLogic 连接信息
String host = "localhost";
int port = 8000;
String username = "your_username";
String password = "your_password";
String database = "your_database";
// 创建数据库客户端
DatabaseClient client = DatabaseClientFactory.newClient(host, port, database, username, password, DatabaseClientFactory.Authentication.DIGEST);
// 创建查询管理器
QueryManager queryManager = client.newQueryManager();
// 创建 StructuredQueryBuilder
StructuredQueryBuilder sqb = new StructuredQueryBuilder();
// 定义查询选项，启用通配符
String[] options = {"wildcarded"};
// 要搜索的字符串，例如 "50"
String searchText = "50";
// 创建 cts:json-property-value-query
StructuredQueryDefinition queryDefinitionIcs = sqb.value(sqb.jsonProperty("icsList"),
null, options, 1, searchText + "*");
// 执行查询
JacksonHandle handle = new JacksonHandle();
queryManager.search(queryDefinitionIcs, handle);
// 处理查询结果
JsonNode results = handle.get();
System.out.println(results.toString());
// 关闭客户端
client.release();
}
}重要提示：
- 确保你的 MarkLogic 数据库已启用通配符搜索。
- 通配符 "*" 匹配零个或多个字符。
- cts:json-property-value-query 将属性值视为短语，因此通配符不能跨越单词边界。 例如，如果属性值为 "hello friend"，则 "he*" 不会匹配，但 "hello *" 会匹配。
解决方案二：创建具有特定索引设置的字段
另一种方法是创建一个带有特定索引设置的字段，以支持更精细的通配符搜索。这涉及到在 MarkLogic 管理界面中配置字段，并启用以下选项：
- 字段值搜索 (Field Value Searches)
- 尾部通配符搜索 (Trailing Wildcard Searches)
- 两个字符搜索 (Two Character Searches) (如果需要支持短通配符)
代码示例：
import com.marklogic.client.query.StructuredQueryBuilder;
import com.marklogic.client.query.StructuredQueryDefinition;
import com.marklogic.client.query.StringQueryDefinition;
import com.marklogic.client.query.QueryManager;
import com.marklogic.client.DatabaseClient;
import com.marklogic.client.DatabaseClientFactory;
import com.marklogic.client.io.JacksonHandle;
import com.fasterxml.jackson.databind.JsonNode;
import com.marklogic.client.document.JSONDocumentManager;
import com.marklogic.client.pojo.annotation.Id;
import java.util.List;
import java.util.Arrays;
public class FieldWildcardQueryExample {
public static void main(String[] args) {
// 替换为你的 MarkLogic 连接信息
String host = "localhost";
int port = 8000;
String username = "your_username";
String password = "your_password";
String database = "your_database";
// 创建数据库客户端
DatabaseClient client = DatabaseClientFactory.newClient(host, port, database, username, password, DatabaseClientFactory.Authentication.DIGEST);
// 创建查询管理器
QueryManager queryManager = client.newQueryManager();
// 创建 StructuredQueryBuilder
StructuredQueryBuilder sqb = new StructuredQueryBuilder();
// 定义查询选项，启用通配符
String[] options = {"wildcarded"};
// 要搜索的字符串，例如 "50"
String searchText = "50";
// 创建 cts:field-value-query
StructuredQueryDefinition queryDefinitionIcs = sqb.value(sqb.field("icsList"),
null, options, 1, searchText + "* *");
// 执行查询
JacksonHandle handle = new JacksonHandle();
queryManager.search(queryDefinitionIcs, handle);
// 处理查询结果
JsonNode results = handle.get();
System.out.println(results.toString());
// 关闭客户端
client.release();
}
}注意事项：
- 在 MarkLogic 管理界面中创建名为 "icsList" 的字段，并配置上述索引选项。
- 使用 sqb.field("icsList") 代替 sqb.jsonProperty("icsList") 来指定字段。
- 尾部通配符搜索通常需要一个空格作为分隔符，例如 "50* *".
选择哪种方法？
- 如果只需要简单的通配符查询，并且不需要精细的控制，可以使用 cts:json-property-value-query。
- 如果需要更精细的控制，例如支持短通配符或优化性能，可以创建具有特定索引设置的字段。
- 如果需要进行复杂的查询，比如需要组合多个条件，那么需要根据实际情况选择合适的方法。
总结
本文介绍了在 MarkLogic 数据库中使用 Java API 创建正确的通配符查询的两种方法。通过使用 cts:json-property-value-query 或创建具有特定索引设置的字段，你可以实现精确的通配符匹配，并获得期望的搜索结果。在选择方法时，请考虑你的具体需求和数据库的配置。正确配置通配符查询对于提高搜索效率和准确性至关重要。
