MarkLogic中有没有一种方法可以通过REST API查询视图，而无需在中间层编写代码？

Question

我在MarkLogic中有多个文档，都属于同一个集合。我创建了一个模板，以便创建一个视图，并且可以通过该视图查询文档记录。但是，MarkLogic仅支持通过SQL或OpticAPI查询视图。我想通过REST API查询视图。这怎么可能呢？

假设我的文档位于路径/employee//UUID.json上。

以下是一个文档的创建方式及其包含的数据：

declareUpdate();
xdmp.documentInsert("/employee/1586502/981723ioewqhdijsaduih3q8yeuiqwhdeqw.json",
{
      "EmployeeID": "1234567",
      "EmployeeName": "Lorem Ipsum",
      "JoiningDate": "2018-07-01"
    },
xdmp.defaultPermissions(),
[
  "EmployeeRecordCollection"
])

以下是模板定义：

'use strict'
var tde = require("/MarkLogic/tde.xqy");
var EmployeeRecordTDE = xdmp.toJSON(
  {
    "template": {
      "context": "/",
      "collections": ["EmployeeRecordCollection"],
      "rows": [
        {
          "schemaName": "employees",
          "viewName": "EmployeeRecordView",
          "columns": [
            {
              "name": "employeeId",
              "scalarType": "string",
              "val": "EmployeeID"
            },
            {
              "name": "rateType",
              "scalarType": "string",
              "val": "EmployeeName",
            },
            {
              "name": "startDate",
              "scalarType": "string",
              "val": "JoiningDate"
            }
          ]
        }
      ]
    }
  }
);
tde.validate( 
  [EmployeeRecordTDE]
);

tde.nodeDataExtract( 
  [fn.collection(["EmployeeRecordCollection"])],
  [EmployeeRecordTDE]
);

tde.templateInsert(
  "/employee/EmployeeRecordTDE.json" ,
  EmployeeRecordTDE,
  xdmp.defaultPermissions(),
  ["EmployeeRecordCollection"]
)

上述模板创建了一个名为“EmployeeRecordView”的视图，可以使用SQL查询该视图：

select * from EmployeeRecordView where...;

可以使用Javascript中的OpticAPI将其转换为计划：

declareUpdate();
const op = require('/MarkLogic/optic');

const EmployeePlanSQL =
   op.fromSQL("select * from EmployeeRecordView")
const planObj = EmployeePlanSQL.export();

xdmp.documentInsert("emplRatePlanSQL.json", planObj);

op.import(cts.doc('emplRatePlanSQL.json').toObject())
  .result();

我想我可以使用这个计划在MarkLogic中公开一个REST API，这样我就不会在应用程序代码中保留查询。MarkLogic确实提供了一种方法，但是整个计划定义必须在REST API中作为查询传递，这也是不需要的。

http://localhost:8040/v1/rows?plan=...

此外，最大的愿望不是将查询保留在应用程序代码中。有没有办法通过MarkLogic中的JS函数或其他方法将此计划公开为RESTAPI？

Answer 1

我使用REST API扩展来实现这一点，因为我想避免中间层。

这是我点击的URL

http://localhost:8040/LATEST/config/resources/employees?version=1.0&provider=yourTeam&method=get

使用HTTP标头：

Content-Type: application/vnd.marklogic-javascript

具有以下主体：

function get(context, params) {
  context.outputStatus = [201, 'Yay'];
  const op = require('/MarkLogic/optic');
  return op.import(cts.doc('emplRatePlanSQL.json').toObject()).result();
}

// Include an export for each method supported by your extension.
exports.GET = get;

然而，输出没有格式化为JSON记录数组。这使我完全避免了中间层，并节省了大量Java代码。

现在，我只需调用此URI（HTTP GET）即可调用此计划：

http://localhost:8040/LATEST/resources/employees

谢谢你的帮助！

Answer 2

在前面的回答中，我没有意识到目标是封装查询并只传递条件。

如果中间层是用Java编写的，一种方法是定义一个数据服务，该服务采用计划的标准并在endpoint内封装查询：

http://docs.marklogic.com/guide/java/DataServices

否则，您可以使用封装查询的资源服务扩展：

http://docs.marklogic.com/guide/rest-dev/extensions#id_59188

Java API和节点。JSAPI提供了到资源服务扩展的接口。它们也可以在Rest时调用：

http://docs.marklogic.com/REST/client/service-extension

希望这更有用，