Class HasOneOrMany<T, T2, V>

Base class for 1:1 and 1:M relations.

Type parameters

T: Model<T>
T2: Model<T2>
V: RelationValue<T2>

Hierarchy

Relation<T, T2, V>
- HasOneOrMany
  - HasOne
  - HasMany

Index

Constructors

constructor

Properties

Accessors

Methods

Constructors

Protected constructor

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

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

Properties

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

Overrides Relation.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>

Overrides Relation.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 Relation.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 Relation.fetch
- Defined in src/orm/model/relation/Relation.ts:61
Get a collection of the results of this relation.

Returns ResultCollection<T2>

Abstract get

get(): Promise<V>

Inherited from Relation.get
- Defined in src/orm/model/relation/Relation.ts:66
Resolve the result of this relation.

Returns Promise<V>

getContainer

getContainer(): Container

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

Returns Container

Abstract getValue

getValue(): V

Inherited from Relation.getValue
- Defined in src/orm/model/relation/Relation.ts:55
Get the value of the relation.

Returns V

Abstract isLoaded

isLoaded(): boolean

Inherited from Relation.isLoaded
- Defined in src/orm/model/relation/Relation.ts:58
Returns true if the relation has been loaded.

Returns boolean

make

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

Inherited from Relation.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>

Overrides Relation.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>

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

Returns RelationBuilder<T2>

setContainer

setContainer(ci: Container): HasOneOrMany<T, T2, V>

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

Parameters
- ci: Container
Returns HasOneOrMany<T, T2, V>

Abstract setValue

setValue(related: V): void

Inherited from Relation.setValue
- Defined in src/orm/model/relation/Relation.ts:52
Set the value of the relation.

Parameters
- related: V
Returns void

then

then(resolve: (result: V) => unknown, reject: (e: Error) => unknown): void

Inherited from Relation.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: V) => unknown
  - - (result: V): unknown
    - Parameters
      - result: V
      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.