ampersand-collection-rest-mixin
v6.0.0
Published
A mixin for extending ampersand-collection with restful methods.
Downloads
8,652
Readme
ampersand-collection-rest-mixin
Part of the Ampersand.js toolkit for building clientside applications.
A mixin for extending ampersand-collection with restful methods. To make it behave much like Backbone.
install
npm install ampersand-collection-rest-mixin
api
create(model, options)
Create a new instance of a model in this collection. Add the model to the collection immediately.
options
wait
- default:false
. If set to true, we wait for the server to agree before updating the collection.
fetch(options)
Fetch the default set of models for this collection, and set them onto this collection.
options
reset
[boolean] - default:false
. Executes thereset
method on the collection with server response instead of the set method.set
[boolean] - defaut:true
. When left true, executes thereset
method on the collection with server response. When set to false, the collection will not be modified after the HTTP request is complete. This enables use of of the collection strictly as an API client. Thesuccess
anderror
handlers are still triggered. Useful in rare circumstances.success(collection, response, options)
[function] - default:undefined
. Called after the XHR has completed successfully and the collection is updated.error(model, response, options)
[function] - default:undefined
. Called after the XHR has failed.always(err, response, body)
[function] - default:undefined
. Called when request finishes no matter what the result.
fetchById(id, options, cb)
fetches a model and adds it to collection when fetched
getOrFetch(id, options, cb)
get or fetch a model by id
options
same options as fetch()
, with the addition of:
all
[boolean] - default:false
. Iftrue
, this fetches the entire collection and then returns the requested model.
sync()
proxy to ampersand-sync
example
var Collection = require('ampersand-collection');
var restMixin = require('ampersand-collection-rest-mixin');
module.exports = Collection.extend(restMixin, {
sampleMethod: function () {
// now we've got restful methods in our collection
this.sync( ... );
this.fetch( ... );
this.create( ... )
}
});
credits
All credit for this approach in backbone goes to Jeremy Ashkenas and the rest of the Backbone and Underscore authors.
license
MIT