Question

Example: an Order object (aggregate root) has a collection of OrderLine objects (child entities). What’s the URL add an OrderLine to an Order? Take into consideration the difference between using the aggregate roots’ controller and having a separate controller for the child entity.

1: http://example.com/orders/add-orderline?order-id=42&product-id=12&quantity=2

or

2: http://example.com/order-lines/add?order-id=42&product-id=12&quantity=2

Thanks!

Answer 1

Follow your domain model.

Does an Orderline object exist, and can actions be taken with it? (Not object in code, object in real-life according to the domain.) Most likely not, or it would be the aggregate root.

The Order object exists, and you are adding an Orderline to it. So the root object is the Order, with the action of adding an Orderline.

Your URL route would follow that, with a controller for the object, and an action of adding an Orderline.

From your examples this is the one that follows that logic:

http://example.com/orders/add-orderline?order-id=42&product-id=12&quantity=2