OpenVeo server API for plugins

API Docs for: 4.3.1
Show:

MongoDatabase

Extends Database
Defined in: lib/storages/databases/mongodb/MongoDatabase.js:15
Module: storages

Summary

Defines a MongoDB Database.

Constructor

MongoDatabase

Defined in lib/storages/databases/mongodb/MongoDatabase.js:15

Syntax

MongoDatabase

(
  • configuration
)

Summary

Parameters:

  • configuration Object

    A database configuration object

    • host String

      MongoDB server host

    • port Number

      MongoDB server port

    • database String

      The name of the database

    • username String

      The name of the database user

    • password String

      The password of the database user

    • [replicaSet] String optional

      The name of the ReplicaSet

    • [seedlist] String optional

      The comma separated list of secondary servers

Methods

add

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:231

Syntax

add

(
  • collection
  • documents
  • callback
)
async

Summary

Inserts several documents into a collection.

Parameters:

  • collection String

    The collection to work on

  • documents Array

    Document(s) to insert into the collection

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Number The total amount of documents inserted

buildFields

Defined in lib/storages/databases/mongodb/MongoDatabase.js:142

Syntax

buildFields

(
  • fields
  • doesInclude
)
Object static

Summary

Builds MongoDb fields projection.

Parameters:

  • fields Array

    The list of fields to include or exclude

  • doesInclude Boolean

    true to include fields and exclude all other fields or false to exclude fields and include all other fields

Returns:

Object:

The MongoDB projection description object

buildFilter

Defined in lib/storages/databases/mongodb/MongoDatabase.js:71

Syntax

buildFilter

(
  • resourceFilter
)
Object static

Summary

Builds MongoDb filter from a ResourceFilter.

Parameters:

Returns:

Object:

The MongoDB like filter description object

buildSort

Defined in lib/storages/databases/mongodb/MongoDatabase.js:164

Syntax

buildSort

(
  • [sort]
)
Object static

Summary

Builds MongoDB sort object.

Concretely it just replaces "asc" by 1 and "desc" by -1.

Parameters:

  • [sort] Object optional

    The list of fields to sort by with the field name as key and the sort order as value (e.g. {field1: 'asc', field2: 'desc'})

Returns:

Object:

The MongoDB sort description object

close

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:219

Syntax

close

(
  • callback
)
async

Summary

Closes connection to the database.

Parameters:

  • callback Function

    The function to call when connection is closed

    • Error The error if an error occurred, null otherwise

connect

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:184

Syntax

connect

(
  • callback
)
async

Summary

Establishes connection to the database.

Parameters:

  • callback Function

    The function to call when connection to the database is established

    • Error The error if an error occurred, null otherwise

createIndexes

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:446

Syntax

createIndexes

(
  • collection
  • indexes
  • callback
)
async

Summary

Creates indexes for a collection.

Parameters:

  • collection String

    The collection to work on

  • indexes Array

    A list of indexes using MongoDB format

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Object Information about the operation

get

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:344

Syntax

get

(
  • collection
  • [filter]
  • [fields]
  • [limit]
  • [page]
  • [sort]
  • callback
)
async

Summary

Fetches documents from the collection.

Parameters:

  • collection String

    The collection to work on

  • [filter] ResourceFilter optional

    Rules to filter documents

  • [fields] Object optional

    Expected resource fields to be included or excluded from the response, by default all fields are returned. Only "exclude" or "include" can be specified, not both

    • [include] Array optional

      The list of fields to include in the response, all other fields are excluded

    • [exclude] Array optional

      The list of fields to exclude from response, all other fields are included. Ignored if include is also specified.

  • [limit] Number optional

    A limit number of documents to retrieve (10 by default)

  • [page] Number optional

    The page number started at 0 for the first page

  • [sort] Object optional

    The list of fields to sort by with the field name as key and the sort order as value (e.g. {field1: 'asc', field2: 'desc'})

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Array The list of retrieved documents
    • Object Pagination information
      • Number limit The specified limit
      • Number page The actual page
      • Number pages The total number of pages
      • Number size The total number of documents

getIndexes

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:427

Syntax

getIndexes

(
  • collection
  • callback
)
async

Summary

Gets the list of indexes for a collection.

Parameters:

  • collection String

    The collection to work on

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Array The list of indexes

getOne

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:400

Syntax

getOne

(
  • collection
  • [filter]
  • [fields]
  • callback
)
async

Summary

Fetches a single document from the storage.

Parameters:

  • collection String

    The collection to work on

  • [filter] ResourceFilter optional

    Rules to filter documents

  • [fields] Object optional

    Expected document fields to be included or excluded from the response, by default all fields are returned. Only "exclude" or "include" can be specified, not both

    • [include] Array optional

      The list of fields to include in the response, all other fields are excluded

    • [exclude] Array optional

      The list of fields to exclude from response, all other fields are included. Ignored if include is also specified.

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Object The document

getStore

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:466

Syntax

getStore

(
  • collection
)
Store

Summary

Gets an express-session store for this database.

Parameters:

  • collection String

    The collection to work on

Returns:

Store:

An express-session store

remove

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:256

Syntax

remove

(
  • collection
  • [filter]
  • callback
)
async

Summary

Removes several documents from a collection.

Parameters:

  • collection String

    The collection to work on

  • [filter] ResourceFilter optional

    Rules to filter documents to remove

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Number The number of deleted documents

removeCollection

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:504

Syntax

removeCollection

(
  • collection
  • callback
)
async

Summary

Remove a collection from the database

Parameters:

  • collection String

    The collection to work on

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise

removeField

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:283

Syntax

removeField

(
  • collection
  • property
  • [filter]
  • callback
)
async

Summary

Removes a property from documents of a collection.

Parameters:

  • collection String

    The collection to work on

  • property String

    The name of the property to remove

  • [filter] ResourceFilter optional

    Rules to filter documents to update

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Number The number of updated documents

renameCollection

Inherited from Database but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:477

Syntax

renameCollection

(
  • collection
  • target
  • callback
)
async

Summary

Renames a collection.

Parameters:

  • collection String

    The collection to work on

  • target String

    The new name of the collection

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise

update

Inherited from Storage but overwritten in lib/storages/databases/mongodb/MongoDatabase.js:316

Syntax

update

(
  • collection
  • [filter]
  • data
  • callback
)
async

Summary

Updates documents from collection.

Parameters:

  • collection String

    The collection to work on

  • [filter] ResourceFilter optional

    Rules to filter documents to update

  • data Object

    The modifications to perform

  • callback Function

    The function to call when it's done

    • Error The error if an error occurred, null otherwise
    • Number The number of updated documents

Properties

configuration

Inherited from Storage: lib/storages/Storage.js:25

Syntax

configuration

Object final

Summary

The storage configuration.

database

Defined in lib/storages/databases/mongodb/MongoDatabase.js:53

Syntax

database

Db final

Summary

The connected database.

host

Inherited from Database: lib/storages/databases/Database.js:31

Syntax

host

String final

Summary

Database host.

name

Inherited from Database: lib/storages/databases/Database.js:49

Syntax

name

String final

Summary

Database name.

password

Inherited from Database: lib/storages/databases/Database.js:67

Syntax

password

String final

Summary

Database user password.

port

Inherited from Database: lib/storages/databases/Database.js:40

Syntax

port

Number final

Summary

Database port.

replicaSet

Defined in lib/storages/databases/mongodb/MongoDatabase.js:35

Syntax

replicaSet

String final

Summary

The name of the replica set.

seedlist

Defined in lib/storages/databases/mongodb/MongoDatabase.js:44

Syntax

seedlist

String final

Summary

A comma separated list of secondary servers.

username

Inherited from Database: lib/storages/databases/Database.js:58

Syntax

username

String final

Summary

Database user name.