hyperbone-model-with-io
v0.1.21
Published
HTTP interactions for Hyperbone Models
Downloads
2
Readme
Hyperbone Model (With IO)
This module is no longer being maintained
It is replaced by HalogenJS Resource.
tldr;
Adds HTTP interactions to Hyperbone Models. Ridiculously early push this.
Intro
Adds a 'fetch' method for loading a Hypermedia resource from a server, and a 'execute' method for sending Command data to a server.
Installation
Install with npm(1):
$ npm install --save hyperbone-model-with-io
Tests
If you don't already have grunt..
$ npm install -g grunt-cli
After cloning the repo..
$ npm install
To run the tests
$ npm test
Usage
Instead of ...
var Model = require('hyperbone-model').Model;
do...
var Model = require('hyperbone-model-with-io').Model;
API
.fetch()
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.
.execute( "command name" )
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.
.execute( "command name", callback )
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 Hyperbone Models with the HTTP extensions. This module is badly named really. This should bubble up to the parent model.
License
MIT