Declares a belongs_to relationship. In a relational database, the foreign key would be on the source table.

This creates a field on the resource with the corresponding name, unless define_field?: false is provided.

Practically speaking, a belongs_to and a has_one are interchangable in every way.

Opts

• destination_field(atom): The field on the related resource that should match the source_field on this resource. - Default: :id
• source_field(atom): The field on this resource that should match the destination_field on the related resource. Default: [relationship_name]_id
• primary_key?(boolean): Whether this field is, or is part of, the primary key of a resource. - Default: false
• define_field?(boolean): If set to false a field is not created on the resource for this relationship, and one must be manually added in attributes. - Default: true
• field_type(atom): The field type of the automatically created field. - Default: :uuid

Examples

# In a resource called `Word`
belongs_to :dictionary_entry, DictionaryEntry,
  source_field: :text,
  destination_field: :word_text

Declares a has_many relationship. There can be any number of related entities.

Opts

• destination_field(atom): The field on the related resource that should match the source_field on this resource. Default: [resource.name]_id
• source_field(atom): The field on this resource that should match the destination_field on the related resource. - Default: :id

Examples

# In a resource called `Word`
has_many :definitions, DictionaryDefinition,
  source_field: :text,
  destination_field: :word_text

Declares a has_one relationship. In a relationsal database, the foreign key would be on the other table.

Generally speaking, a has_one also implies that the destination table is unique on that foreign key.

Practically speaking, a has_one and a belongs_to are interchangable in every way.

Opts

• destination_field(atom): The field on the related resource that should match the source_field on this resource. Default: [resource.name]_id
• source_field(atom): The field on this resource that should match the destination_field on the related resource. - Default: :id

Examples

# In a resource called `Word`
has_one :dictionary_entry, DictionaryEntry,
  source_field: :text,
  destination_field: :word_text

Declares a many_to_many relationship. Many to many relationships require a join table.

A join table is typically a table who's primary key consists of one foreign key to each resource.

You can specify a join table as a string or as another resource.

Opts

• through(atom | string) Required: Either a string representing a table/generic name for the join table or a module name of a resource.
• source_field_on_join_table(atom): The field on the join table that should line up with source_field on this resource. Default: [resource_name]_id
• destination_field_on_join_table(atom): The field on the join table that should line up with destination_field on the related resource. Default: [relationshihp_name]_id
• source_field(atom): The field on this resource that should line up with source_field_on_join_table on the join table. - Default: :id
• destination_field(atom): The field on the related resource that should line up with destination_field_on_join_table on the join table. - Default: :id

Examples

# In a resource called `Word`
many_to_many :books, Book,
  through: BookWord,
  source_field: :text,
  source_field_on_join_table: :word_text,
  destination_field: :id,
  destination_field_on_join_table: :book_id