DS.Transform Class addon/transform.js:3


Defined in: addon/transform.js:3

Module: ember-data

The DS.Transform class is used to serialize and deserialize model attributes when they are saved or loaded from an adapter. Subclassing DS.Transform is useful for creating custom attributes. All subclasses of DS.Transform must implement a serialize and a deserialize method.

Example

app/transforms/temperature.js
1
2
3
4
5
6
7
8
9
10
11
import DS from 'ember-data';

// Converts centigrade in the JSON to fahrenheit in the app
export default DS.Transform.extend({
  deserialize: function(serialized, options) {
    return (serialized *  1.8) + 32;
  },
  serialize: function(deserialized, options) {
    return (deserialized - 32) / 1.8;
  }
});

The options passed into the DS.attr function when the attribute is declared on the model is also available in the transform.

app/models/post.js
1
2
3
4
5
6
7
8
9
export default DS.Model.extend({
  title: DS.attr('string'),
  markdown: DS.attr('markdown', {
    markdown: {
      gfm: false,
      sanitize: true
    }
  })
});
app/transforms/markdown.js
1
2
3
4
5
6
7
8
9
10
11
export default DS.Transform.extend({
  serialize: function (deserialized, options) {
    return deserialized.raw;
  },

  deserialize: function (serialized, options) {
    var markdownOptions = options.markdown || {};

    return marked(serialized, markdownOptions);
  }
});

Usage

app/models/requirement.js
1
2
3
4
5
6
import DS from 'ember-data';

export default DS.Model.extend({
  name: DS.attr('string'),
  temperature: DS.attr('temperature')
});
Show:

Methods

Show:

deserialize

(serialized, options)

When given a serialize value from a JSON object this method must return the deserialized value for the record attribute.

Example

1
2
3
deserialize: function(serialized, options) {
  return empty(serialized) ? null : Number(serialized);
}

Parameters:

serialized
The serialized value
options
hash of options passed to `DS.attr`

Returns:

The deserialized value

serialize

(deserialized, options)

When given a deserialized value from a record attribute this method must return the serialized value.

Example

1
2
3
serialize: function(deserialized, options) {
  return Ember.isEmpty(deserialized) ? null : Number(deserialized);
}

Parameters:

deserialized
The deserialized value
options
hash of options passed to `DS.attr`

Returns:

The serialized value