如何在Optic API中使用optic-fn、optic-json、optic-xdmp、optic-xs

Question

我们正在探索 Optic API 并做一些 POC，以用 Optic API 查询替换我们现有的代码。

作为我们新要求的一部分，我们希望使用 optic-fn、optic-json、optic-xdmp、optic-xs、 我们花了很多时间寻找使用 optic-fn、optic-json、optic-xdmp、optic-xs 的示例或示例代码，但我们找不到任何示例代码可供参考。

任何人都可以帮助我们为每个（optic-fn、optic-json、optic-xdmp、optic-xs）提供示例代码片段，这对我们非常有帮助吗？

如有任何帮助，我们将不胜感激。

Answer 1

在 XQuery 中，您不仅导入核心 Optic 库

import module namespace op="http://marklogic.com/optic"
  at "/MarkLogic/optic.xqy";

还有提供查询中所需的任何表达式函数的库。使用以下库的任意组合：

import module namespace octs="http://marklogic.com/optic/expression/cts"
  at "/MarkLogic/optic/optic-cts.xqy"; 
import module namespace ofn="http://marklogic.com/optic/expression/fn"
  at "/MarkLogic/optic/optic-fn.xqy";
import module namespace ogeo="http://marklogic.com/optic/expression/geo"
  at "/MarkLogic/optic/optic-geo.xqy";
import module namespace ojson="http://marklogic.com/optic/expression/json"
  at "/MarkLogic/optic/optic-json.xqy";
import module namespace omap="http://marklogic.com/optic/expression/map"
  at "/MarkLogic/optic/optic-map.xqy";
import module namespace omath="http://marklogic.com/optic/expression/math"
  at "/MarkLogic/optic/optic-math.xqy";
import module namespace ordf="http://marklogic.com/optic/expression/rdf"
  at "/MarkLogic/optic/optic-rdf.xqy"; 
import module namespace osem="http://marklogic.com/optic/expression/sem"
  at "/MarkLogic/optic/optic-sem.xqy"; 
import module namespace ospell="http://marklogic.com/optic/expression/spell"
  at "/MarkLogic/optic/optic-spell.xqy";
import module namespace osql="http://marklogic.com/optic/expression/sql"
  at "/MarkLogic/optic/optic-sql.xqy"; 
import module namespace oxdmp="http://marklogic.com/optic/expression/xdmp"
  at "/MarkLogic/optic/optic-xdmp.xqy"; 
import module namespace oxs="http://marklogic.com/optic/expression/xs"
  at "/MarkLogic/optic/optic-xs.xqy";

此后，您可以以相同的方式调用函数，但重要的区别是参数不仅可以包含文字，还可以包含

op:col("NAME")

来指定列值或其他嵌套表达式函数的返回值，如下所示：

=> op:where(
    ofn:starts-with(
       op:col("col1"),
       ofn:substring-before(op:col("col2"), "prefix")
       )
   )

注意，在执行查询期间对值进行操作时，仅使用 Optic 表达式库中的函数。要在构建计划时对作为参数传递的文字值进行操作，请使用普通函数。

特别是，cts:query() 参数始终在

cts

命名空间中构造，而不是在

octs

命名空间中构造。

有关哪些函数公开为表达式函数以及如何在 SJS 中公开表达式函数的详细信息，另请参阅：https://stackoverflow.com/a/65924267/1091497

希望有帮助，