Comments on Andrzej on Software: An application or a set of resources?

Hi Andrzej Commands are only used to modify data....

2011-02-15T16:08:16.245+01:00

Hi Andrzej

Commands are only used to modify data. For index and show actions we access the models "the rails way" directly in the controller (in simple cases) or we use presenters to transform complex object graphs from the domain model to the view model.

I think that the command pattern is not really needed if you have a very simple application. But when your domain model and business logic reaches a certain degree of complexity, it helps to manage that complexity.

Another benefit: Power users can use our commands directly within a "console" in our web application. They love it.

Best regards
Gernot

@Gernot I like it very much! I think you're u...

2011-02-15T14:41:37.605+01:00

@Gernot

I like it very much!
I think you're using the Context part from the DCI approach, see my previous blog post:

http://andrzejonsoftware.blogspot.com/2011/02/dci-and-rails.html

I want to experiment with it as well.

I think your Commands part is something that is popular in the Java/.Net world as the Application Logic. It's not very popular in the Rails world, though.

As for the application vs resources discussion - when you want to display all the users from your app, you simply call User.all directly from the Command?

The rule of thumb is that there is a command for e...

2011-02-15T13:23:46.649+01:00

The rule of thumb is that there is a command for each CRUD operation on a resource.

Here's an example from my problem domain, a rental contract. We have a resource rental_contracts. To create a new rental contract, we have a view that allows the user to select one or more people (the tenants), one or more objects to rent and several attributes for the contract.

Since the construction of such a contract is quite complex and carries a lot of business logic, we have a create_rental_contract command. The command accepts a params hash for its constructor, just like a model. Furthermore, it includes ActiveModel::Validations so it can validate the params.

In short, a command behaves like a model from the controller's point of view. The controller simply passes the params hash to the command, executes it and redirects to the "new"-view if there were validation errors. All validations are implemented in the commands, not in the models.

The create_rental_contract command then orchestrates the required state changes in the domain model. It creates the contract, adds the tentans and objects to the contracts, sets the contract objects to "not available for rental" and so on.

This approach imho has several advantages:

- Commands are easily testable
- Commands add context
- Commands encapsulate business transactions
- Commands do the transformation from the view model to the domain model (the view model is oftentimes simplified and hierarchical (Parent/Child) while the domain model is object oriented)

"The business logic is implemented in command...

2011-02-15T12:22:41.805+01:00

"The business logic is implemented in command classes. Only commands can change the state of objects. The controllers talk to commands, never directly to the domain model."

It sounds interesting. Could you show an example of controller-command-model communication?

After I really understood the REST philosophy (at ...

2011-02-15T11:48:40.115+01:00

After I really understood the REST philosophy (at least I think I got it), I see my applications as a set of resources and URIs to access these resources.
Users are resources, too. I do not model my applications user centric. Instead, I restrict the accessablility of resources based on an authorization model.
The authorization model defines what a user can see and do.

The business logic is implemented in command classes. Only commands can change the state of objects. The controllers talk to commands, never directly to the domain model.

This is a common architecture and it works really well for me, especially using the Rails framework. It scales well, is easy to understand and test.

A student of Zen once asked Buddha "Do you th...

2011-02-14T09:16:19.972+01:00

A student of Zen once asked Buddha "Do you think of your web application as an application or as a set of resources?".

Buddha replied "Do you think of your online resources as resources or parts of an application?"

At that moment, the student was enlightened.