/* jshint strict: false, unused: false */ /* global TRANSACTION */ // ////////////////////////////////////////////////////////////////////////////// // / @brief ArangoDatabase // / // / @file // / // / DISCLAIMER // / // / Copyright 2013 triagens GmbH, Cologne, Germany // / // / Licensed under the Apache License, Version 2.0 (the "License") // / you may not use this file except in compliance with the License. // / You may obtain a copy of the License at // / // / http://www.apache.org/licenses/LICENSE-2.0 // / // / Unless required by applicable law or agreed to in writing, software // / distributed under the License is distributed on an "AS IS" BASIS, // / WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // / See the License for the specific language governing permissions and // / limitations under the License. // / // / Copyright holder is triAGENS GmbH, Cologne, Germany // / // / @author Achim Brandt // / @author Dr. Frank Celler // / @author Copyright 2012-2013, triAGENS GmbH, Cologne, Germany // ////////////////////////////////////////////////////////////////////////////// module.isSystem = true; var internal = require('internal'); // ////////////////////////////////////////////////////////////////////////////// // / @brief constructor // ////////////////////////////////////////////////////////////////////////////// exports.ArangoDatabase = internal.ArangoDatabase; var ArangoDatabase = exports.ArangoDatabase; // must called after export var ArangoCollection = require('@arangodb/arango-collection').ArangoCollection; var ArangoError = require('@arangodb').ArangoError; var ArangoStatement = require('@arangodb/arango-statement').ArangoStatement; // ////////////////////////////////////////////////////////////////////////////// // / @brief prints a database // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._PRINT = function (context) { context.output += this.toString(); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief strng representation of a database // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype.toString = function (seen, path, names, level) { return '[ArangoDatabase "' + this._name() + '"]'; }; // ////////////////////////////////////////////////////////////////////////////// // / @brief factory method to create a new statement // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._createStatement = function (data) { return new ArangoStatement(this, data); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief factory method to create and execute a new statement // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._query = function (query, bindVars, cursorOptions, options) { if (typeof query === 'object' && query !== null && arguments.length === 1) { return new ArangoStatement(this, query).execute(); } var payload = { query: query, bindVars: bindVars || undefined, count: (cursorOptions && cursorOptions.count) || false, batchSize: (cursorOptions && cursorOptions.batchSize) || undefined, options: options || undefined, cache: (options && options.cache) || undefined }; return new ArangoStatement(this, payload).execute(); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief explains a query // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._explain = function (query, bindVars, options) { if (typeof query === 'object' && typeof query.toAQL === 'function') { query = { query: query.toAQL() }; } if (arguments.length > 1) { query = { query: query, bindVars: bindVars, options: options }; } require('@arangodb/aql/explainer').explain(query); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock executeTransaction // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._executeTransaction = function (data) { return TRANSACTION(data); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock collectionDatabaseDrop // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._drop = function (name, options) { var collection = name; if (!(name instanceof ArangoCollection)) { collection = internal.db._collection(name); } if (collection === null) { return; } try { return collection.drop(options); } catch (err) { // ignore if the collection does not exist if (err instanceof ArangoError && err.errorNum === internal.errors.ERROR_ARANGO_COLLECTION_NOT_FOUND.code) { return; } // rethrow exception throw err; } }; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock collectionDatabaseTruncate // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._truncate = function (name) { var collection = name; if (!(name instanceof ArangoCollection)) { collection = internal.db._collection(name); } if (collection === null) { return; } collection.truncate(); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief index id regex // ////////////////////////////////////////////////////////////////////////////// // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock IndexVerify // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.indexRegex = /^([a-zA-Z0-9\-_]+)\/([0-9]+)$/; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock IndexHandle // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._index = function (id) { if (id.hasOwnProperty('id')) { id = id.id; } var pa = ArangoDatabase.indexRegex.exec(id); var err; if (pa === null) { err = new ArangoError(); err.errorNum = internal.errors.ERROR_ARANGO_INDEX_HANDLE_BAD.code; err.errorMessage = internal.errors.ERROR_ARANGO_INDEX_HANDLE_BAD.message; throw err; } var col = this._collection(pa[1]); if (col === null) { err = new ArangoError(); err.errorNum = internal.errors.ERROR_ARANGO_COLLECTION_NOT_FOUND.code; err.errorMessage = internal.errors.ERROR_ARANGO_COLLECTION_NOT_FOUND.message; throw err; } var indexes = col.getIndexes(); var i; for (i = 0; i < indexes.length; ++i) { var index = indexes[i]; if (index.id === id) { return index; } } return null; }; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock dropIndex // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._dropIndex = function (id) { if (id.hasOwnProperty('id')) { id = id.id; } var pa = ArangoDatabase.indexRegex.exec(id); var err; if (pa === null) { err = new ArangoError(); err.errorNum = internal.errors.ERROR_ARANGO_INDEX_HANDLE_BAD.code; err.errorMessage = internal.errors.ERROR_ARANGO_INDEX_HANDLE_BAD.message; throw err; } var col = this._collection(pa[1]); if (col === null) { err = new ArangoError(); err.errorNum = internal.errors.ERROR_ARANGO_COLLECTION_NOT_FOUND.code; err.errorMessage = internal.errors.ERROR_ARANGO_COLLECTION_NOT_FOUND.message; throw err; } return col.dropIndex(id); }; // ////////////////////////////////////////////////////////////////////////////// // / @brief was docuBlock endpoints // ////////////////////////////////////////////////////////////////////////////// ArangoDatabase.prototype._endpoints = function () { return internal._endpoints(); };