MongoDriver

Hierarchy

• DatabaseDriver<MongoConnection>
  • MongoDriver

Index

Constructors

• constructor

Properties

• [EntityManagerType]
• config

Methods

• aggregate
• close
• connect
• convertException
• count
• countVirtual
• createEntityManager
• find
• findOne
• findVirtual
• getConnection
• getDependencies
• getMetadata
• getPlatform
• loadFromPivotTable
• lockPessimistic
• mapResult
• nativeDelete
• nativeInsert
• nativeInsertMany
• nativeUpdate
• nativeUpdateMany
• reconnect
• setMetadata
• syncCollections

Constructors

constructor

• new MongoDriver(config: Configuration<IDatabaseDriver<Connection>, EntityManager<IDatabaseDriver<Connection>>>): MongoDriver

• Overrides DatabaseDriver<MongoConnection>.constructor

  Parameters

  • config: Configuration<IDatabaseDriver<Connection>, EntityManager<IDatabaseDriver<Connection>>>

  Returns MongoDriver

Properties

[EntityManagerType]

[EntityManagerType]: MongoEntityManager<MongoDriver>

Overrides DatabaseDriver.[EntityManagerType]

readonlyconfig

config: Configuration<IDatabaseDriver<Connection>, EntityManager<IDatabaseDriver<Connection>>>

Inherited from DatabaseDriver.config

Methods

aggregate

• aggregate(entityName: string, pipeline: any[], ctx?: ClientSession): Promise<any[]>

• Overrides DatabaseDriver.aggregate

  Parameters

  • entityName: string

  • pipeline: any[]

  • optionalctx: ClientSession

  Returns Promise<any[]>

close

• close(force?: boolean): Promise<void>

• Inherited from DatabaseDriver.close

  Parameters

  • optionalforce: boolean

  Returns Promise<void>

connect

• connect(): Promise<MongoConnection>

• Inherited from DatabaseDriver.connect

  Returns Promise<MongoConnection>

convertException

• convertException(exception: Error): DriverException

• Inherited from DatabaseDriver.convertException

  Converts native db errors to standardized driver exceptions

  ---

  Parameters

  • exception: Error

  Returns DriverException

count

• count<T>(entityName: string, where: FilterQuery<T>, options?: CountOptions<T, never>, ctx?: ClientSession): Promise<number>

• Overrides DatabaseDriver.count

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: CountOptions<T, never> = {}

  • optionalctx: ClientSession

  Returns Promise<number>

countVirtual

• countVirtual<T>(entityName: string, where: FilterQuery<T>, options: CountOptions<T, any>): Promise<number>

• Inherited from DatabaseDriver.countVirtual

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: CountOptions<T, any>

  Returns Promise<number>

createEntityManager

• createEntityManager<D>(useContext?: boolean): D[typeof EntityManagerType]

• Overrides DatabaseDriver.createEntityManager

  Type parameters

  • D: IDatabaseDriver<Connection> = IDatabaseDriver<Connection>

  Parameters

  • optionaluseContext: boolean

  Returns D[typeof EntityManagerType]

find

• find<T, P, F, E>(entityName: string, where: FilterQuery<T>, options?: FindOptions<T, P, F, E>): Promise<EntityData<T>[]>

• Overrides DatabaseDriver.find

  Finds selection of entities

  ---

  Type parameters

  • T: object
  • P: string = never
  • F: string = *
  • E: string = never

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: FindOptions<T, P, F, E> = {}

  Returns Promise<EntityData<T>[]>

findOne

• findOne<T, P, F, E>(entityName: string, where: FilterQuery<T>, options?: FindOneOptions<T, P, F, E>): Promise<null | EntityData<T>>

• Overrides DatabaseDriver.findOne

  Finds single entity (table row, document)

  ---

  Type parameters

  • T: object
  • P: string = never
  • F: string = ALL
  • E: string = never

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: FindOneOptions<T, P, F, E> = ...

  Returns Promise<null | EntityData<T>>

findVirtual

• findVirtual<T>(entityName: string, where: FilterQuery<T>, options: FindOptions<T, any, any, any>): Promise<EntityData<T>[]>

• Overrides DatabaseDriver.findVirtual

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: FindOptions<T, any, any, any>

  Returns Promise<EntityData<T>[]>

getConnection

• getConnection(type?: ConnectionType): MongoConnection

• Inherited from DatabaseDriver.getConnection

  Parameters

  • type: ConnectionType = 'write'

  Returns MongoConnection

getDependencies

• getDependencies(): string[]

• Inherited from DatabaseDriver.getDependencies

  Returns name of the underlying database dependencies (e.g. mongodb or mysql2) for SQL drivers it also returns knex in the array as connectors are not used directly there

  ---

  Returns string[]

getMetadata

• getMetadata(): MetadataStorage

• Inherited from DatabaseDriver.getMetadata

  Returns MetadataStorage

getPlatform

• getPlatform(): MongoPlatform

• Overrides DatabaseDriver.getPlatform

  Returns MongoPlatform

loadFromPivotTable

• loadFromPivotTable<T, O>(prop: EntityProperty<any, any>, owners: (O extends { [PrimaryKeyProp]?: PK } ? PK extends keyof O ? ReadonlyPrimary<UnwrapPrimary<O[PK]>> : PK extends keyof O[] ? ReadonlyPrimary<PrimaryPropToType<O, PK>> : PK : O extends { _id?: PK } ? string | ReadonlyPrimary<PK> : O extends { uuid?: PK } ? ReadonlyPrimary<PK> : O extends { id?: PK } ? ReadonlyPrimary<PK> : O)[][], where?: any, orderBy?: OrderDefinition<T>, ctx?: any, options?: FindOptions<T, any, any, any>, pivotJoin?: boolean): Promise<Dictionary<T[]>>

• Inherited from DatabaseDriver.loadFromPivotTable

  When driver uses pivot tables for M:N, this method will load identifiers for given collections from them

  ---

  Type parameters

  • T: object
  • O: object

  Parameters

  • prop: EntityProperty<any, any>

  • owners: (O extends { [PrimaryKeyProp]?: PK } ? PK extends keyof O ? ReadonlyPrimary<UnwrapPrimary<O[PK]>> : PK extends keyof O[] ? ReadonlyPrimary<PrimaryPropToType<O, PK>> : PK : O extends { _id?: PK } ? string | ReadonlyPrimary<PK> : O extends { uuid?: PK } ? ReadonlyPrimary<PK> : O extends { id?: PK } ? ReadonlyPrimary<PK> : O)[][]

  • optionalwhere: any

  • optionalorderBy: OrderDefinition<T>

  • optionalctx: any

  • optionaloptions: FindOptions<T, any, any, any>

  • optionalpivotJoin: boolean

  Returns Promise<Dictionary<T[]>>

lockPessimistic

• lockPessimistic<T>(entity: T, options: LockOptions): Promise<void>

• Inherited from DatabaseDriver.lockPessimistic

  Type parameters

  • T: object

  Parameters

  • entity: T

  • options: LockOptions

  Returns Promise<void>

mapResult

• mapResult<T>(result: EntityDictionary<T>, meta?: EntityMetadata<T>, populate?: PopulateOptions<T>[]): null | EntityData<T>

• Inherited from DatabaseDriver.mapResult

  Type parameters

  • T: object

  Parameters

  • result: EntityDictionary<T>

  • optionalmeta: EntityMetadata<T>

  • populate: PopulateOptions<T>[] = []

  Returns null | EntityData<T>

nativeDelete

• nativeDelete<T>(entityName: string, where: FilterQuery<T>, options?: { ctx?: ClientSession }): Promise<QueryResult<T>>

• Overrides DatabaseDriver.nativeDelete

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • options: { ctx?: ClientSession } = {}

  Returns Promise<QueryResult<T>>

nativeInsert

• nativeInsert<T>(entityName: string, data: EntityDictionary<T>, options?: NativeInsertUpdateOptions<T>): Promise<QueryResult<T>>

• Overrides DatabaseDriver.nativeInsert

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • data: EntityDictionary<T>

  • options: NativeInsertUpdateOptions<T> = {}

  Returns Promise<QueryResult<T>>

nativeInsertMany

• nativeInsertMany<T>(entityName: string, data: EntityDictionary<T>[], options?: NativeInsertUpdateManyOptions<T>): Promise<QueryResult<T>>

• Overrides DatabaseDriver.nativeInsertMany

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • data: EntityDictionary<T>[]

  • options: NativeInsertUpdateManyOptions<T> = {}

  Returns Promise<QueryResult<T>>

nativeUpdate

• nativeUpdate<T>(entityName: string, where: FilterQuery<T>, data: EntityDictionary<T>, options?: NativeInsertUpdateOptions<T> & UpsertOptions<T>): Promise<QueryResult<T>>

• Overrides DatabaseDriver.nativeUpdate

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>

  • data: EntityDictionary<T>

  • options: NativeInsertUpdateOptions<T> & UpsertOptions<T> = {}

  Returns Promise<QueryResult<T>>

nativeUpdateMany

• nativeUpdateMany<T>(entityName: string, where: FilterQuery<T>[], data: EntityDictionary<T>[], options?: NativeInsertUpdateOptions<T> & UpsertManyOptions<T>): Promise<QueryResult<T>>

• Overrides DatabaseDriver.nativeUpdateMany

  Type parameters

  • T: object

  Parameters

  • entityName: string

  • where: FilterQuery<T>[]

  • data: EntityDictionary<T>[]

  • options: NativeInsertUpdateOptions<T> & UpsertManyOptions<T> = {}

  Returns Promise<QueryResult<T>>

reconnect

• reconnect(): Promise<MongoConnection>

• Inherited from DatabaseDriver.reconnect

  Returns Promise<MongoConnection>

setMetadata

• setMetadata(metadata: MetadataStorage): void

• Inherited from DatabaseDriver.setMetadata

  Parameters

  • metadata: MetadataStorage

  Returns void

syncCollections

• syncCollections<T, O>(collections: Iterable<Collection<T, O>>, options?: DriverMethodOptions): Promise<void>

• Inherited from DatabaseDriver.syncCollections

  Type parameters

  • T: object
  • O: object

  Parameters

  • collections: Iterable<Collection<T, O>>

  • optionaloptions: DriverMethodOptions

  Returns Promise<void>