graphdb/lib/service/transaction-service.js

Javascript client library supporting GraphDB and RDF4J REST API.

"use strict";

function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
function _possibleConstructorReturn(t, e) { if (e && ("object" == _typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
var Service = require('./service');
var HttpRequestBuilder = require('../http/http-request-builder');
var PATH_TRANSACTIONS = require('./service-paths').PATH_TRANSACTIONS;
var LoggingUtils = require('../logging/logging-utils');
var StringUtils = require('../util/string-utils');
var RepositoryClientConfig = require('../repository/repository-client-config');
var TransactionalRepositoryClient = require('../transaction/transactional-repository-client');

/**
 * Service for working with the transactions endpoint.
 *
 * @author Mihail Radkov
 * @author Svilen Velikov
 * @author Teodossi Dossev
 */
var TransactionService = /*#__PURE__*/function (_Service) {
  /**
   * Instantiates the transaction service with the supplied executor and
   * repository client config.
   *
   * @param {Function} httpRequestExecutor used to execute HTTP requests
   * @param {RepositoryClientConfig} repositoryClientConfig used to create
   * transaction client configurations
   */
  function TransactionService(httpRequestExecutor, repositoryClientConfig) {
    var _this;
    _classCallCheck(this, TransactionService);
    _this = _callSuper(this, TransactionService, [httpRequestExecutor]);
    _this.repositoryClientConfig = repositoryClientConfig;
    return _this;
  }

  /**
   * Starts a transaction and produces a {@link TransactionalRepositoryClient}.
   *
   * The transactions ID is extracted from the <code>location</code> header and
   * is used as  endpoint for the produced TransactionalRepositoryClient.
   *
   * If no transaction isolation level is provided, the server will use its
   * default isolation level.
   *
   * @param {string} [isolationLevel] an optional parameter to specify the
   * transaction's level of isolation; for possible values see
   * {@link TransactionIsolationLevel}
   *
   * @return {Promise<TransactionalRepositoryClient>} transactional client
   */
  _inherits(TransactionService, _Service);
  return _createClass(TransactionService, [{
    key: "beginTransaction",
    value: function beginTransaction(isolationLevel) {
      var _this2 = this;
      var requestBuilder = HttpRequestBuilder.httpPost(PATH_TRANSACTIONS).addParam('isolation-level', isolationLevel);
      return this.httpRequestExecutor(requestBuilder).then(function (response) {
        var locationUrl = response.getHeaders()['location'];
        if (StringUtils.isBlank(locationUrl)) {
          _this2.logger.error(LoggingUtils.getLogPayload(response, {
            isolationLevel: isolationLevel
          }), 'Cannot obtain transaction ID');
          return Promise.reject(new Error('Couldn\'t obtain transaction ID'));
        }
        var config = _this2.getTransactionalClientConfig(locationUrl);
        var transactionClient = new TransactionalRepositoryClient(config);
        _this2.logger.debug(LoggingUtils.getLogPayload(response, {
          isolationLevel: isolationLevel
        }), 'Started transaction');
        return transactionClient;
      });
    }

    /**
     * Builds client configuration for transactional repository out of the
     * provided repository client config and the supplied location URL.
     *
     * @private
     *
     * @param {string} locationUrl the url for the transactional repo endpoint
     *
     * @return {RepositoryClientConfig} the built transaction client config
     */
  }, {
    key: "getTransactionalClientConfig",
    value: function getTransactionalClientConfig(locationUrl) {
      var config = this.repositoryClientConfig;
      var transactionConfig = new RepositoryClientConfig(config.getEndpoint()).setEndpoints([locationUrl]).setHeaders(config.getHeaders()).setDefaultRDFMimeType(config.getDefaultRDFMimeType()).setReadTimeout(config.getReadTimeout()).setWriteTimeout(config.getWriteTimeout());
      if (config.shouldAuthenticate()) {
        var userName = config.getUsername();
        var password = config.getPass();
        if (config.getBasicAuthentication()) {
          transactionConfig.useBasicAuthentication(userName, password);
        } else if (config.getGdbTokenAuthentication()) {
          transactionConfig.useGdbTokenAuthentication(userName, password);
        }
      }
      return transactionConfig;
    }

    /**
     * @inheritDoc
     */
  }, {
    key: "getServiceName",
    value: function getServiceName() {
      return 'TransactionService';
    }
  }]);
}(Service);
module.exports = TransactionService;