为什么我不能在MarkLogic请求中捕获某些异常？

Question

我有一些代码在元素范围索引上运行"无效值"设置.在这种情况下,我已经在我的数据库中dateTime的onDate元素上配置了元素范围索引(这将适用于XML元素和JSON属性).我已设置该索引以拒绝无效值.此设置意味着如果我尝试设置onDate元素的值并且它不能转换为dateTime或者为null(nullJSON或xsi:nil="true"XML中的文字),则我的更新将失败.(相反的行为是完全忽略无效值.)

我在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'它不能作为a转换dateTime而且它不是null.但是,我得到一个XDMP-RANGEINDEX错误,我的交易失败.为什么我的try/ catch在这里工作？

Answer 1

问题是MarkLogic如何处理更新事务.xdmp.docuentInsert(…)MarkLogic 不是在每次调用时实际更改数据,而是将所有更新排队并在请求结束时以原子方式应用它们.(这也是您无法在同一事务中看到数据库更新的原因.)因此,在循环执行并且数据库尝试提交排队的事务之前,不会抛出错误.这种行为在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()函数中包含了低级别来提供一些细节,比如正确地将函数参数传递给curried函数.

'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;
    }
  }
}