java - 使用 Marklogic 的 Java 搜索 API 与 XQuery/XSLT API 进行文档 XPath 搜索

Question

我有以下 Marklogic 查询，当在查询控制台中运行时，它允许我检索具有管理员权限的系统用户:

xquery version "1.0-ml";
import schema namespace bfa="http://bitfood.org/auth" at "schema/auth/bitfood-auth.xsd";
cts:search(/bfa:AppUser[bfa:appAccess/@appRole = "ROLE_SYS_ADMIN"], cts:and-query(()))

请原谅我的无知，但是否可以仅使用 Java 客户端 API 来实现此查询？

我知道我可以通过 XCC 使用原始查询，但我尽量避免这种情况。

我一直在深入研究 Java 客户端 API 的文档，不幸的是，该文档简要介绍了其他搜索方法，但没有发现任何暗示这是可能的。

更新 1:伙计们，我想我在这里遇到了阻碍。

根据 this question ，Java 客户端 API 的查询选项构建工具被标记为已弃用。

@ehennum 建议使用 XML 或 JSON 查询选项的替代方法。但是，此类查询选项规范是 still essentially defined as raw Strings in the code :

String xmlOptions =
  "<search:options "+
        "xmlns:search='http://marklogic.com/appservices/search'>"+
      "<search:constraint name='industry'>"+
        "<search:value>"+
          "<search:element name='industry' ns=''/>"+
        "</search:value>"+
      "</search:constraint>"+
  "</search:options>";

诚然，我可以使用 JAXB、JDOM、文件或其他一些工具来创建 XML，但我个人认为我们仍然求助于 storing queries in resource files in the code ，这本身并不是一件坏事，但如果不仔细考虑，可能会导致代码维护的噩梦。

此外，这些选项需要通过服务器上的 REST 持久化这一事实引入了一层潜在的问题，以防万一这是强制性的，因为这些选项可能需要与旨在与一个数据库一起工作的每个数据库实例同步。代码库。

因此，如果 Marklogic 开发人员正在倾听，我认为 Java 客户端 API 并不像我预期的那样成熟或记录。

目前我有两个选择:

1) 我可以在字符串文件中对我的 XCC 查询进行硬编码，并尝试使用参数占位符插入我需要的数据并通过 XCC session 检索。或者。

2) 查看 http://marklogic.com/appservices/search 命名空间是否有任何 XSD 文件，并从中创建静态 JAXB 对象以构建某种“标准”类(class) a la Hibernate或 QueryDSL遗憾的是，我必须说，它已经支持某种级别的 MongoDB 查询。

伙计们，真的，给 Marklogic 带来一些流畅的查询工具，比如 QueryDSL，摆脱这个 Rube Goldberg querying machine .

更新 2:似乎这可能会在 ML7 中得到解决。敬请期待。

谢谢!

Answer 1

背景:Java API 是 REST API 上的一层 Search API 是 cts:search 上的一层

您可以在搜索 API 中表达此查询。

• 在查询选项中为第一个参数使用可搜索的表达式 http://docs.marklogic.com/guide/search-dev/search-api#id_43671

• 对结构化查询使用空和查询 http://docs.marklogic.com/guide/search-dev/structured-query#id_83674

使用 Java API，您可以使用查询选项和结构化查询作为 RawCombinedQueryDefinition 进行搜索。

总而言之，您还可以在 bfa:AppUser 上搜索一个元素查询，其中包含对 bfa:appAccess/@appRole 的“ROLE_SYS_ADMIN”的值约束查询

虽然 XPath 很方便，但最好熟悉查询表达式以了解数据库的全部功能和灵 active 。

更新 1:

需要考虑的几件事:

• Search API 中的查询包含两部分:查询(使用 Google 风格的字符串搜索或使用 JSON 或 XML 结构化搜索表示)和查询选项。 StructuredQueryBuilder 构建结构化搜索。 QueryOptionsBuilder 仅构建查询选项。

• 在 ML 6.0-3 中，REST API 引入了对组合搜索的支持，它在单个请求中提供了这两个部分。 Java API 通过 RawCombinedQueryDefinition 类添加了对此类请求的支持。

• ML7 正在扩展结构化搜索，以减少或消除对结构化搜索查询选项的需求。 StructuredQueryBuilder 在 ML7 中得到增强，以支持结构化搜索的新功能。在 ML7 中，您将能够完全在 StructuredQueryBuilder 中编写上面的示例查询，而无需任何查询选项。

• 当我们将构建查询选项的代码与 QueryOptionsBuilder 以及与 JDOM 或 XOM 进行比较时，很难看出构建器在 LOC 方面有多少优势。

• 您不必在字符串中硬编码查询选项。对于关注点分离，您可以从文件或许多其他来源读取 JSON 或 XML 查询选项。 (请参阅 http://docs.marklogic.com/javadoc/client/com/marklogic/client/io/marker/QueryOptionsReadHandle.html 标记接口(interface)的实现。)

• 查询选项提供声明而不是可执行代码。并行的是 Spring 配置文件，而不是 SPL 文件。

顺便说一句，虽然 JAXB 非常适合源自 Java 类的设计，但 JAXB 对于源自复杂 XML 模式的设计可能会非常痛苦。搜索模式利用了 XML 模式的强大功能。当我们探索这条路线时，我们得出结论，JAXB 不会帮助提供查询选项的接口(interface)。