123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206 |
- <!DOCTYPE html>
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <title>The source code</title>
- <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
- <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
- <style type="text/css">
- .highlight { display: block; background-color: #ddd; }
- </style>
- <script type="text/javascript">
- function highlight() {
- document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
- }
- </script>
- </head>
- <body onload="prettyPrint(); highlight();">
- <pre class="prettyprint lang-js"><span id='Ext-ModelManager'>/**
- </span> * @author Ed Spencer
- * @class Ext.ModelManager
- The ModelManager keeps track of all {@link Ext.data.Model} types defined in your application.
- __Creating Model Instances__
- Model instances can be created by using the {@link Ext#create Ext.create} method. Ext.create replaces
- the deprecated {@link #create Ext.ModelManager.create} method. It is also possible to create a model instance
- this by using the Model type directly. The following 3 snippets are equivalent:
- Ext.define('User', {
- extend: 'Ext.data.Model',
- fields: ['first', 'last']
- });
- // method 1, create using Ext.create (recommended)
- Ext.create('User', {
- first: 'Ed',
- last: 'Spencer'
- });
- // method 2, create through the manager (deprecated)
- Ext.ModelManager.create({
- first: 'Ed',
- last: 'Spencer'
- }, 'User');
- // method 3, create on the type directly
- new User({
- first: 'Ed',
- last: 'Spencer'
- });
- __Accessing Model Types__
- A reference to a Model type can be obtained by using the {@link #getModel} function. Since models types
- are normal classes, you can access the type directly. The following snippets are equivalent:
- Ext.define('User', {
- extend: 'Ext.data.Model',
- fields: ['first', 'last']
- });
- // method 1, access model type through the manager
- var UserType = Ext.ModelManager.getModel('User');
- // method 2, reference the type directly
- var UserType = User;
- * @markdown
- * @singleton
- */
- Ext.define('Ext.ModelManager', {
- extend: 'Ext.AbstractManager',
- alternateClassName: 'Ext.ModelMgr',
- requires: ['Ext.data.association.Association'],
-
- singleton: true,
- typeName: 'mtype',
- <span id='Ext-ModelManager-property-associationStack'> /**
- </span> * Private stack of associations that must be created once their associated model has been defined
- * @property {Ext.data.association.Association[]} associationStack
- */
- associationStack: [],
- <span id='Ext-ModelManager-method-registerType'> /**
- </span> * Registers a model definition. All model plugins marked with isDefault: true are bootstrapped
- * immediately, as are any addition plugins defined in the model config.
- * @private
- */
- registerType: function(name, config) {
- var proto = config.prototype,
- model;
- if (proto && proto.isModel) {
- // registering an already defined model
- model = config;
- } else {
- // passing in a configuration
- if (!config.extend) {
- config.extend = 'Ext.data.Model';
- }
- model = Ext.define(name, config);
- }
- this.types[name] = model;
- return model;
- },
- <span id='Ext-ModelManager-method-onModelDefined'> /**
- </span> * @private
- * Private callback called whenever a model has just been defined. This sets up any associations
- * that were waiting for the given model to be defined
- * @param {Function} model The model that was just created
- */
- onModelDefined: function(model) {
- var stack = this.associationStack,
- length = stack.length,
- create = [],
- association, i, created;
- for (i = 0; i < length; i++) {
- association = stack[i];
- if (association.associatedModel == model.modelName) {
- create.push(association);
- }
- }
- for (i = 0, length = create.length; i < length; i++) {
- created = create[i];
- this.types[created.ownerModel].prototype.associations.add(Ext.data.association.Association.create(created));
- Ext.Array.remove(stack, created);
- }
- },
- <span id='Ext-ModelManager-method-registerDeferredAssociation'> /**
- </span> * Registers an association where one of the models defined doesn't exist yet.
- * The ModelManager will check when new models are registered if it can link them
- * together
- * @private
- * @param {Ext.data.association.Association} association The association
- */
- registerDeferredAssociation: function(association){
- this.associationStack.push(association);
- },
- <span id='Ext-ModelManager-method-getModel'> /**
- </span> * Returns the {@link Ext.data.Model} for a given model name
- * @param {String/Object} id The id of the model or the model instance.
- * @return {Ext.data.Model} a model class.
- */
- getModel: function(id) {
- var model = id;
- if (typeof model == 'string') {
- model = this.types[model];
- }
- return model;
- },
- <span id='Ext-ModelManager-method-create'> /**
- </span> * Creates a new instance of a Model using the given data. Deprecated, instead use Ext.create:
- *
- * Ext.create('User', {
- * first: 'Ed',
- * last: 'Spencer'
- * });
- *
- * @deprecated 4.1 Use {@link Ext#create Ext.create} instead.
- *
- * @param {Object} data Data to initialize the Model's fields with
- * @param {String} name The name of the model to create
- * @param {Number} id (Optional) unique id of the Model instance (see {@link Ext.data.Model})
- */
- create: function(config, name, id) {
- var Con = typeof name == 'function' ? name : this.types[name || config.name];
- return new Con(config, id);
- }
- }, function() {
- <span id='Ext-method-regModel'> /**
- </span> * Old way for creating Model classes. Instead use:
- *
- * Ext.define("MyModel", {
- * extend: "Ext.data.Model",
- * fields: []
- * });
- *
- * @param {String} name Name of the Model class.
- * @param {Object} config A configuration object for the Model you wish to create.
- * @return {Ext.data.Model} The newly registered Model
- * @member Ext
- * @deprecated 4.0.0 Use {@link Ext#define} instead.
- */
- Ext.regModel = function() {
- //<debug>
- if (Ext.isDefined(Ext.global.console)) {
- Ext.global.console.warn('Ext.regModel has been deprecated. Models can now be created by extending Ext.data.Model: Ext.define("MyModel", {extend: "Ext.data.Model", fields: []});.');
- }
- //</debug>
- return this.ModelManager.registerType.apply(this.ModelManager, arguments);
- };
- });
- </pre>
- </body>
- </html>
|