Class HasMany<T, T2>

One-to-many relation implementation.

Type parameters

T: Model<T>
T2: Model<T2>

Hierarchy

HasOneOrMany<T, T2, Collection<T2>>
- HasMany

Index

Constructors

constructor

Properties

Accessors

Methods

Constructors

constructor

new HasMany<T, T2>(parent: T, related: T2, foreignKeyOverride?: keyof T & string, localKeyOverride?: keyof T2 & string): HasMany<T, T2>

Overrides HasOneOrMany.constructor
- Defined in src/orm/model/relation/HasMany.ts:12
Type parameters
- T: Model<T, T>
- T2: Model<T2, T2>
Parameters
- parent: T
- related: T2
- Optional foreignKeyOverride: keyof T & string
- Optional localKeyOverride: keyof T2 & string
Returns HasMany<T, T2>

Properties

Protected cachedLoaded

cachedLoaded: boolean = false

Protected Optional cachedValue

cachedValue: Collection<T2>

Protected Optional foreignKeyOverride

foreignKeyOverride: keyof T & string

Protected Optional localKeyOverride

localKeyOverride: keyof T2 & string

Protected parent

parent: T

Readonly related

related: T2

Accessors

foreignKey

get foreignKey(): string

- Defined in src/orm/model/relation/HasOneOrMany.ts:27
Get the name of the foreign key for this relation.

Returns string

localKey

get localKey(): string

- Defined in src/orm/model/relation/HasOneOrMany.ts:32
Get the name of the local key for this relation.

Returns string

parentValue

get parentValue(): any

- Defined in src/orm/model/relation/HasOneOrMany.ts:47
Get the value of the pivot for this relation from the parent model.

Returns any

qualifiedForeignKey

get qualifiedForeignKey(): string

- Defined in src/orm/model/relation/HasOneOrMany.ts:37
Get the fully-qualified name of the foreign key.

Returns string

qualifiedLocalKey

get qualifiedLocalKey(): string

- Defined in src/orm/model/relation/HasOneOrMany.ts:42
Get the fully-qualified name of the local key.

Returns string

relatedQuerySource

get relatedQuerySource(): QuerySource

- Defined in src/orm/model/relation/Relation.ts:102
Get the query source for the related model in this relation.

Returns QuerySource

value

get value(): V

- Defined in src/orm/model/relation/Relation.ts:97
Get the value of this relation.

Returns V

Methods

applyScope

applyScope(where: AbstractBuilder<T2>): void

Inherited from HasOneOrMany.applyScope
- Defined in src/orm/model/relation/HasOneOrMany.ts:59
Apply the relation's constraints on a model query.

Parameters
- where: AbstractBuilder<T2>
Returns void

buildEagerQuery

buildEagerQuery(parentQuery: ModelBuilder<T>, result: Collection<T>): ModelBuilder<T2>

Inherited from HasOneOrMany.buildEagerQuery
- Defined in src/orm/model/relation/HasOneOrMany.ts:67
Create an eager-load query matching this relation's models.

Parameters
- parentQuery: ModelBuilder<T>
- result: Collection<T>
Returns ModelBuilder<T2>

builder

builder(): RelationBuilder<T2>

Inherited from HasOneOrMany.builder
- Defined in src/orm/model/relation/Relation.ts:108
Get a new builder instance for this relation.

Returns RelationBuilder<T2>

fetch

fetch(): ResultCollection<T2>

Inherited from HasOneOrMany.fetch
- Defined in src/orm/model/relation/Relation.ts:61
Get a collection of the results of this relation.

Returns ResultCollection<T2>

get

get(): Promise<Collection<T2>>

Overrides HasOneOrMany.get
- Defined in src/orm/model/relation/HasMany.ts:24
Resolve the result of this relation.

Returns Promise<Collection<T2>>

getContainer

getContainer(): Container

Inherited from HasOneOrMany.getContainer
- Defined in src/di/InjectionAware.ts:23
Get the container for this instance.

Returns Container

getValue

getValue(): Collection<T2>

Overrides HasOneOrMany.getValue
- Defined in src/orm/model/relation/HasMany.ts:35
Get the value of this relation.

Returns Collection<T2>

isLoaded

isLoaded(): boolean

Overrides HasOneOrMany.isLoaded
- Defined in src/orm/model/relation/HasMany.ts:44
Returns true if the relation has been loaded.

Returns boolean

make

make<T>(target: any, ...parameters: any[]): T

Inherited from HasOneOrMany.make
- Defined in src/di/InjectionAware.ts:28
Instantiate a new injectable using the container.

Type parameters
- T
Parameters
- target: any
- Rest ...parameters: any[]
Returns T

matchResults

matchResults(possiblyRelated: Collection<T>): Collection<T>

Inherited from HasOneOrMany.matchResults
- Defined in src/orm/model/relation/HasOneOrMany.ts:77
Given a collection of results, filter out those that are relevant to this relation.

Parameters
- possiblyRelated: Collection<T>
Returns Collection<T>

query

query(): RelationBuilder<T2>

Inherited from HasOneOrMany.query
- Defined in src/orm/model/relation/HasOneOrMany.ts:54
Create a new query for this relation.

Returns RelationBuilder<T2>

setContainer

setContainer(ci: Container): HasMany<T, T2>

Inherited from HasOneOrMany.setContainer
- Defined in src/di/InjectionAware.ts:17
Set the container for this instance.

Parameters
- ci: Container
Returns HasMany<T, T2>

setValue

setValue(related: Collection<T2>): void

Overrides HasOneOrMany.setValue
- Defined in src/orm/model/relation/HasMany.ts:29
Set the value of this relation.

Parameters
- related: Collection<T2>
Returns void

then

then(resolve: (result: Collection<T2>) => unknown, reject: (e: Error) => unknown): void

Inherited from HasOneOrMany.then
- Defined in src/orm/model/relation/Relation.ts:80
Makes the relation "thenable" so relation methods on models can be awaited to yield the result of the relation.
example
```
const rows = await myModelInstance.myHasManyRelation()  -- rows is a Collection
```
Parameters
- resolve: (result: Collection<T2>) => unknown
  - - (result: Collection<T2>): unknown
    - Parameters
      - result: Collection<T2>
      Returns unknown
- reject: (e: Error) => unknown
  - - (e: Error): unknown
    - Parameters
      - e: Error
      Returns unknown
Returns void

extollo (v. latin) - to lift up, to elevate

Extollo is a free & libre application framework in TypeScript.