| 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.ModelManagerThe 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 replacesthe deprecated {@link #create Ext.ModelManager.create} method. It is also possible to create a model instancethis 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 typesare 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>
 |