tramway-connection-arangodb v1.3.0

Tramway ArangoProvider is a simple Provider add-on to simplify the process of implementing calls to arangodb databases and provides an async/await wrapper on the arangojs module.

Installation:

1. npm install tramway-connection-arangodb --save

Example project

https://gitlab.com/tramwayjs/tramway-connection-example

Documentation

Recommended Folder Structure in addition to Tramway

• config
• providers
• repositories
• entities

ArangoProvider

The ArangoProvider is a derived Provider which follows the same interface.

Configuration parameters

Getting started

Add the following to the imports and exports of the global parameters /config/parameters/global/index.js

import { config as arangoConfig } from 'tramway-connection-arangodb';
export default {
    ...arangoConfig.parameters,
}

Add the following to the imports and exports of the services parameters /config/services/index.js

import { config as arangoConfig } from 'tramway-connection-arangodb';

export default {
    ...arangoConfig.arangoServices,
};

Ensure the following environment variables are configured with the proper credentials:

ARANGO_PORT=8529
ARANGO_USERNAME=username
ARANGO_ROOT_PASSWORD=password
ARANGO_HOST=hostname
ARANGO_DATABASE=database

Exposed Methods with this Library

Provider

Note, the extended ArangoProvider expects an additional parameter collectionName on most methods. Using the ArangoRepository handles this for you. In addition, bulk inserts are possible.

Collection Types

The following collection types are supported when creating a new Collection:

Creating collections for graphs will require an additional step in their creation to avoid creating a new set of CRUD methods, or adding additional options to the existing and consistent interface. The provider contains its own resolvers to map collections to types and collections to graphs.

Creating a regular collection can be done in a repository setup method as follows:

    try {
        info = await this.provider.createCollection(this.collection, ArangoProvider.COLLECTION_TYPE_EDGE);
    } catch(e) {
        throw e;
    }

Creating a graph collection will require an additional step to register the collection graph.

    try {
        info = await this.provider.createCollection(this.collection, ArangoProvider.COLLECTION_TYPE_GRAPH_VERTEX);
        this.registerCollectionGraph(this.collection, graphName)
    } catch(e) {
        throw e;
    }

Index Types

The following index types are supported when creating a new Collection:

Creating an index in a repository setup method can be done as follows:

    try {
        info = await this.provider.createIndex(this.collection, ['field1'], ArangoProvider.INDEX_TYPE_HASH, {unique: true, sparse: false});
    } catch(e) {
        throw e;
    }

Creating a Graph

Creating a graph in a repository setup method can be done as follows:

    try {
        info = await this.provider.createGraph(graphName, {
            edgeDefinitions: [
                {
                    collection: 'edges',
                    from: ['start-vertices'],
                    to: ['end-vertices']
                },
            ]
        });
    } catch(e) {
        throw e;
    }

The graph properties uses the same interface as specified in the ArangoDB JS Driver docs.

Repository