HasMany relations

</figure>

The target model, Order, has a property, customerId, as the foreign key to reference the declaring model (Customer) primary key id.

Defining a hasMany relation

Use the relation generator  to create a relation between two models. The tool will prompt you to enter the name of the model, the name of related model, and other required information. The tool will then modify the model definition JSON file (for example, common/models/customer.json) accordingly.

For example, here is the model JSON file for the customer model in loopback-example-relations:

{
  "name": "Customer",
  "base": "PersistedModel",
  ...
  "relations": {
    "orders": {
      "type": "hasMany",
      "model": "Order",
      "foreignKey": "customerId",
      "primaryKey": "id" // optional
    },
  ...

Alternatively, you can define the relation in code, though in general this is not recommended:

Customer.hasMany(Review, {as: 'reviews', foreignKey: 'authorId'});

If not specified, LoopBack derives the relation name and foreign key as follows:

• Relation name: The plural form of the camel case of the model name; for example, for model name “Order” the relation name is “orders”.
• Foreign key: The camel case of the declaring model name appended with Id, for example, for model name “Customer” the foreign key is “customerId”.

Methods added to the model

Once you define a “hasMany” relation, LoopBack adds a method with the relation name to the declaring model class’s prototype automatically. For example: Customer.prototype.orders(...).

The relation can return a promise by calling the find() method on the relation property.

customer.orders([filter],
  function(err, orders) {
  ...
});

var order = customer.orders.build(data);

var order = new Order({customerId: customer.id, ...});

customer.orders.create(data,
  function(err, order) {
  ...
});

Order.create({customerId: customer.id, ...},
  function(err, order) {
  ...
});

customer.orders.destroyAll(function(err) {
  ...
});

customer.orders.findById(orderId,
  function(err, order) {
   ...
});

customer.orders.destroy(orderId,
  function(err) {
  ...
});

customer.orders.find().then(function(orders) { ... });