graphdb
Version:
Javascript client library supporting GraphDB and RDF4J REST API.
211 lines (203 loc) • 10 kB
JavaScript
;
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 ServiceRequest = require('./service-request');
var PATH_NAMESPACES = require('./service-paths').PATH_NAMESPACES;
var RDFMimeType = require('../http/rdf-mime-type');
var Namespace = require('../model/namespace');
var LoggingUtils = require('../logging/logging-utils');
var StringUtils = require('../util/string-utils');
var DataFactory = require('n3').DataFactory;
/**
* Service for namespace management.
*
* @author Mihail Radkov
* @author Svilen Velikov
*/
var NamespaceService = /*#__PURE__*/function (_Service) {
function NamespaceService() {
_classCallCheck(this, NamespaceService);
return _callSuper(this, NamespaceService, arguments);
}
_inherits(NamespaceService, _Service);
return _createClass(NamespaceService, [{
key: "getNamespaces",
value:
/**
* Retrieves all present namespaces as a collection of {@link Namespace}.
*
* @return {ServiceRequest} a service request resolving to a collection of
* {@link Namespace}
*/
function getNamespaces() {
var _this = this;
var requestBuilder = HttpRequestBuilder.httpGet(PATH_NAMESPACES).addAcceptHeader(RDFMimeType.SPARQL_RESULTS_JSON);
return new ServiceRequest(requestBuilder, function () {
return _this.httpRequestExecutor(requestBuilder).then(function (response) {
_this.logger.debug(LoggingUtils.getLogPayload(response), 'Fetched namespaces');
return _this.mapNamespaceResponse(response.getData());
});
});
}
/**
* Maps the response data from the namespaces request into {@link Namespace}.
*
* @private
*
* @param {object} responseData the data to map
*
* @return {Namespace[]} the mapped namespaces
*/
}, {
key: "mapNamespaceResponse",
value: function mapNamespaceResponse(responseData) {
return responseData.results.bindings.map(function (binding) {
var prefix = binding.prefix.value;
var namespace = DataFactory.namedNode(binding.namespace.value);
return new Namespace(prefix, namespace);
});
}
/**
* Retrieves the namespace for the given prefix as {@link NamedNode}.
*
* For example if <code>rdfs</code> is provided as prefix that would result in
* a {@link NamedNode} corresponding to following namespace:
* <code>http://www.w3.org/2000/01/rdf-schema#</code>
*
* Note: This method should be invoked only with prefixes. Anything else would
* result in an error from the server.
*
* @param {string} prefix prefix of the namespace to be retrieved
*
* @return {ServiceRequest} service request resolving to {@link NamedNode}
*
* @throws {Error} if the prefix parameter is not supplied
*/
}, {
key: "getNamespace",
value: function getNamespace(prefix) {
var _this2 = this;
if (StringUtils.isBlank(prefix)) {
throw new Error('Parameter prefix is required!');
}
var namespaceUrl = "".concat(PATH_NAMESPACES, "/").concat(prefix);
var requestBuilder = HttpRequestBuilder.httpGet(namespaceUrl);
return new ServiceRequest(requestBuilder, function () {
return _this2.httpRequestExecutor(requestBuilder).then(function (response) {
_this2.logger.debug(LoggingUtils.getLogPayload(response, {
prefix: prefix
}), 'Fetched namespace');
return DataFactory.namedNode(response.getData());
});
});
}
/**
* Creates or updates the namespace for the given prefix.
*
* If the provided prefix or namespace parameter is not a string or
* {@link NamedNode} then the method will throw an error.
*
* @param {string} prefix prefix of the namespace to be created/updated
* @param {string|NamedNode} namespace the namespace to be created/updated
*
* @return {ServiceRequest} service request that will be resolved if the
* create/update request is successful
*
* @throws {Error} if the prefix or namespace parameter are not provided
*/
}, {
key: "saveNamespace",
value: function saveNamespace(prefix, namespace) {
var _this3 = this;
if (StringUtils.isBlank(prefix)) {
throw new Error('Parameter prefix is required!');
}
var payload = namespace;
if (namespace.termType && namespace.termType === 'NamedNode') {
payload = namespace.value;
} else if (StringUtils.isBlank(namespace)) {
throw new Error('Parameter namespace is required!');
}
var requestBuilder = HttpRequestBuilder.httpPut("".concat(PATH_NAMESPACES, "/").concat(prefix)).setData(payload);
return new ServiceRequest(requestBuilder, function () {
return _this3.httpRequestExecutor(requestBuilder).then(function (response) {
_this3.logger.debug(LoggingUtils.getLogPayload(response, {
prefix: prefix,
namespace: namespace
}), 'Saved namespace');
});
});
}
/**
* Deletes a namespace that corresponds to the given prefix.
*
* For example if <code>rdfs</code> is provided as prefix that would delete
* the following namespace: <code>http://www.w3.org/2000/01/rdf-schema#</code>
*
* Note: This method should be invoked only with prefixes. Anything else would
* result in an error from the server.
*
* @param {string} prefix prefix of the namespace to be deleted
*
* @return {Promise<void>} promise that will be resolved if the deletion is
* successful
*
* @throws {Error} if the prefix parameter is not provided
*/
}, {
key: "deleteNamespace",
value: function deleteNamespace(prefix) {
var _this4 = this;
if (StringUtils.isBlank(prefix)) {
throw new Error('Parameter prefix is required!');
}
var requestBuilder = HttpRequestBuilder.httpDelete("".concat(PATH_NAMESPACES, "/").concat(prefix));
return new ServiceRequest(requestBuilder, function () {
return _this4.httpRequestExecutor(requestBuilder).then(function (response) {
_this4.logger.debug(LoggingUtils.getLogPayload(response, {
prefix: prefix
}), 'Deleted namespace');
});
});
}
/**
* Deletes all namespace declarations in the repository.
*
* @return {Promise<void>} promise that will be resolved after
* successful deletion
*/
}, {
key: "deleteNamespaces",
value: function deleteNamespaces() {
var _this5 = this;
var requestBuilder = HttpRequestBuilder.httpDelete(PATH_NAMESPACES);
return new ServiceRequest(requestBuilder, function () {
return _this5.httpRequestExecutor(requestBuilder).then(function (response) {
_this5.logger.debug(LoggingUtils.getLogPayload(response), 'Deleted all namespaces');
});
});
}
/**
* @inheritDoc
*/
}, {
key: "getServiceName",
value: function getServiceName() {
return 'NamespaceService';
}
}]);
}(Service);
module.exports = NamespaceService;