3 * Copyright(c) 2006-2010 Sencha Inc.
5 * http://www.sencha.com/license
8 * @class Ext.state.Provider
9 * Abstract base class for state provider implementations. This class provides methods
10 * for encoding and decoding <b>typed</b> variables including dates and defines the
13 Ext.state.Provider = Ext.extend(Ext.util.Observable, {
15 constructor : function(){
18 * Fires when a state change occurs.
19 * @param {Provider} this This state provider
20 * @param {String} key The state key which was changed
21 * @param {String} value The encoded value for the state
23 this.addEvents("statechange");
25 Ext.state.Provider.superclass.constructor.call(this);
29 * Returns the current value for a key
30 * @param {String} name The key name
31 * @param {Mixed} defaultValue A default value to return if the key's value is not found
32 * @return {Mixed} The state data
34 get : function(name, defaultValue){
35 return typeof this.state[name] == "undefined" ?
36 defaultValue : this.state[name];
40 * Clears a value from the state
41 * @param {String} name The key name
43 clear : function(name){
44 delete this.state[name];
45 this.fireEvent("statechange", this, name, null);
49 * Sets the value for a key
50 * @param {String} name The key name
51 * @param {Mixed} value The value to set
53 set : function(name, value){
54 this.state[name] = value;
55 this.fireEvent("statechange", this, name, value);
59 * Decodes a string previously encoded with {@link #encodeValue}.
60 * @param {String} value The value to decode
61 * @return {Mixed} The decoded value
63 decodeValue : function(cookie){
73 var re = /^(a|n|d|b|s|o|e)\:(.*)$/,
74 matches = re.exec(unescape(cookie)),
79 if(!matches || !matches[1]){
80 return; // non state cookie
90 return new Date(Date.parse(v));
96 Ext.each(v.split('^'), function(val){
97 all.push(this.decodeValue(val));
104 Ext.each(v.split('^'), function(val){
106 all[kv[0]] = this.decodeValue(kv[1]);
116 * Encodes a value including type information. Decode with {@link #decodeValue}.
117 * @param {Mixed} value The value to encode
118 * @return {String} The encoded value
120 encodeValue : function(v){
128 }else if(typeof v == 'number'){
130 }else if(typeof v == 'boolean'){
131 enc = 'b:' + (v ? '1' : '0');
132 }else if(Ext.isDate(v)){
133 enc = 'd:' + v.toGMTString();
134 }else if(Ext.isArray(v)){
135 for(len = v.length; i < len; i++){
136 flat += this.encodeValue(v[i]);
142 }else if(typeof v == 'object'){
144 if(typeof v[key] != 'function' && v[key] !== undefined){
145 flat += key + '=' + this.encodeValue(v[key]) + '^';
148 enc = 'o:' + flat.substring(0, flat.length-1);