-<!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre><span id='Ext-ModelManager'>/**
+<!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
* @extends Ext.AbstractManager
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:
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;
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.
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
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.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
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;
}
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("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
- * @method regModel
+ * @deprecated 4.0.0 Use {@link Ext#define} instead.
*/
Ext.regModel = function() {
//<debug>
return this.ModelManager.registerType.apply(this.ModelManager, arguments);
};
});
-</pre></pre></body></html>
\ No newline at end of file
+</pre>
+</body>
+</html>
git.ithinksw.org / extjs.git / blobdiff