ember-datalight/lib/adapter.js

A lightweight data persistence library for Ember with full support of JSON structure

'use strict';

var Ember = require('ember'),
	DataLight = require('./index'),
	PromiseArray = require('./promisearray'),
	map = Ember.EnumerableUtils.map,
	RSVP = Ember.RSVP,
	Promise = RSVP.Promise;

var Adapter = module.exports = DataLight.Adapter = Ember.Object.extend({
	serializer: null,


	findByID: Ember.required(Function),

	/**
	The `findAll()` method is called when you call `find` on the store
	without an ID (i.e. `store.find('post')`).
	*/
	findAll: null,

	/**
	This method is called when you call `find` on the store with a
	query object as the second parameter (i.e. `store.find('person', {
	page: 1 })`).
	*/
	findQuery: null,


	/**
	Proxies to the serializer's `serialize` method.
	*/
	serialize: Ember.required(Function),


	/**
	Implement this method in a subclass to handle the creation of
	new records.
	*/
	createRecord: Ember.required(Function),

	/**
	Implement this method in a subclass to handle the updating of
	a record.
	*/
	updateRecord: Ember.required(Function),


	/**
	 * Implement this method in a subclass to handle the deletion of
	 * a record.
	 */
	deleteRecord: Ember.required(Function),


	/**
	Find multiple records at once.

	By default, it loops over the provided ids and calls `find` on each.
	May be overwritten to improve performance and reduce the number of
	server requests.
	*/
	findMany: function(model, ids) {
		var self = this;
		var promise = Ember.RSVP.all(map(ids, function(id) {
			return self.findByID(model, id);
		}));

		return PromiseArray.create({
			promise: Promise.cast(promise)
		});
	}
});