RecordReference Class
A RecordReference
is a low-level API that allows users and
addon authors to perform meta-operations on a record.
Methods
id
()
String
The id
of the record that this reference refers to.
Together, the type
and id
properties form a composite key for
the identity map.
Example
let userRef = store.getReference('user', 1);
userRef.id(); // '1'
Returns:
The id of the record.
link
()
String
`
javascript
// models/blog.js
import Model, { belongsTo } from '@ember-data/model';
export default Model.extend({
user: belongsTo({ async: true })
});
let blog = store.push({
data: {
type: 'blog',
id: 1,
relationships: {
user: {
links: {
related: '/articles/1/author'
}
}
}
}
});
let userRef = blog.belongsTo('user');
// get the identifier of the reference
if (userRef.remoteType() === "link") {
let link = userRef.link();
}
`
Returns:
load
()
PromiseTriggers a fetch for the backing entity based on its remoteType
(see remoteType
definitions per reference type).
Example
let userRef = store.getReference('user', 1);
// load user (via store.find)
userRef.load().then(...)
Returns:
the record for this RecordReference
meta
()
Object
`
javascript
// models/blog.js
import Model, { belongsTo } from '@ember-data/model';
export default Model.extend({
user: belongsTo({ async: true })
});
let blog = store.push({
data: {
type: 'blog',
id: 1,
relationships: {
user: {
links: {
related: {
href: '/articles/1/author'
},
meta: {
lastUpdated: 1458014400000
}
}
}
}
}
});
let userRef = blog.belongsTo('user');
userRef.meta() // { lastUpdated: 1458014400000 }
`
Returns:
push
-
objectOrPromise
This API allows you to provide a reference with new data. The
simplest usage of this API is similar to store.push
: you provide a
normalized hash of data and the object represented by the reference
will update.
If you pass a promise to push
, Ember Data will not ask the adapter
for the data if another attempt to fetch it is made in the
interim. When the promise resolves, the underlying object is updated
with the new data, and the promise returned by this function is resolved
with that object.
For example, recordReference.push(promise)
will be resolved with a
record.
Example
let userRef = store.getReference('user', 1);
// provide data for reference
userRef.push({
data: {
id: "1",
type: "user",
attributes: {
username: "@user"
}
}
}).then(function(user) {
userRef.value() === user;
});
Parameters:
-
objectOrPromise
Objecta JSON:API ResourceDocument or a promise resolving to one
Returns:
a promise for the value (record or relationship)
reload
()
PromiseReloads the record if it is already loaded. If the record is not
loaded it will load the record via store.findRecord
Example
let userRef = store.getReference('user', 1);
// or trigger a reload
userRef.reload().then(...)
Returns:
the record for this RecordReference