javascript - 为什么我无法捕获 MarkLogic 请求中的某些异常？

Question

我有一些代码可以练习 “invalid values” setting on an element range index .在本例中，我在数据库中的 onDate 元素上配置了一个 dateTime 元素范围索引(这将同时应用于 XML 元素和 JSON 属性)。我已经将该索引设置为拒绝无效值。此设置意味着如果我尝试设置 onDate 元素的值并且它不可转换为 dateTime 或为 null(文字 null JSON 或 XML 中的 xsi:nil="true")，我的更新将失败。 (相反的行为是完全忽略无效值。)

我在 MarkLogic 8.0-4 的服务器端 JavaScript 中尝试了以下代码:

'use strict';
declareUpdate();
var errors = [];
var inputs = {
 '/37107-valid.json': (new Date()).toISOString(),
 '/37107-invalid.json': 'asdf',  // Should throw an error
 '/37107-null.json': null  
};

for(var uri in inputs) {
 try {
   xdmp.documentInsert(
     uri,
     { 'onDate': inputs[uri] },
     xdmp.defaultPermissions(),
     ['37107'] // Collections
   );
 } catch(err) {
   errors.push(err);
 }
}
errors.length;

我本以为我的请求会成功并以 1 === errors.length 结束，因为只有第二次插入会失败，因为 'asdf'不能作为 dateTime 进行转换并且它不为空。但是，我收到了一个 XDMP-RANGEINDEX 错误，我的交易失败了。为什么我的 try/catch 在这里不起作用？

Answer 1

问题在于 MarkLogic 如何处理更新事务。 MarkLogic 不是在每次调用 xdmp.docuentInsert(...) 时实际更改数据，而是将所有更新排队，并在请求结束时自动应用它们。 (这也是为什么您在同一事务中看不到数据库更新的原因。)因此，直到循环执行并且数据库尝试提交排队的事务之后才会抛出错误。这种行为在 XQuery 中是相同的(稍微简化):

let $uris := (
 '/37107-valid.xml',
 '/37107-invalid.xml',
 '/37107-null.xml'
)
let $docs := (
 <onDate>{fn:current-dateTime()}</onDate>,
 <onDate>asdf</onDate>,
 <onDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
)
return
 for $uri at $i in $uris
 return 
   try {
     xdmp:document-insert($uri, $docs[$i], (), ('37107'))
   } catch($err) {
     xdmp:log($err)
   }

为了同步捕获错误，您需要将每个更新放入其自己的事务中。一般来说，这种方法比 MarkLogic 的默认事务处理要慢得多，而且会占用大量资源。但是，它在这里只是为了说明幕后发生的事情，并且可以在特定用例中派上用场，例如这个。

在下面的示例中，我使用 xdmp.invokeFunction()在与父请求不同的事务中“调用”一个函数。 (胜利的一流功能!)这允许完全应用更新(或回滚错误)并允许调用模块查看更新(或错误)。我将低级 xdmp.invokeFunction() 包装在我自己的 applyAs() 函数中以提供一些细节，例如将函数参数正确传递给柯里化(Currying)函数。

'use strict';

var errors = [];
var inputs = {
 '/37107-valid.json': (new Date()).toISOString(),
 '/37107-invalid.json': 'asdf',
 '/37107-null.json': null
};

var insert = applyAs(
 function(uri, value) {
   return xdmp.documentInsert(
     uri,
     { 'onDate': inputs[uri] },
     xdmp.defaultPermissions(),
     ['37107']
   );
 },
 { isolation: 'different-transaction', transactionMode: 'update' },
 'one'
);

for(var uri in inputs) {
 try {
   insert(uri, inputs[uri]);
 } catch(err) {
   errors.push(err);
 }
}
errors.length; // Correctly returns 1


// <https://gist.github.com/jmakeig/0a331823ad9a458167f6>
function applyAs(fct, options, returnType /* 'many', 'one', 'iterable' (default) */) {
  options = options || {};
  return function() {
    var params = Array.prototype.slice.call(arguments); 
    // Curry the function to include the params by closure.
    // xdmp.invokeFunction requires that invoked functions have
    // an arity of zero.
    var f = (function() {
       return fct.apply(null, params);
    }).bind(this);
    // Allow passing in user name, rather than id
    if(options.user) { options.userId = xdmp.user(options.user); delete options.user; }
    // Allow the functions themselves to declare their transaction mode
    if(fct.transactionMode && !(options.transactionMode)) { options.transactionMode = fct.transactionMode; }
    var result = xdmp.invokeFunction(f, options); // xdmp.invokeFunction returns a ValueIterator
    switch(returnType) {
      case 'one':
        // return fn.head(result); // 8.0-5
        return result.next().value;
      case 'many':
        return result.toArray();
      case 'iterable':
      default:
        return result;
    }
  }
}