Commit | Line | Data |
---|---|---|
3bfc1d20 NR |
1 | package be.nikiroo.utils.resources; |
2 | ||
3 | import java.util.ArrayList; | |
4 | import java.util.List; | |
5 | ||
6 | /** | |
7 | * Internal class used to convert data to/from {@link String}s in the context of | |
8 | * {@link Bundle}s. | |
9 | * | |
10 | * @author niki | |
11 | */ | |
12 | class BundleHelper { | |
13 | /** | |
14 | * Convert the given {@link String} into a {@link Boolean} if it represents | |
15 | * a {@link Boolean}, or NULL if it doesn't. | |
16 | * <p> | |
17 | * Note: null, "strange text", ""... will all be converted to NULL. | |
18 | * | |
19 | * @param str | |
20 | * the input {@link String} | |
21 | * | |
22 | * @return the converted {@link Boolean} or NULL | |
23 | */ | |
24 | static public Boolean parseBoolean(String str) { | |
25 | if (str != null && str.length() > 0) { | |
26 | if (str.equalsIgnoreCase("true") || str.equalsIgnoreCase("on") | |
27 | || str.equalsIgnoreCase("yes")) | |
28 | return true; | |
29 | if (str.equalsIgnoreCase("false") || str.equalsIgnoreCase("off") | |
30 | || str.equalsIgnoreCase("no")) | |
31 | return false; | |
32 | ||
33 | } | |
34 | ||
35 | return null; | |
36 | } | |
37 | ||
38 | /** | |
39 | * Return a {@link String} representation of the given {@link Boolean}. | |
40 | * | |
41 | * @param value | |
42 | * the input value | |
43 | * | |
44 | * @return the raw {@link String} value that correspond to it | |
45 | */ | |
46 | static public String fromBoolean(boolean value) { | |
47 | return Boolean.toString(value); | |
48 | } | |
49 | ||
50 | /** | |
51 | * Convert the given {@link String} into a {@link Integer} if it represents | |
52 | * a {@link Integer}, or NULL if it doesn't. | |
53 | * <p> | |
54 | * Note: null, "strange text", ""... will all be converted to NULL. | |
55 | * | |
56 | * @param str | |
57 | * the input {@link String} | |
58 | * | |
59 | * @return the converted {@link Integer} or NULL | |
60 | */ | |
61 | static public Integer parseInteger(String str) { | |
62 | try { | |
63 | return Integer.parseInt(str); | |
64 | } catch (Exception e) { | |
65 | } | |
66 | ||
67 | return null; | |
68 | } | |
69 | ||
70 | /** | |
71 | * Return a {@link String} representation of the given {@link Integer}. | |
72 | * | |
73 | * @param value | |
74 | * the input value | |
75 | * | |
76 | * @return the raw {@link String} value that correspond to it | |
77 | */ | |
78 | static public String fromInteger(int value) { | |
79 | return Integer.toString(value); | |
80 | } | |
81 | ||
82 | /** | |
83 | * Return a {@link String} representation of the given {@link Integer}. | |
84 | * | |
85 | * @param value | |
86 | * the input value | |
87 | * | |
88 | * @return the raw {@link String} value that correspond to it | |
89 | */ | |
90 | static public String fromBoolean(int value) { | |
91 | return Integer.toString(value); | |
92 | } | |
93 | ||
94 | /** | |
95 | * Convert the given {@link String} into a {@link Character} if it | |
96 | * represents a {@link Character}, or NULL if it doesn't. | |
97 | * <p> | |
98 | * Note: null, "strange text", ""... will all be converted to NULL | |
99 | * (remember: any {@link String} whose length is not 1 is <b>not</b> a | |
100 | * {@link Character}). | |
101 | * | |
102 | * @param str | |
103 | * the input {@link String} | |
104 | * | |
105 | * @return the converted {@link Character} or NULL | |
106 | */ | |
107 | static public Character parseCharacter(String str) { | |
108 | String s = str.trim(); | |
109 | if (s.length() == 1) { | |
110 | return s.charAt(0); | |
111 | } | |
112 | ||
113 | return null; | |
114 | } | |
115 | ||
116 | /** | |
117 | * Return a {@link String} representation of the given {@link Boolean}. | |
118 | * | |
119 | * @param value | |
120 | * the input value | |
121 | * | |
122 | * @return the raw {@link String} value that correspond to it | |
123 | */ | |
124 | static public String fromCharacter(char value) { | |
125 | return Character.toString(value); | |
126 | } | |
127 | ||
128 | /** | |
129 | * Convert the given {@link String} into a colour (represented here as an | |
130 | * {@link Integer}) if it represents a colour, or NULL if it doesn't. | |
131 | * <p> | |
132 | * The returned colour value is an ARGB value. | |
133 | * | |
134 | * @param str | |
135 | * the input {@link String} | |
136 | * | |
137 | * @return the converted colour as an {@link Integer} value or NULL | |
138 | */ | |
139 | static Integer parseColor(String str) { | |
140 | Integer rep = null; | |
141 | ||
142 | str = str.trim(); | |
143 | int r = 0, g = 0, b = 0, a = -1; | |
144 | if (str.startsWith("#") && (str.length() == 7 || str.length() == 9)) { | |
145 | try { | |
146 | r = Integer.parseInt(str.substring(1, 3), 16); | |
147 | g = Integer.parseInt(str.substring(3, 5), 16); | |
148 | b = Integer.parseInt(str.substring(5, 7), 16); | |
149 | if (str.length() == 9) { | |
150 | a = Integer.parseInt(str.substring(7, 9), 16); | |
151 | } else { | |
152 | a = 255; | |
153 | } | |
154 | ||
155 | } catch (NumberFormatException e) { | |
156 | // no changes | |
157 | } | |
158 | } | |
159 | ||
160 | // Try by name if still not found | |
161 | if (a == -1) { | |
162 | if ("black".equalsIgnoreCase(str)) { | |
163 | a = 255; | |
164 | r = 0; | |
165 | g = 0; | |
166 | b = 0; | |
167 | } else if ("white".equalsIgnoreCase(str)) { | |
168 | a = 255; | |
169 | r = 255; | |
170 | g = 255; | |
171 | b = 255; | |
172 | } else if ("red".equalsIgnoreCase(str)) { | |
173 | a = 255; | |
174 | r = 255; | |
175 | g = 0; | |
176 | b = 0; | |
177 | } else if ("green".equalsIgnoreCase(str)) { | |
178 | a = 255; | |
179 | r = 0; | |
180 | g = 255; | |
181 | b = 0; | |
182 | } else if ("blue".equalsIgnoreCase(str)) { | |
183 | a = 255; | |
184 | r = 0; | |
185 | g = 0; | |
186 | b = 255; | |
187 | } else if ("grey".equalsIgnoreCase(str) | |
188 | || "gray".equalsIgnoreCase(str)) { | |
189 | a = 255; | |
190 | r = 128; | |
191 | g = 128; | |
192 | b = 128; | |
193 | } else if ("cyan".equalsIgnoreCase(str)) { | |
194 | a = 255; | |
195 | r = 0; | |
196 | g = 255; | |
197 | b = 255; | |
198 | } else if ("magenta".equalsIgnoreCase(str)) { | |
199 | a = 255; | |
200 | r = 255; | |
201 | g = 0; | |
202 | b = 255; | |
203 | } else if ("yellow".equalsIgnoreCase(str)) { | |
204 | a = 255; | |
205 | r = 255; | |
206 | g = 255; | |
207 | b = 0; | |
208 | } | |
209 | } | |
210 | ||
211 | if (a != -1) { | |
212 | rep = ((a & 0xFF) << 24) // | |
213 | | ((r & 0xFF) << 16) // | |
214 | | ((g & 0xFF) << 8) // | |
215 | | ((b & 0xFF) << 0); | |
216 | } | |
217 | ||
218 | return rep; | |
219 | } | |
220 | ||
221 | /** | |
222 | * Return a {@link String} representation of the given colour. | |
223 | * <p> | |
224 | * The colour value is interpreted as an ARGB value. | |
225 | * | |
226 | * @param color | |
227 | * the ARGB colour value | |
228 | * @return the raw {@link String} value that correspond to it | |
229 | */ | |
9e834013 | 230 | static public String fromColor(int color) { |
3bfc1d20 NR |
231 | int a = (color >> 24) & 0xFF; |
232 | int r = (color >> 16) & 0xFF; | |
233 | int g = (color >> 8) & 0xFF; | |
234 | int b = (color >> 0) & 0xFF; | |
235 | ||
236 | String rs = Integer.toString(r, 16); | |
237 | String gs = Integer.toString(g, 16); | |
238 | String bs = Integer.toString(b, 16); | |
239 | String as = ""; | |
240 | if (a < 255) { | |
241 | as = Integer.toString(a, 16); | |
242 | } | |
243 | ||
244 | return "#" + rs + gs + bs + as; | |
245 | } | |
246 | ||
247 | /** | |
248 | * Return a {@link String} representation of the given list of values. | |
249 | * <p> | |
250 | * The list of values is comma-separated and each value is surrounded by | |
251 | * double-quotes; backslashes and double-quotes are escaped by a backslash. | |
252 | * | |
253 | * @param str | |
254 | * the input value | |
255 | * @return the raw {@link String} value that correspond to it | |
256 | */ | |
257 | static public List<String> parseList(String str) { | |
258 | if (str == null) { | |
259 | return null; | |
260 | } | |
261 | List<String> list = new ArrayList<String>(); | |
262 | try { | |
263 | boolean inQuote = false; | |
264 | boolean prevIsBackSlash = false; | |
265 | StringBuilder builder = new StringBuilder(); | |
266 | for (int i = 0; i < str.length(); i++) { | |
267 | char car = str.charAt(i); | |
268 | ||
269 | if (prevIsBackSlash) { | |
b15a4985 | 270 | // We don't process it here |
3bfc1d20 NR |
271 | builder.append(car); |
272 | prevIsBackSlash = false; | |
273 | } else { | |
274 | switch (car) { | |
275 | case '"': | |
b15a4985 NR |
276 | // We don't process it here |
277 | builder.append(car); | |
278 | ||
3bfc1d20 | 279 | if (inQuote) { |
b15a4985 | 280 | list.add(unescape(builder.toString())); |
3bfc1d20 NR |
281 | builder.setLength(0); |
282 | } | |
283 | ||
284 | inQuote = !inQuote; | |
285 | break; | |
286 | case '\\': | |
b15a4985 NR |
287 | // We don't process it here |
288 | builder.append(car); | |
3bfc1d20 NR |
289 | prevIsBackSlash = true; |
290 | break; | |
291 | case ' ': | |
292 | case '\n': | |
293 | case '\r': | |
294 | if (inQuote) { | |
295 | builder.append(car); | |
296 | } | |
297 | break; | |
298 | ||
299 | case ',': | |
300 | if (!inQuote) { | |
301 | break; | |
302 | } | |
303 | // continue to default | |
304 | default: | |
305 | if (!inQuote) { | |
306 | // Bad format! | |
307 | return null; | |
308 | } | |
309 | ||
310 | builder.append(car); | |
311 | break; | |
312 | } | |
313 | } | |
314 | } | |
315 | ||
316 | if (inQuote || prevIsBackSlash) { | |
317 | // Bad format! | |
318 | return null; | |
319 | } | |
320 | ||
321 | } catch (Exception e) { | |
322 | return null; | |
323 | } | |
324 | ||
325 | return list; | |
326 | } | |
327 | ||
328 | /** | |
329 | * Return a {@link String} representation of the given list of values. | |
330 | * | |
331 | * @param list | |
332 | * the input value | |
333 | * | |
334 | * @return the raw {@link String} value that correspond to it | |
335 | */ | |
336 | static public String fromList(List<String> list) { | |
337 | StringBuilder builder = new StringBuilder(); | |
338 | for (String item : list) { | |
339 | if (builder.length() > 0) { | |
340 | builder.append(", "); | |
341 | } | |
b15a4985 NR |
342 | builder.append(escape(item)); |
343 | } | |
344 | ||
345 | return builder.toString(); | |
346 | } | |
347 | ||
348 | /** | |
349 | * Escape the given value for list formating (no \\, no \n). | |
350 | * <p> | |
351 | * You can unescape it with {@link BundleHelper#unescape(String)} | |
352 | * | |
353 | * @param value | |
354 | * the value to escape | |
355 | * | |
356 | * @return an escaped value that can unquoted by the reverse operation | |
357 | * {@link BundleHelper#unescape(String)} | |
358 | */ | |
359 | static public String escape(String value) { | |
360 | return '"' + value// | |
361 | .replace("\\", "\\\\") // | |
362 | .replace("\"", "\\\"") // | |
363 | .replace("\n", "\\\n") // | |
364 | .replace("\r", "\\\r") // | |
365 | + '"'; | |
366 | } | |
367 | ||
368 | /** | |
369 | * Unescape the given value for list formating (change \\n into \n and so | |
370 | * on). | |
371 | * <p> | |
372 | * You can escape it with {@link BundleHelper#escape(String)} | |
373 | * | |
374 | * @param value | |
375 | * the value to escape | |
376 | * | |
377 | * @return an unescaped value that can reverted by the reverse operation | |
378 | * {@link BundleHelper#escape(String)}, or NULL if it was badly | |
379 | * formated | |
380 | */ | |
381 | static public String unescape(String value) { | |
382 | if (value.length() < 2 || !value.startsWith("\"") | |
383 | || !value.endsWith("\"")) { | |
384 | // Bad format | |
385 | return null; | |
386 | } | |
387 | ||
388 | value = value.substring(1, value.length() - 2); | |
389 | ||
390 | boolean prevIsBackslash = false; | |
391 | StringBuilder builder = new StringBuilder(); | |
392 | for (char car : value.toCharArray()) { | |
393 | if (prevIsBackslash) { | |
394 | switch (car) { | |
395 | case 'n': | |
396 | case 'N': | |
397 | builder.append('\n'); | |
398 | break; | |
399 | case 'r': | |
400 | case 'R': | |
401 | builder.append('\r'); | |
402 | break; | |
403 | default: // includes \ and " | |
404 | builder.append(car); | |
405 | break; | |
406 | } | |
407 | } else { | |
408 | if (car == '\\') { | |
409 | prevIsBackslash = true; | |
410 | } else { | |
411 | builder.append(car); | |
412 | } | |
413 | } | |
414 | } | |
415 | ||
416 | if (prevIsBackslash) { | |
417 | // Bad format | |
418 | return null; | |
3bfc1d20 NR |
419 | } |
420 | ||
421 | return builder.toString(); | |
422 | } | |
423 | } |