Skip to content

Latest commit

 

History

History
116 lines (98 loc) · 2.54 KB

README.md

File metadata and controls

116 lines (98 loc) · 2.54 KB

ember-data-save-relationships

NOTE: I am not maintaining this add-on anymore. It was a fun exercise but never ended up using it in production environments.


Include this mixin in your serializers and it will save your hasMany and belongsTo relationships' records.

For example:

// app/serializers/artist.js

import JSONAPISerializer from 'ember-data/serializers/json-api';
import SaveRelationshipsMixin from 'ember-data-save-relationships';

export default JSONAPISerializer.extend(SaveRelationshipsMixin, {
  attrs: {
    albums: { serialize: true }
  }
});

Now an Artist payload may include attributes like:

data: {
  id: null,
  type: "artist",
  attributes: {
    name: "Radiohead"
  },
  relationships: {
    albums: {
      data: [
        {
          id: null,
          type: "albums",
          attributes: {
            name: "Kid A",
            __id__: "0internal-model"
          }
        }
      ]
    }
  }
}

More info: http://emberigniter.com/saving-models-relationships-json-api/

Installation

  • ember install ember-data-save-relationships

Notes

  • A temporary ID (__id__) will be sent along with the relationship's data attributes. Your server API must return this attribute intact along with a proper id after saving the relationship records:
 { 
   data: {
     id: "1",
     type: 'albums',
     attributes: { name: "Kid A"},
     relationships: {
       artists: {
         data: {
           id: "1",
           type: "artists",
           attributes: {
             name: "Radiohead XXXX",
             __id__: internalId
           }
         }
       }
     }
   }
 }

Or it may alternatively be returned using the included array:

 { 
   data: {
     id: "1",
     type: 'albums',
     attributes: { name: "Kid A"},
     relationships: {
       artists: {
         data: {
           id: "1",
           type: "artists"
         }
       }
     }
   },

   included: [
     {
       id: "1",
       type: "artists",
       attributes: {
         name: "Radiohead XXXX",
         __id__: internalId
       }
     }
   ]
 }
  • Calling serialize: true on cyclic dependencies will result in a stack overflow
  • At this point in time, if your server returns updated attributes, these will not be updated in the Ember Data store

Issues

Please file at https://github.com/frank06/ember-data-save-relationships/issues