source: Dev/branches/rest-dojo-ui/client/dojox/mvc/_base.js @ 256

define([
        "dojo/_base/kernel",
        "dojo/_base/lang",
        "./StatefulModel",
        "./Bind",
        "./_DataBindingMixin",
        "./_patches"
], function(kernel, lang, StatefulModel){
        // module:
        //              dojox/mvc/_base
        // summary:
        //              Pulls in essential MVC dependencies such as basic support for
        //              data binds, a data model and data binding mixin for dijits.
        kernel.experimental("dojox.mvc");

        var mvc = lang.getObject("dojox.mvc", true);
        /*=====
                mvc = dojox.mvc;
        =====*/

        // Factory method for dojox.mvc.StatefulModel instances
        mvc.newStatefulModel = function(/*Object*/args){
                // summary:
                //              Factory method that instantiates a new data model that view
                //              components may bind to.
                //      args:
                //              The mixin properties.
                // description:
                //              Factory method that returns a client-side data model, which is a
                //              tree of dojo.Stateful objects matching the initial data structure
                //              passed as input:
                //              - The mixin property "data" is used to provide a plain JavaScript
                //                object directly representing the data structure.
                //              - The mixin property "store", along with an optional mixin property
                //                "query", is used to provide a data store to query to obtain the
                //                initial data.
                //              This function returns an immediate dojox.mvc.StatefulModel instance or
                //              a Promise for such an instance as follows:
                //              - if args.data: returns immediate
                //              - if args.store:
                //                      - if store returns immediate: this function returns immediate
                //                      - if store returns a Promise: this function returns a model
                //                        Promise
                if(args.data){
                        return new StatefulModel({ data : args.data });
                }else if(args.store && lang.isFunction(args.store.query)){
                        var model;
                        var result = args.store.query(args.query);
                        if(result.then){
                                return (result.then(function(data){
                                        model = new StatefulModel({ data : data });
                                        model.store = args.store;
                                        return model;
                                }));
                        }else{
                                model = new StatefulModel({ data : result });
                                model.store = args.store;
                                return model;
                        }
                }
        };

        return mvc;
});