@brickclick/ember-data-sails
v1.0.0
Published
The default blueprint for ember-cli addons.
Downloads
2
Readme
<<<<<<< HEAD
ember-data-sails
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
,controllers
androutes
onsailsSocket
property, 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.js
located at<hostname>:1337/js/dependencies/sails.io.js
, but you can change this using configuration inconfig/environment.js
file: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 caseDS.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)
Installation
npm install --save-dev ember-data-sails
CSRF config
- 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
true
only) in the SailsJS config file (thanks @tibotiber for figuring this out).
Using
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/routes
to allow/__getCookie
(and/csrfToken
if 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
SailsSocketService
is injected on alladapters
,controllers
androutes
on thesailsSocket
propertyTo use the
SailsSocketAdapter
as 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
SailsRESTAdapter
as 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.11
you 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 topushPayload
method of the store which iftrue
will automatically subscribe the models and records it can. This will usesubscribeMethod
, andsubscribePath
properties 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.js
like this:ENV.APP.emberDataSails.useSailsEmberBlueprints = true;
TODO
- 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)
Authors
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.
- Huafu Gandon - @huafu_g ======= my-addon ==============================================================================
[Short description of the addon.]
Installation
ember install my-addon
Usage
[Longer description of how to use the addon in apps.]
Contributing
Installation
git clone <repository-url>
cd my-addon
npm install
Linting
npm run lint:hbs
npm run lint:js
npm run lint:js -- --fix
Running tests
ember test
– Runs the test suite on the current Ember versionember test --server
– Runs the test suite in "watch mode"ember try:each
– Runs the test suite against multiple Ember versions
Running the dummy application
ember serve
- Visit the dummy application at http://localhost:4200.
For more information on using ember-cli, visit https://ember-cli.com/.
License
This project is licensed under the MIT License.
da52bfe... message