Adds AJAX HTTP interactions to Halogen Models.
Adds a 'fetch' method for loading a Hypermedia resource from a server, and a 'execute' method for serialising and sending Command data to a server.
Install with npm(1):
$ npm install --save halogen-resource
If you don't already have grunt..
$ npm install -g grunt-cli
After cloning the repo..
$ npm install
To run the tests
$ npm test
Instead of ...
var Model = require('halogen-model').Model;
do...
var Model = require('halogen-resource').Resource;
// or if you prefer to keep them cleanly separate..
var Resource = require('halogen-resource').Resource;
Assuming your model has a self href, it will load the hypermedia and fire a sync
event, as per normal Backbone. Parameters in the callback
are the model and the request response.
If you're using the '_commands' functionality, calling .execute
will seralise the command's properties and PUT/POST/DELETE etc to the specified HREF.
HTTP error codes 201, 200 and 202 are considered successful. ANything else counts as an error. On success, a .fetch() automatically happens. If it's an error this doesn't happen.
It will also trigger executed
or execution-failed
which is passed the command that failed. This should bubble up to the parent model.
If you pass a callback, instead of an automatic .fetch() happening your callback is called so you can manually decide whether or not to resync.
The parameters passed to the callback are err
and response
. 201, 200 and 202 are considered successful. ANything else counts as an error.
It will also trigger executed
or execution-failed
, which is passed the command that failed.
And this gives you Halogen Models with the HTTP extensions. This module is badly named really. This should bubble up to the parent model.
MIT