HasOne<R extends Model> class final

hasOne: like HasMany but a single row.

Inheritance

• Object
• Relation<R>
• HasMany<R>
• HasOne

Constructors

HasOne(ModelDefinition<R> related(), {required String foreignKey, String localKey = 'id'})

Properties

foreignKey → String

final, inherited

hashCode → int

The hash code for this object.

no setter, inherited

localKey → String

final, inherited

matchColumns → List<String>

The related rows' columns this relation matches them on (its foreign or owner key): added back when an eager load selects columns without them (with_('user:name') still reads users.id).

no setter, inherited

name ↔ String

Name under which the relation is registered (set by the definition).

getter/setter pair, inherited

parentColumns → List<String>

The parent rows' columns this relation reads (its local or foreign key): added to a parent query that selects columns without them, so the relation can still be loaded from its rows.

no setter, inherited

related → ModelDefinition<R>

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

correlated(ModelDefinition<Model> parent, DatabaseManager db) → ModelQuery<R>

A query on the related table correlated with the parent table, for whereHas / withCount.

inherited

create(Model parent, DatabaseManager db, Map<String, Object?> attributes) → Future<R>

Creates a related model with the foreign key set.

inherited

eagerLoad(List<Model> parents, DatabaseManager db, [RelationConstraint? constraint]) → Future<void>

Loads the relation for many parents in one batched query and stores the result on each parent under name.

override

existenceQuery(ModelDefinition<Model> parent, DatabaseManager db, {required String parentTable}) → ModelQuery<R>

correlated against the parent table as parentTable names it (an alias inside a self-relation subquery). The built-in relations alias their own table when it has the parent's name (categories whose children are categories); custom relations fall back to correlated.

inherited

latestOfMany([String column = 'id']) → HasOne<R>

latestOfMany(): the row with the largest column of a has-many.

loadedModels(List<Model> parents) → List<Model>

The models loaded under name on parents, flattened (for nested eager loading).

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

ofMany(String column, String aggregate) → HasOne<R>

ofMany('score', 'max'). Eager loading reads one row per parent, with a correlated subquery. Rows with the same column go by the primary key.

oldestOfMany([String column = 'id']) → HasOne<R>

oldestOfMany(): the row with the smallest column.

queryFor(Model parent, DatabaseManager db) → ModelQuery<R>

Query returning the related models of one parent.

override

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited