1 | /*! |
---|
2 | * Ext JS Library 3.4.0 |
---|
3 | * Copyright(c) 2006-2011 Sencha Inc. |
---|
4 | * licensing@sencha.com |
---|
5 | * http://www.sencha.com/license |
---|
6 | */ |
---|
7 | /** |
---|
8 | * @class Ext.data.Types |
---|
9 | * <p>This is s static class containing the system-supplied data types which may be given to a {@link Ext.data.Field Field}.<p/> |
---|
10 | * <p>The properties in this class are used as type indicators in the {@link Ext.data.Field Field} class, so to |
---|
11 | * test whether a Field is of a certain type, compare the {@link Ext.data.Field#type type} property against properties |
---|
12 | * of this class.</p> |
---|
13 | * <p>Developers may add their own application-specific data types to this class. Definition names must be UPPERCASE. |
---|
14 | * each type definition must contain three properties:</p> |
---|
15 | * <div class="mdetail-params"><ul> |
---|
16 | * <li><code>convert</code> : <i>Function</i><div class="sub-desc">A function to convert raw data values from a data block into the data |
---|
17 | * to be stored in the Field. The function is passed the collowing parameters: |
---|
18 | * <div class="mdetail-params"><ul> |
---|
19 | * <li><b>v</b> : Mixed<div class="sub-desc">The data value as read by the Reader, if undefined will use |
---|
20 | * the configured <tt>{@link Ext.data.Field#defaultValue defaultValue}</tt>.</div></li> |
---|
21 | * <li><b>rec</b> : Mixed<div class="sub-desc">The data object containing the row as read by the Reader. |
---|
22 | * Depending on the Reader type, this could be an Array ({@link Ext.data.ArrayReader ArrayReader}), an object |
---|
23 | * ({@link Ext.data.JsonReader JsonReader}), or an XML element ({@link Ext.data.XMLReader XMLReader}).</div></li> |
---|
24 | * </ul></div></div></li> |
---|
25 | * <li><code>sortType</code> : <i>Function</i> <div class="sub-desc">A function to convert the stored data into comparable form, as defined by {@link Ext.data.SortTypes}.</div></li> |
---|
26 | * <li><code>type</code> : <i>String</i> <div class="sub-desc">A textual data type name.</div></li> |
---|
27 | * </ul></div> |
---|
28 | * <p>For example, to create a VELatLong field (See the Microsoft Bing Mapping API) containing the latitude/longitude value of a datapoint on a map from a JsonReader data block |
---|
29 | * which contained the properties <code>lat</code> and <code>long</code>, you would define a new data type like this:</p> |
---|
30 | *<pre><code> |
---|
31 | // Add a new Field data type which stores a VELatLong object in the Record. |
---|
32 | Ext.data.Types.VELATLONG = { |
---|
33 | convert: function(v, data) { |
---|
34 | return new VELatLong(data.lat, data.long); |
---|
35 | }, |
---|
36 | sortType: function(v) { |
---|
37 | return v.Latitude; // When sorting, order by latitude |
---|
38 | }, |
---|
39 | type: 'VELatLong' |
---|
40 | }; |
---|
41 | </code></pre> |
---|
42 | * <p>Then, when declaring a Record, use <pre><code> |
---|
43 | var types = Ext.data.Types; // allow shorthand type access |
---|
44 | UnitRecord = Ext.data.Record.create([ |
---|
45 | { name: 'unitName', mapping: 'UnitName' }, |
---|
46 | { name: 'curSpeed', mapping: 'CurSpeed', type: types.INT }, |
---|
47 | { name: 'latitude', mapping: 'lat', type: types.FLOAT }, |
---|
48 | { name: 'latitude', mapping: 'lat', type: types.FLOAT }, |
---|
49 | { name: 'position', type: types.VELATLONG } |
---|
50 | ]); |
---|
51 | </code></pre> |
---|
52 | * @singleton |
---|
53 | */ |
---|
54 | Ext.data.Types = new function(){ |
---|
55 | var st = Ext.data.SortTypes; |
---|
56 | Ext.apply(this, { |
---|
57 | /** |
---|
58 | * @type Regexp |
---|
59 | * @property stripRe |
---|
60 | * A regular expression for stripping non-numeric characters from a numeric value. Defaults to <tt>/[\$,%]/g</tt>. |
---|
61 | * This should be overridden for localization. |
---|
62 | */ |
---|
63 | stripRe: /[\$,%]/g, |
---|
64 | |
---|
65 | /** |
---|
66 | * @type Object. |
---|
67 | * @property AUTO |
---|
68 | * This data type means that no conversion is applied to the raw data before it is placed into a Record. |
---|
69 | */ |
---|
70 | AUTO: { |
---|
71 | convert: function(v){ return v; }, |
---|
72 | sortType: st.none, |
---|
73 | type: 'auto' |
---|
74 | }, |
---|
75 | |
---|
76 | /** |
---|
77 | * @type Object. |
---|
78 | * @property STRING |
---|
79 | * This data type means that the raw data is converted into a String before it is placed into a Record. |
---|
80 | */ |
---|
81 | STRING: { |
---|
82 | convert: function(v){ return (v === undefined || v === null) ? '' : String(v); }, |
---|
83 | sortType: st.asUCString, |
---|
84 | type: 'string' |
---|
85 | }, |
---|
86 | |
---|
87 | /** |
---|
88 | * @type Object. |
---|
89 | * @property INT |
---|
90 | * This data type means that the raw data is converted into an integer before it is placed into a Record. |
---|
91 | * <p>The synonym <code>INTEGER</code> is equivalent.</p> |
---|
92 | */ |
---|
93 | INT: { |
---|
94 | convert: function(v){ |
---|
95 | return v !== undefined && v !== null && v !== '' ? |
---|
96 | parseInt(String(v).replace(Ext.data.Types.stripRe, ''), 10) : (this.useNull ? null : 0); |
---|
97 | }, |
---|
98 | sortType: st.none, |
---|
99 | type: 'int' |
---|
100 | }, |
---|
101 | |
---|
102 | /** |
---|
103 | * @type Object. |
---|
104 | * @property FLOAT |
---|
105 | * This data type means that the raw data is converted into a number before it is placed into a Record. |
---|
106 | * <p>The synonym <code>NUMBER</code> is equivalent.</p> |
---|
107 | */ |
---|
108 | FLOAT: { |
---|
109 | convert: function(v){ |
---|
110 | return v !== undefined && v !== null && v !== '' ? |
---|
111 | parseFloat(String(v).replace(Ext.data.Types.stripRe, ''), 10) : (this.useNull ? null : 0); |
---|
112 | }, |
---|
113 | sortType: st.none, |
---|
114 | type: 'float' |
---|
115 | }, |
---|
116 | |
---|
117 | /** |
---|
118 | * @type Object. |
---|
119 | * @property BOOL |
---|
120 | * <p>This data type means that the raw data is converted into a boolean before it is placed into |
---|
121 | * a Record. The string "true" and the number 1 are converted to boolean <code>true</code>.</p> |
---|
122 | * <p>The synonym <code>BOOLEAN</code> is equivalent.</p> |
---|
123 | */ |
---|
124 | BOOL: { |
---|
125 | convert: function(v){ return v === true || v === 'true' || v == 1; }, |
---|
126 | sortType: st.none, |
---|
127 | type: 'bool' |
---|
128 | }, |
---|
129 | |
---|
130 | /** |
---|
131 | * @type Object. |
---|
132 | * @property DATE |
---|
133 | * This data type means that the raw data is converted into a Date before it is placed into a Record. |
---|
134 | * The date format is specified in the constructor of the {@link Ext.data.Field} to which this type is |
---|
135 | * being applied. |
---|
136 | */ |
---|
137 | DATE: { |
---|
138 | convert: function(v){ |
---|
139 | var df = this.dateFormat; |
---|
140 | if(!v){ |
---|
141 | return null; |
---|
142 | } |
---|
143 | if(Ext.isDate(v)){ |
---|
144 | return v; |
---|
145 | } |
---|
146 | if(df){ |
---|
147 | if(df == 'timestamp'){ |
---|
148 | return new Date(v*1000); |
---|
149 | } |
---|
150 | if(df == 'time'){ |
---|
151 | return new Date(parseInt(v, 10)); |
---|
152 | } |
---|
153 | return Date.parseDate(v, df); |
---|
154 | } |
---|
155 | var parsed = Date.parse(v); |
---|
156 | return parsed ? new Date(parsed) : null; |
---|
157 | }, |
---|
158 | sortType: st.asDate, |
---|
159 | type: 'date' |
---|
160 | } |
---|
161 | }); |
---|
162 | |
---|
163 | Ext.apply(this, { |
---|
164 | /** |
---|
165 | * @type Object. |
---|
166 | * @property BOOLEAN |
---|
167 | * <p>This data type means that the raw data is converted into a boolean before it is placed into |
---|
168 | * a Record. The string "true" and the number 1 are converted to boolean <code>true</code>.</p> |
---|
169 | * <p>The synonym <code>BOOL</code> is equivalent.</p> |
---|
170 | */ |
---|
171 | BOOLEAN: this.BOOL, |
---|
172 | /** |
---|
173 | * @type Object. |
---|
174 | * @property INTEGER |
---|
175 | * This data type means that the raw data is converted into an integer before it is placed into a Record. |
---|
176 | * <p>The synonym <code>INT</code> is equivalent.</p> |
---|
177 | */ |
---|
178 | INTEGER: this.INT, |
---|
179 | /** |
---|
180 | * @type Object. |
---|
181 | * @property NUMBER |
---|
182 | * This data type means that the raw data is converted into a number before it is placed into a Record. |
---|
183 | * <p>The synonym <code>FLOAT</code> is equivalent.</p> |
---|
184 | */ |
---|
185 | NUMBER: this.FLOAT |
---|
186 | }); |
---|
187 | }; |
---|