Adapters and tools for Ember to work well with Sails. Provides SailsSocketService, SailsRESTAdapter, SailsSocketAdapter, SailsSerializer and extends the store so that you can subscribe for records while pushing a payload.
Note: If you want to use this adapter with a version of SailsJS < 0.11.0 you have to use version 0.0.12 of this addon.
-
SailsSocketService: injected inadapters,controllersandroutesonsailsSocketproperty, it allow you to do Ember friendly requests using Sails socket. Example:// in app/controllers/application.js this.sailsSocket.request('get', '/someController/someAction', {name: 'Huafu'}}) .then(function(response) { // do something with the response });
It'll use by default the
sails.io.jslocated at<hostname>:1337/js/dependencies/sails.io.js, but you can change this using configuration inconfig/environment.jsfile:ENV.APP = { // if you want some useful debug information related to sails SAILS_LOG_LEVEL: 'debug', emberDataSails: { // default is to use same host and port as the ember app: host: '//localhost:1337', // this is the default and is the path to the sails io script: //scriptPath: '/js/dependencies/sails.io.js' } }
Also don't forget to add the rules for CSP:
// allow to fetch the script ENV.contentSecurityPolicy['script-src'] += ' http://localhost:1337'; // allow the websocket to connect ENV.contentSecurityPolicy['connect-src'] += ' http://localhost:1337 ws://localhost:1337';
-
DS.SailsSocketAdapter: use this adapter when you want to use sockets for your model(s) -
DS.SailsRESTAdapter: use this adapter when you want to use sockets for your model(s) -
DS.SailsSerializer: used by default when you use a Sails adapter, you shouldn't need to access it but it's there in case -
DS.Store.pushPayload([type], payload, [subscribe=false]): as the original one from Ember Data, except it accepts an additional parameter which, when set totrue, will tell the socket adapter to subscribe to the pushed records (see below) -
DS.Store.subscribe(type, ids): tells the sails socket adapter to subscribe to those models (see below)
npm install --save-dev ember-data-sails
- If you want to use CSRF token with the REST adapter, don't forget that you'll need to setup it as an object (and not
trueonly) in the SailsJS config file (thanks @tibotiber for figuring this out).
You must set sails.config.blueprints.pluralize to true in your Sails API to make the adapters works
-
If you are using sane (package
sane-cli), you must change the configuration inserver/config/routesto allow/__getCookie(and/csrfTokenif needed) to be handled by the SailsJS core:--- a/server/config/routes.js +++ b/server/config/routes.js @@ -50,7 +50,7 @@ module.exports.routes = { //This automatically serves all routes, apart from /api/** routes to ember //(which will be initialized in assets/index.html). This route needs to be //at the very bottom if you want to server other routes through Sails, because they are matched in order - '/*': { controller: 'App', action: 'serve', skipAssets: true, skipRegex: /^\/api\/.*$/ } + '/*': { controller: 'App', action: 'serve', skipAssets: true, skipRegex: /^\/(api\/.*|__getcookie|csrfToken)$/ } //You could also just serve the index view directly if you want //'/*': { view: 'index', skipAssets: true, skipRegex: /^\/api\/.*$/ }
-
The
SailsSocketServiceis injected on alladapters,controllersandrouteson thesailsSocketproperty -
To use the
SailsSocketAdapteras the default adapter, or as a model specific adapter, extend it fromSailsSocketAdapter:// file: app/adapters/application.js import SailsSocketAdapter from 'ember-data-sails/adapters/sails-socket'; export default SailsSocketAdapter.extend({ /** * Whether to use CSRF tokens or not */ useCSRF: true, /** * The path to use when the CSRF token needs to be retrieved * Default is `/csrfToken`, if not heading `/` it'll be relative to `namespace` */ //csrfTokenPath: 'some/custom/path', /** * Whether to group multiple find by ID with one request with a `where` */ coalesceFindRequests: true, /** * The namespace of your API */ namespace: 'api/v1' });
-
To use the
SailsRESTAdapteras the default adapter, or as a model specific adapter, extend it fromSailsRESTAdapter:// file: app/adapters/application.js import SailsRESTAdapter from 'ember-data-sails/adapters/sails-rest'; export default SailsRESTAdapter.extend({ /** * The host of your API */ host: 'http://localhost:1337', /** * The namespace of your API */ namespace: 'api/v1', /** * Whether to use CSRF tokens or not */ useCSRF: true, /** * Whether to group multiple find by ID with one request with a `where` */ coalesceFindRequests: true });
-
Since
0.0.11you can ask the API to subscribe to some models, useful when you want for example to preload some data at the application start from some serialized JSON in a<meta>tag. While it's easy to push data into the store withstore.pushPayload, then the records are not subscribed until you save them or get them again from Sails using the socket adapter. To push a payload and automatically subscribe to the pushed records, you can give an additional parameter topushPayloadmethod of the store which iftruewill automatically subscribe the models and records it can. This will usesubscribeMethod, andsubscribePathproperties of the adapter to do a request on the API.-
subscribeMethod:get,post, ... defaults topost -
subscribeEndpoint: the endpoint to do the request on, defaults to/socket/subscribe -
Of course you'll need to create a basic controller in your Sails API. Here is an example:
// api/controllers/SocketController.js module.exports = { subscribe: function (req, res, next) { var ids, data = req.allParams(), model, subscribed = {}; for (var name in data) { if (data.hasOwnProperty(name)) { model = sails.models[name]; if (model) { ids = data[name]; model.subscribe(req, ids); } else { sails.logger.warn('trying to subscribe to unknown model: ' + name); } } } res.json({}); } };
-
-
Using sails-generate-ember-blueprints: if you want to use this adapter in conjunction with Ember blueprints for Sails from Marcus, you need to define it in the
config/environment.jslike this:ENV.APP.emberDataSails.useSailsEmberBlueprints = true;
- Write more unit tests!!!
- Auto re-subscribe to subscribed records/models after a connection reset (it's already automatically re-listening for the events on the socket, but if Sails application have rebooted, we need to re-subscribe on the server somehow with the client socket)
While this was first inspired from ember-data-sails-adapter, it has now been fully re-written, with a totally different approach, and, as of the day this was written, with more features.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent