I’ll admit it; I have a weight problem. Lately, my models have been getting fat.
Really fat.
To be honest, I didn’t see this coming. I thought I’ve been doing everything right. I’ve been keeping my views and controllers nice and thin, and I’ve been working hard to encapsulate complicated business logic into appropriately named model methods.
This might be a little awkward, but let me show you… Suppose we’ve got a Job Board application. In it, there’s a Jobs collection. We’re using dburles:collection-helpers
to build a simple Jobs model. Imagine that we want to allow users to close jobs they’ve created when the position is filled. Let’s create a model method that can be called from our controller layer (our Meteor method):
Jobs.helpers({
...
closeJob: () => {
Jobs.update(this._id, {
$set: {
closed: true
}
});
}
...
});
Ah, but wait. When a job closes we also need to email the job owner and congratulate them on successfully filling the position. Let’s update our model.
closeJob: () => {
Jobs.update(this._id, {
$set: {
closed: true
}
});
Email.send({
to: this.getOwner().getEmail(),
body: "Congrats on filling the position!"
});
}
After getting some user feedback, we’ve realized that we need to congratulate the person who filled the position. Also, we should notify all of the other applicants who applied, but didn’t get the job. Also, we need to do some housekeeping and update the Organization that this job belongs to.
Let’s get back to work on our model.
closeJob: () => {
Jobs.update(this._id, {
$set: {
closed: true
}
});
Email.send({
to: this.getOwner().getEmail(),
body: "Congrats on filling the position!"
});
Email.send({
to: this.getFiller().getEmail(),
body: "Congrats on landing the job!"
});
this.getApplicants().forEach(applicant => {
Email.send({
to: applicant.getEmail(),
body: "Sorry, but the job has been closed."
});
});
this.getOrganization().closeJob();
}
Whew, that looks mostly complete!
Though technically, job owners will close a job for a variety of reasons. Maybe they’ve found someone to fill the position, or maybe they’ve just decided to take the job off of the job board for other reasons. If they use the closeJob
model method, the system will send the job owner a congratulations email, and all applicants emails about the job being filled. That’s no good.
Maybe the solution is to pass in flags to determine whether we should kick off various emails:
closeJob: (congratulateOwner, congratulateFiller, notifyApplicants) => {
Jobs.update(this._id, {
$set: {
closed: true
}
});
if (congratulateOwner) {
Email.send({
to: this.getOwner().getEmail(),
body: "Congrats on filling the position!"
});
}
if (congratulateFiller) {
Email.send({
to: this.getFiller().getEmail(),
body: "Congrats on landing the job!"
});
}
if (notifyApplicants) {
this.getApplicants().forEach(applicant => {
Email.send({
to: applicant.getEmail(),
body: "Sorry, but the job has been closed."
});
});
}
this.getOrganization().closeJob();
}
The complexity of our model method is getting out of hand! The controller calling this method is forced to know much more about the internals of the method than it should. The bottom line is that our model is getting too fat.
So how do we shed all of this weight that’s built up on our model? We can find inspiration in more complicated system architectures and design philosophies such as Command Busses, Event Sourcing and even Domain Driven Design. All of these design patterns and philosophies make fundamental use of server-side events to segregate and organize functionality within large applications. By leveraging events in our application, we can make huge gains in terms of code cleanliness, understandability, and testability.
Let’s take a step back and think about our domain in reverse. We have a few things we want to do on every job closure. Whenever a job is closed because a suitable applicant was found, we want to send an email congratulating the job owner:
when("JobWasFilled", job => {
Email.send({
to: job.getOwner().getEmail(),
body: "Congrats on filling the position!"
});
});
We’ll also want to congratulate the user who filled the job:
when("JobWasFilled", job => {
Email.send({
to: job.getFiller().getEmail(),
body: "Congrats on landing the job!"
});
});
Any time a job posting is closed for any reason, we’ll want to notify all of our users who applied for that job:
when("JobWasClosed", job => {
job.getApplicants().forEach(applicant => {
Email.send({
to: applicant.getEmail(),
body: "Sorry, but the job has been closed."
});
});
});
And we also want to always update the job’s parent organization:
when("JobWasClosed", job => {
job.getOrganization().closeJob();
});
All of these pieces of code can live in their own files on the server. We can organize them in such a way that makes immediate sense to anyone looking at the structure of our project:
server/
listeners/
jobWasClosed/
closeJobOnOrganization.js
notifyOtherApplicants.js
jobWasFilled/
congratulateOwner.js
congratulateFiller.js
Now, our closeJob
model method is incredibly simple, straight forward, and best of all, only has to worry about the model:
closeJob: () => {
Jobs.update(this._id, {
$set: {
closed: true
}
});
EventEmitter.emit("JobWasClosed", this);
}
We’ll also need to emit the JobWasFilled
event from our method layer:
Meteor.methods({
fillJob: jobId => {
...
job.closeJob();
EventEmitter.emit("JobWasFilled", job);
}
});
Now, when a job is filled, the JobWasClosed
event will be fired by the model, and the JobWasFilled
event will be fired by our method layer. Our listeners will pick up on these events and do their duty. If closeJob
is called through some other means, our JobWasClosed
listeners will be triggered, but the JobWasFilled
listeners will not. Perfect!
I feel so thin!
Server-side events are an architectural gem that can be easily incorporated into most applications to provide clean, easy decoupling of components. Events let you cleanly separate functionality, organize it into easy to understand chunks, better reason about the workings of your application, and more effectively write tests.
If you decide to start using events in your applications, I highly recommend spending a few dollars and watching this excellent Laracasts series on Commands and Domain Events. It’s targeted towards PHP developers using the Laravel framework, but the ideas are completely applicable to any software project. Jeffrey Way is an excellent teacher and masterfully presents the ideas and benefits behind server-side events.