/** * The Rest proxy is a specialization of the {@link Ext.data.proxy.Ajax AjaxProxy} which simply maps * the four actions (create, read, update and destroy) to RESTful HTTP verbs. For example, let's * set up a {@link Ext.data.Model Model} with an inline Rest proxy * * Ext.define('User', { * extend: 'Ext.data.Model', * fields: ['id', 'name', 'email'], * * proxy: { * type: 'rest', * url: '/users' * } * }); * * Now we can create a new User instance and save it via the Rest proxy. Doing this will cause * the Proxy to send a POST request to '/users': * * var user = Ext.create('User', { name: 'Ed Spencer', email: 'ed@sencha.com' }); * * user.save(); // POST /users * * Let's expand this a little and provide a callback for the {@link Ext.data.Model#save} call * to update the Model once it has been created. We'll assume the creation went successfully * and that the server gave this user an ID of 123: * * user.save({ * success: function(user) { * user.set('name', 'Khan Noonien Singh'); * * user.save(); // PUT /users/123 * } * }); * * Now that we're no longer creating a new Model instance, the request method is changed to an * HTTP PUT, targeting the relevant url for that user. Now let's delete this user, which will use * the DELETE method: * * user.erase(); // DELETE /users/123 * * Finally, when we perform a load of a Model or Store, Rest proxy will use the GET method: * * // 1. Load via Store * * // the Store automatically picks up the Proxy from the User model * var store = Ext.create('Ext.data.Store', { * model: 'User' * }); * * store.load(); // GET /users * * // 2. Load directly from the Model * * // GET /users/123 * User.load(123, { * success: function(user) { * console.log(user.getId()); // outputs 123 * } * }); * * # Url generation * * The Rest proxy is able to automatically generate the urls above based on two configuration * options - {@link #appendId} and {@link #format}. If appendId is true (it is by default) then * Rest proxy will automatically append the ID of the Model instance in question to the configured * url, resulting in the '/users/123' that we saw above. * * If the request is not for a specific Model instance (e.g. loading a Store), the url is not * appended with an id. The Rest proxy will automatically insert a '/' before the ID if one is not * already present. * * new Ext.data.proxy.Rest({ * url: '/users', * appendId: true // default * }); * * // Collection url: /users * // Instance url: /users/123 * * The Rest proxy can also optionally append a format string to the end of any generated url: * * new Ext.data.proxy.Rest({ * url: '/users', * format: 'json' * }); * * // Collection url: /users.json * // Instance url: /users/123.json * * If further customization is needed, simply implement the {@link #buildUrl} method and add your * custom generated url onto the {@link Ext.data.Request Request} object that is passed to buildUrl. * See [Rest proxy's implementation][1] for an example of how to achieve this. * * Note that Rest proxy inherits from {@link Ext.data.proxy.Ajax AjaxProxy}, which already injects * all of the sorter, filter, group and paging options into the generated url. See the * {@link Ext.data.proxy.Ajax AjaxProxy docs} for more details. * * [1]: source/Rest.html#Ext-data-proxy-Rest-method-buildUrl */Ext.define('Ext.data.proxy.Rest', { extend: 'Ext.data.proxy.Ajax', alternateClassName: 'Ext.data.RestProxy', alias: 'proxy.rest', /** * @property {Object} actionMethods * Mapping of action name to HTTP request method. These default to RESTful conventions for the * 'create', 'read', 'update' and 'destroy' actions (which map to 'POST', 'GET', 'PUT', and * 'DELETE' respectively). This object should not be changed except globally via * {@link Ext#override Ext.override} - the {@link #getMethod} function can be overridden * instead. */ defaultActionMethods: { create: 'POST', read: 'GET', update: 'PUT', destroy: 'DELETE' }, slashRe: /\/$/, periodRe: /\.$/, config: { /** * @cfg {Boolean} appendId * True to automatically append the ID of a Model instance when performing a * request based on that single instance. See Rest proxy intro docs for more * details. */ appendId: true, /** * @cfg {String} format * Optional data format to send to the server when making any request (e.g. * 'json'). See the Rest proxy intro docs for full details. */ format: null, /** * @cfg {Boolean} batchActions * True to batch actions of a particular type when synchronizing the store. */ batchActions: false, /** * @cfg actionMethods * @inheritdoc */ actionMethods: { create: 'POST', read: 'GET', update: 'PUT', destroy: 'DELETE' } }, /** * Specialized version of buildUrl that incorporates the {@link #appendId} and * {@link #format} options into the generated url. Override this to provide further * customizations, but remember to call the superclass buildUrl so that additional * parameters like the cache buster string are appended. * @param {Object} request */ buildUrl: function(request) { var me = this, operation = request.getOperation(), records = operation.getRecords(), record = records ? records[0] : null, format = me.getFormat(), url = me.getUrl(request), id, params; if (record && !record.phantom) { id = record.getId(); } else { id = operation.getId(); } if (me.getAppendId() && me.isValidId(id)) { if (!url.match(me.slashRe)) { url += '/'; } url += encodeURIComponent(id); params = request.getParams(); if (params) { delete params[me.getIdParam()]; } } if (format) { if (!url.match(me.periodRe)) { url += '.'; } url += format; } request.setUrl(url); return me.callParent([request]); }, isValidId: function(id) { return id || id === 0; }});