/**
 * @author Ed Spencer
 *
 * 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.ClassManager#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',
 *         config: {
 *             fields: ['first', 'last']
 *         }
 *     });
 *
 *     // method 1, create using Ext.create (recommended)
 *     Ext.create('User', {
 *         first: 'Ed',
 *         last: 'Spencer'
 *     });
 *
 *     // method 2, create on the type directly
 *     new User({
 *         first: 'Ed',
 *         last: 'Spencer'
 *     });
 *
 *     // method 3, create through the manager (deprecated)
 *     Ext.ModelManager.create({
 *         first: 'Ed',
 *         last: 'Spencer'
 *     }, 'User');
 *
 * ## 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',
 *         config: {
 *             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;
 */
Ext.define('Ext.data.ModelManager', {
    extend: 'Ext.AbstractManager',
    alternateClassName: ['Ext.ModelMgr', 'Ext.ModelManager'],

    singleton: true,

    /**
     * @property defaultProxyType
     * The string type of the default Model Proxy.
     * @removed 2.0.0
     */

    /**
     * @property associationStack
     * Private stack of associations that must be created once their associated model has been defined.
     * @removed 2.0.0
     */

    modelNamespace: null,

    /**
     * Registers a model definition. All model plugins marked with `isDefault: true` are bootstrapped
     * immediately, as are any addition plugins defined in the model config.
     * @param {String} name
     * @param {Object} config
     * @return {Object}
     */
    registerType: function(name, config) {
        var proto = config.prototype,
            model;

        if (proto && proto.isModel) {
            // registering an already defined model
            model = config;
        } else {
            config = {
                extend: config.extend || 'Ext.data.Model',
                config: config
            };
            model = Ext.define(name, config);
        }
        this.types[name] = model;
        return model;
    },

    onModelDefined: Ext.emptyFn,

    // /**
    //  * @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);
    //     }
    // },
    //
    // /**
    //  * 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);
    // },

    /**
     * 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];
            if (!model && this.modelNamespace) {
                model = this.types[this.modelNamespace + '.' + model];
            }
        }
        return model;
    },

    /**
     * Creates a new instance of a Model using the given data.
     *
     * __Note:__ This method is deprecated. Use {@link Ext.ClassManager#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}).
     * @return {Object}
     */
    create: function(config, name, id) {
        var con = typeof name == 'function' ? name : this.types[name || config.name];
        return new con(config, id);
    }
}, function() {

    /**
     * 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 2.0.0 Please use {@link Ext#define} instead.
     */
    Ext.regModel = function() {
        //<debug>
        Ext.Logger.deprecate('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);
    };
});
