Introduction
In this article, we will discuss the basics of backbone models.
Background
When we talk about any MV* pattern, model is undoubtedly the most important part of the architecture/application. It's the model that contains all the application data. Along with keeping the data, the model class performs various set of actions on the data. Actions like possibility to validate the data, possibility to persist the data, defining access to various parts of data contained in the model (access control).
Backbone.js models are also the most important building blocks when it comes to building backbone.js applications. It keeps track of application data, performs validations on data and provides a mechanism to persist the data either locally on localstorage
or remotely on a server using a web service.
Link to complete series:
- BackBone Tutorial – Part 1: Introduction to Backbone.Js[^]
- BackBone Tutorial – Part 2: Understanding the basics of Backbone Models[^]
- BackBone Tutorial – Part 3: More about Backbone Models[^]
- BackBone Tutorial – Part 4: CRUD Operations on BackboneJs Models using HTTP REST Service[^]
- BackBone Tutorial – Part 5: Understanding Backbone.js Collections[^]
- BackBone Tutorial – Part 6: Understanding Backbone.js Views[^]
- BackBone Tutorial – Part 7: Understanding Backbone.js Routes and History[^]
- BackBone Tutorial – Part 8: Understanding Backbone.js Events[^]
Creating a Simple backbone.js Model
To create a backbone model, we simply need to extend the backbone model class. The following code snippet shows how this can be done.
var Book = Backbone.Model.extend({
});
Furthermore, if we want to create a model that inherits from our model
class, then we just need to extend from our model
class.
var ChildrensBook = Book.extend({
});
Instantiating a Model
Backbone models can simply be instantiated by using the new
keyword.
var book = new Book();
Deleting a Model
To delete a model, we just need to call the destroy
function on the model.
book.destroy();
Sometimes, deleting a model
could take some time (depending on the size of the model
). In such cases, we can define a function that will be called when the model
gets successfully deleted.
book.destroy({
success: function () {
alert("The model has been destroyed successfully");
}
});
Cloning a Model
Often times, we would want to have a deep copied object or clone of a model. To create a clone of a backbone model, we simply need to call the clone
method.
function cloneModel() {
var book = new Book();
var book2 = book.clone();
}
How to Specify the Model Attributes
Backbone models do not enforce defining the attributes in the model definition itself, i.e., one can create a model and specify the attributes on the fly. Let's say we want to create 2 attributes in our Book
model. Let's try to create them on the fly.
var book = new Book({
ID: 1,
BookName: "Sample book"
});
Default Values of Model Attributes
Now creating the attributes on the fly is supported by the backbone models and it is a very powerful feature. But this feature actually proves to be a maintenance nightmare when it comes to working with large scale application. From a maintainable application perspective and also from a best practices perspective, I would like the possibility to define my models attributes in my model definition itself.
To accomplish this, the default function can be used. The default function is used to specify the default attributes of the model and their default values. Let's try to move the attributes in the model definition now.
var Book = Backbone.Model.extend({
defaults: {
ID: "",
BookName: ""
},
});
This way, just instantiating the model will be enough and the created models will have these attributes associated with them.
Setting and Getting Model Attributes
Once we specify the model attributes, we need to be able to get and set their values too. To do this, we can use the get
and set
functions on the model.
var book = new Book();
book.set("ID", 3);
book.set("BookName", "C# in a nutshell");
var bookId = book.get('ID');
var bookName = book.get('BookName');
How to Check Attribute Existence
Since backbone allows us to add attributes on the fly, we need some way to identify whether a particular attribute exists in the model
or not. To do this, we can use the has
function on model
.
book.has('ID');
book.has('author');
Defining Functions in a Model
We can also define our functions in the model
classes. Let's try to create a simple function in our model
class.
var Book = Backbone.Model.extend({
defaults: {
ID: "",
BookName: ""
},
showAlert: function () {
alert('ID: ' + this.get('ID') + ', BookName: ' + this.get('BookName'));
}
});
The initialize Function
Whenever we create a model
, the backbone will call its initialize
function. We can override this function to provide custom behavior to it.
var Book = Backbone.Model.extend({
defaults: {
ID: "",
BookName: ""
},
initialize: function(){
console.log('Book has been initialized');
},
showAlert: function () {
alert('ID: ' + this.get('ID') + ', BookName: ' + this.get('BookName'));
}
});
Listening to Model Attribute Changes
We can also use the events to listen to the model changes. This can be done by listening to the change
event. Backbone raises a change
event whenever any model
attribute is changed. For each attribute, we can use hasChanged
method to check if that attribute has been changed or not. Let's try to hook up the event handler to listen to the model change in our current model.
var Book = Backbone.Model.extend({
defaults: {
ID: "",
BookName: ""
},
initialize: function(){
console.log('Book has been initialized');
this.on('change', function() {
if(this.hasChanged('ID')){
console.log('ID has been changed');
}
if(this.hasChanged('BookName')){
console.log('BookName has been changed');
}
});
},
showAlert: function () {
alert('ID: ' + this.get('ID') + ', BookName: ' + this.get('BookName'));
}
});
If we have a lot of attributes and we are interested in listening to change for any specific attribute, then perhaps we can specify that too in the change event binding. Let's try to listen to the BookName
change only.
var Book = Backbone.Model.extend({
defaults: {
ID: "",
BookName: ""
},
initialize: function () {
console.log('Book has been initialized');
this.on('change:BookName', function () {
console.log('Message from specific listener: BookName has been changed');
});
},
showAlert: function () {
alert('ID: ' + this.get('ID') + ', BookName: ' + this.get('BookName'));
}
});
Point of Interest
So that is it for this blog. The idea behind this article was to get familiar with the basic concepts of the backbone model. In the next article of this series, we will look at more advanced topics associated with the backbone model. This article has been written from a beginner’s perspective, I hope this has been informative.