source: Dev/branches/rest-dojo-ui/client/qed/app/Router.js @ 418

define([
    'dojo/_base/declare',
    'dojo/hash',
    'dojo/io-query',
    'dojo/topic',
    './Content',
    './Page'
],function(declare,hash,ioQuery,topic,Content,Page){

    var Router = declare(null,{
        _started: false,
        _routes: null,
        _previousHash: null,

        _paramMatch: /:(\w[\w\d]*)/g,
        _paramReplace: "([^\\/!]+)",

        constructor: function() {
            this._routes = [];
        },
        startup: function() {
            if ( this._started ) { return; }
            if ( !Content._started ) {
                Content.startup();
            }
            this._started = true;

            var self = this;

            if ( hash() === "" ) {
                hash("#!/");
            }
            this._handlePathChange(hash());
                        topic.subscribe("/dojo/hashchange", function(){
                self._handlePathChange.apply(self,arguments);
            });
        },
        register: function(route) {
            if ( this._started ) {
                console.warn('Registering routes after startup() is called is discouraged.');
            }
            var self = this;
            var callback;
            if ( route.callback ) {
                callback = function(params){
                    Content.set(route.callback(params));
                };
            } else if ( route.redirect ) {
                callback = function(params){
                    self.go(route.redirect);
                };
            } else if ( route.constructor ) {
                callback = function(params){
                    Content.set( new route.constructor(params) );
                };
            }
            if ( callback ) {
                if ( route.path ) {
                    this._routes.push(this._createRoute(route.path,callback));
                } else {
                    this._defaultCallback = callback;
                }
            } else {
                console.warn("Route "+(route.path||"default")+" has no action.");
            }
        },
        _createRoute: function(path,callback) {
            var match, route = {};
            route.callback = callback;
            route.paramNames = [];
                        while((match = this._paramMatch.exec(path)) !== null){
                                route.paramNames.push(match[1]);
                        }
            path = path.replace(this._paramMatch, this._paramReplace);
            route.regexp = new RegExp('^!'+path+'(!(.*))?$');
            return route;
        },
        _handlePathChange: function(newHash) {
            if ( this._previousHash === newHash ) { return; }
            this._previousHash = newHash;

            for (var i = this._routes.length-1; i >= 0; i--) {
                var result;
                var route = this._routes[i];

                if ((result = route.regexp.exec(newHash)) !== null) {
                    var numParams = route.paramNames.length;

                    var params = {};
                    for (var j = 0; j < numParams; j++) {
                        params[route.paramNames[j]] = result[j+1];
                    }

                    if ( result.length > numParams+1 && result[numParams+2] ) {
                        params.options = ioQuery.queryToObject(result[numParams+2]);
                    }

                    try {
                        route.callback(params);
                    } catch(err) {
                        console.warn("Page change failed.",err);
                    }
                    return;
                }
            }

            try {
                this._defaultCallback();
            } catch(err) {
                console.warn("Default page failed.",err);
            }
        },
        go: function(path,args) {
            if ( !this._started ) { return; }
            var newHash = this._pathToHash(path,args);
            this._handlePathChange(newHash);
            hash(newHash);
        },
        _pathToHash: function(path,args) {
            var hash = '!'+path;
            if ( args ) {
                hash += '!'+ioQuery.objectToQuery(args);
            }
            return hash;
        },
        _defaultCallback: function() {
            Content.set(new Page({
                templateString: "<div>Requested page not found. Go <a href=\"#!/\">home</a>.</div>"
            }));
        }
    });

    return new Router();
});