OneToOne class

OneToOne relationship annotation

Defines a one-to-one relationship between entities. One side must be the owning side (has the FK column), the other is the inverse side.

Example:

// In UserEntity (inverse side - no FK column)
@OneToOne(
  targetEntity: ProfileEntity,
  mappedBy: 'user',  // Field name in ProfileEntity
)
ProfileEntity? profile;

// In ProfileEntity (owning side - has FK column)
@OneToOne(
  targetEntity: UserEntity,
  foreignKey: 'user_id',
  isOwning: true,
  onDelete: RelationAction.cascade,
)
UserEntity? user;

Constructors

OneToOne({required Type targetEntity, String? mappedBy, String? foreignKey, String referencedColumn = 'id', bool isOwning = false, bool cascadeDelete = false, bool lazyLoad = true, bool eagerLoad = false, bool nullable = true, bool unique = true, RelationAction onDelete = RelationAction.noAction, RelationAction onUpdate = RelationAction.noAction})
const

Properties

cascadeDelete bool
Whether to cascade delete operations
final
eagerLoad bool
Whether to eager load the relationship
final
foreignKey String?
Foreign key column name in this entity's table Required on the owning side (the side that has the FK column)
final
hashCode int
The hash code for this object.
no setterinherited
isOwning bool
Whether this is the owning side (has the FK column)
final
lazyLoad bool
Whether to lazy load the relationship
final
mappedBy String?
Field name in the target entity that owns the relationship Used on the inverse side to reference the owning side's field
final
nullable bool
Whether this relationship is nullable
final
onDelete RelationAction
Action to take on delete of referenced entity
final
onUpdate RelationAction
Action to take on update of referenced entity
final
referencedColumn String
Referenced column in the target entity (usually 'id')
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
targetEntity Type
The target entity type for this relationship
final
unique bool
Whether to enforce uniqueness on the FK column (ensures 1:1)
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited