DS.Transform Class
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
import DS from 'ember-data';
// Converts centigrade in the JSON to fahrenheit in the app
export default DS.Transform.extend({
deserialize(serialized, options) {
return (serialized * 1.8) + 32;
},
serialize(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.
export default DS.Model.extend({
title: DS.attr('string'),
markdown: DS.attr('markdown', {
markdown: {
gfm: false,
sanitize: true
}
})
});
export default DS.Transform.extend({
serialize(deserialized, options) {
return deserialized.raw;
},
deserialize(serialized, options) {
var markdownOptions = options.markdown || {};
return marked(serialized, markdownOptions);
}
});
Usage
import DS from 'ember-data';
export default DS.Model.extend({
name: DS.attr('string'),
temperature: DS.attr('temperature')
});
Item Index
Methods
Methods
deserialize
-
serialized -
options
When given a serialize value from a JSON object this method must return the deserialized value for the record attribute.
Example
deserialize(serialized, options) {
return empty(serialized) ? null : Number(serialized);
}
Parameters:
-
serializedObjectThe serialized value
-
optionsObjecthash 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
import { isEmpty } from '@ember/utils';
serialize(deserialized, options) {
return isEmpty(deserialized) ? null : Number(deserialized);
}
Parameters:
-
deserializedObjectThe deserialized value
-
optionsObjecthash of options passed to
DS.attr
Returns:
The serialized value
