With the default implementation, when Backbone.sync sends up a request to save - a model, its attributes will be passed, serialized as JSON, under the model - parameter. When returning a JSON response, send down the attributes of the - model that have been changed by the server, and need to be updated on the - client. When responding to a "read" request from a collection + a model, its attributes will be passed, serialized as JSON, and sent in the HTTP body + with content-type application/json. When returning a JSON response, + send down the attributes of the model that have been changed by the server, and need + to be updated on the client. When responding to a "read" request from a collection (Collection#fetch), send down an array of model attribute objects.
@@ -1252,21 +1252,23 @@ var othello = NYPL.create({- If your web server makes it difficult to work with real PUT and - DELETE requests, you may choose to emulate them instead, using - HTTP POST, and passing them under the _method parameter - instead, by turning on Backbone.emulateHttp: + If you want to work with a legacy web server that doesn't support Backbones's + default JSON centric approach, you may choose to turn on Backbone.emulateHttp. + Setting this option will emulate PUT and DELETE requests with + a HTTP POST, and passing them under the _method parameter. Setting this option + will also send the model under a model param and use application/x-www-form-urlencoded + instead of the default application/json as the content-type for data sent.
-Backbone.emulateHttp = true; +Backbone.emulateHTTP = true; model.save(); // Sends a POST to "/collection/id", with "_method=PUT"
As an example, a Rails handler responding to an "update" call from - Backbone.sync might look like this: (In real code, never use + Backbone might look like this: (In real code, never use update_attributes blindly, and always whitelist the attributes you allow to be changed.)
@@ -1557,7 +1559,7 @@ var DocumentView = Backbone.View.extend({ as an option, which will be invoked if validation fails, overriding the "error" event. You can now tell backbone to use the _method hack instead of HTTP - methods by setting Backbone.emulateHttp = true. + methods by setting Backbone.emulateHTTP = true. Existing Model and Collection data is no longer sent up unnecessarily with GET and DELETE requests. Added a rake lint task. Backbone is now published as an NPM module. diff --git a/test/sync.js b/test/sync.js index 36888b19..971c25ed 100644 --- a/test/sync.js +++ b/test/sync.js @@ -36,18 +36,19 @@ $(document).ready(function() { equals(lastRequest.url, '/library'); equals(lastRequest.type, 'POST'); equals(lastRequest.dataType, 'json'); - var data = JSON.parse(lastRequest.data.model); + var data = JSON.parse(lastRequest.data); equals(data.title, 'The Tempest'); equals(data.author, 'Bill Shakespeare'); equals(data.length, 123); }); + test("sync: update", function() { library.first().save({id: '1-the-tempest', author: 'William Shakespeare'}); equals(lastRequest.url, '/library/1-the-tempest'); equals(lastRequest.type, 'PUT'); equals(lastRequest.dataType, 'json'); - var data = JSON.parse(lastRequest.data.model); + var data = JSON.parse(lastRequest.data); equals(data.id, '1-the-tempest'); equals(data.title, 'The Tempest'); equals(data.author, 'William Shakespeare'); @@ -61,11 +62,11 @@ $(document).ready(function() { equals(lastRequest.type, 'POST'); equals(lastRequest.dataType, 'json'); equals(lastRequest.data._method, 'PUT'); - var data = JSON.parse(lastRequest.data.model); + var data = lastRequest.data.model; equals(data.id, '2-the-tempest'); - equals(data.title, 'The Tempest'); equals(data.author, 'Tim Shakespeare'); equals(data.length, 123); + Backbone.emulateHttp = false; }); test("sync: read model", function() { @@ -76,7 +77,6 @@ $(document).ready(function() { }); test("sync: destroy", function() { - Backbone.emulateHttp = false; library.first().destroy(); equals(lastRequest.url, '/library/2-the-tempest'); equals(lastRequest.type, 'DELETE'); @@ -89,6 +89,7 @@ $(document).ready(function() { equals(lastRequest.url, '/library/2-the-tempest'); equals(lastRequest.type, 'POST'); equals(JSON.stringify(lastRequest.data), '{"_method":"DELETE"}'); + Backbone.emulateHttp = false; }); });