Upgrade to ExtJS 4.0.7 - Released 10/19/2011
[extjs.git] / docs / source / ModelManager.html
index dad4682..6d1f6ee 100644 (file)
@@ -3,8 +3,8 @@
 <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <title>The source code</title>
-  <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
-  <script type="text/javascript" src="../prettify/prettify.js"></script>
+  <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>
 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 #create} function. It is also possible to do
-this by using the Model type directly. The following snippets are equivalent:
+
+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 through the manager
+
+    // 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 2, create on the type directly
+
+    // 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:
 
@@ -51,10 +60,10 @@ are normal classes, you can access the type directly. The following snippets are
         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;
 
@@ -65,18 +74,17 @@ Ext.define('Ext.ModelManager', {
     extend: 'Ext.AbstractManager',
     alternateClassName: 'Ext.ModelMgr',
     requires: ['Ext.data.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 associationStack
-     * @type Array
+     * @property {Ext.data.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.
@@ -98,7 +106,7 @@ Ext.define('Ext.ModelManager', {
         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
@@ -110,22 +118,22 @@ Ext.define('Ext.ModelManager', {
             length = stack.length,
             create = [],
             association, i, created;
-        
+
         for (i = 0; i &lt; length; i++) {
             association = stack[i];
-            
+
             if (association.associatedModel == model.modelName) {
                 create.push(association);
             }
         }
-        
+
         for (i = 0, length = create.length; i &lt; length; i++) {
             created = create[i];
             this.types[created.ownerModel].prototype.associations.add(Ext.data.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
@@ -136,10 +144,11 @@ Ext.define('Ext.ModelManager', {
     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;
@@ -148,27 +157,41 @@ Ext.define('Ext.ModelManager', {
         }
         return model;
     },
-    
+
 <span id='Ext-ModelManager-method-create'>    /**
 </span>     * Creates a new instance of a Model using the given data.
+     *
+     * This method is deprecated.  Use {@link Ext#create Ext.create} instead.  For example:
+     *
+     *     Ext.create('User', {
+     *         first: 'Ed',
+     *         last: 'Spencer'
+     *     });
+     *
      * @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})
+     * @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>     * Creates a new Model class from the specified config object. See {@link Ext.data.Model} for full examples.
-     * 
+</span>     * Old way for creating Model classes.  Instead use:
+     *
+     *     Ext.define(&quot;MyModel&quot;, {
+     *         extend: &quot;Ext.data.Model&quot;,
+     *         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
-     * @method regModel
+     * @deprecated 4.0.0 Use {@link Ext#define} instead.
      */
     Ext.regModel = function() {
         //&lt;debug&gt;