The common interface for the ability to lookup() or get the factoryFor an
item, shared by the Owner and ContainerProxy interfaces.
Methods
factoryFor (fullName) : FactoryManager public
Defined in packages/@ember/-internals/owner/index.ts:247
- fullName
- String
- returns
- FactoryManager
Given a FullName, of the form "type:name" return a FactoryManager.
This method returns a manager which can be used for introspection of the factory's class or for the creation of factory instances with initial properties. The manager is an object with the following properties:
class- The registered or resolved class.create- A function that will create an instance of the class with any dependencies injected.
For example:
import { getOwner } from '@ember/application';
let owner = getOwner(otherInstance);
// the owner is commonly the `applicationInstance`, and can be accessed via
// an instance initializer.
let factory = owner.factoryFor('service:bespoke');
factory.class;
// The registered or resolved class. For example when used with an Ember-CLI
// app, this would be the default export from `app/services/bespoke.js`.
let instance = factory.create({
someProperty: 'an initial property value'
});
// Create an instance with any injections and the passed options as
// initial properties.
Any instances created via the factory's .create() method must be destroyed
manually by the caller of .create(). Typically, this is done during the creating
objects own destroy or willDestroy methods.
lookup (fullName, options) : Any public
Defined in packages/@ember/-internals/owner/index.ts:198
- fullName
- String
- options
- RegisterOptions
- returns
- Any
Given a fullName return a corresponding instance.
The default behavior is for lookup to return a singleton instance. The singleton is scoped to the container, allowing multiple containers to all have their own locally scoped singletons.
let registry = new Registry();
let container = registry.container();
registry.register('api:twitter', Twitter);
let twitter = container.lookup('api:twitter');
twitter instanceof Twitter; // => true
// by default the container will return singletons
let twitter2 = container.lookup('api:twitter');
twitter2 instanceof Twitter; // => true
twitter === twitter2; //=> true
If singletons are not wanted an optional flag can be provided at lookup.
let registry = new Registry();
let container = registry.container();
registry.register('api:twitter', Twitter);
let twitter = container.lookup('api:twitter', { singleton: false });
let twitter2 = container.lookup('api:twitter', { singleton: false });
twitter === twitter2; //=> false