1 /*
2 * Copyright (c) 2007, 2012, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 */
23 /*
24 * @test
25 * @bug 4052473 4052679 4055602 4066550 4067619 4068012 4068073 4070174 4070452
26 * 4070178 4070450 4070695 4070725 4070795 4071003 4071183 4071782 4072013
27 * 4072388 4072773 4075404 4084356 4087238 4092361 4094033 4094371 4098518
28 * 4099810 4103218 4103220 4103861 4112136 4113638 4113654 4117054 4122468
29 * 4122840 4139860 4156708 4175306 4215747 4209960 4290801 4900884 4942982
30 * 4518811 4945388 4936845 4794068 4461740 4965260 4984277 4826794 5032580
31 * 5102005 5074431 6182685 6208712 6277020 6245766 6351682 6386647 6379382
32 * 6414459 6455680 6498742 6558863 6488119 6547501 6497154 6558856 6481177
33 * 6379214 6485516 6486607 4225362 4494727 6533691 6531591 6531593 6570259
34 * 6509039 6609737 6610748 6645271 6507067 6873931 6450945 6645268 6646611
35 * 6645405 6650730 6910489 6573250 6870908 6585666 6716626 6914413 6916787
36 * 6919624 6998391 7019267 7020960 7025837 7020583 7036905 7066203 7101495
37 * 7003124 7085757 7028073 7171028
38 * @summary Verify locale data
39 *
40 */
41
42 /*
43 *
44 * (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved
45 * (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved
46 *
47 * Portions copyright (c) 2007 Sun Microsystems, Inc.
48 * All Rights Reserved.
49 *
50 * The original version of this source code and documentation
51 * is copyrighted and owned by Taligent, Inc., a wholly-owned
52 * subsidiary of IBM. These materials are provided under terms
53 * of a License Agreement between Taligent and Sun. This technology
54 * is protected by multiple US and International patents.
55 *
56 * This notice and attribution to Taligent may not be removed.
57 * Taligent is a registered trademark of Taligent, Inc.
58 *
59 * Permission to use, copy, modify, and distribute this software
60 * and its documentation for NON-COMMERCIAL purposes and without
61 * fee is hereby granted provided that this copyright notice
62 * appears in all copies. Please refer to the file "copyright.html"
63 * for further important copyright and licensing information.
64 *
65 * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
66 * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
67 * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
68 * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
69 * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
70 * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
71 *
72 */
73
74 /* This test is a generalized test for verifying changes to the locale data.
75 * It is driven by an external file that specifies the particular pieces of locale
76 * data to check. That file is in .properties file format: a series of key/value
77 * pairs delimited by newline characters, with the keys separated from the values
78 * by = signs. The keys are similar in syntax to a Unix pathname, with keys at
79 * successive levels of containment in the resource-data hierarchy separated by
80 * slashes. The file is in ISO 8859-1 encoding, with control characters and
81 * non-ASCII characters denoted with backslash-u escape sequences. The program also allows
82 * blank lines and comment lines to be interspersed with the data. Comment lines
83 * begin with '#'.
84 *
85 * A data file for this test would look something like this:<pre>
86 * FormatData//MonthNames/0=January
87 * FormatData//MonthNames/1=February
88 * LocaleNames//US=United States
89 * LocaleNames//FR=France
90 * FormatData/fr_FR/MonthNames/0=janvier
91 * FormatData/fr_FR/MonthNames/1=f\u00e9vrier
92 * LocaleNames/fr_FR/US=\u00c9tats-Unis
93 * LocaleNames/fr_FR/FR=France</pre>
94 *
95 * You can use language tag with '-' in locale field like this:<pre>
96 * LocaleNames/sr-Latn/SR=Surinam
97 * FormatData/sr-Latn-BA/DayNames/2=utorak</pre>
98 *
99 * The command-line syntax of this test is
100 * <tt>java LocaleDataTest [-w] [{ -s | <filename> }]</tt>
101 *
102 * This program always sends its results to standard output. If -w is not specified,
103 * this program prints out only the differences between the data file and the actual
104 * resource data. If -w is specified, the program prints out every entry, comment,
105 * and blank line from the data file. Where there is a difference between the data
106 * file and the resource data, the data is the data from the resources. This feature
107 * can be used to quickly generate a new data file.
108 *
109 * The user can specify an optional filename or -s. If the user specifies a filename,
110 * the program uses that file as the data file. If the user specifies -s, the program
111 * reads its input from standard input rather than from a file. If the user specifies
112 * neither, the program reads its input from a file called LocaleData in the same
113 * directory the program itself resides in.
114 *
115 * The -nothrow option prevents the program from throwing an exception when it
116 * gets an error. -w implies -nothrow.
117 *
118 * Other command-line options can be specified, but are ignored.
119 *
120 * It's important to note what this test will NOT test. Certain changes to the locale
121 * data are meant to have certain effects on the internationalization frameworks. For
122 * instance, we could ensure round-trip formatting/parsing integrity for the full
123 * date/time format of SimpleDateFormat by making sure that the full date and time
124 * patterns include sufficient data. The test of this is not whether changes were
125 * made to the locale data; it's whether using this data gives round-trip integrity.
126 * Likewise, changing the currency patterns to use \u00a4 instead of local currency
127 * symbols isn't something that can be tested by this test; instead, you want to
128 * actually format currency values and make sure the proper currency symbol was used.
129 *
130 * This test by itself doesn't do an exhaustive comparison of locale data. It is
131 * possible to do this manually, however: Use the GenerateKeyList tool to produce
132 * a complete list of keys for the two versions of the locales you want to compare,
133 * and then diff them. This will flag additions and deletions. Generate a data file
134 * for the base version of the data using the -w option and the output from
135 * GenerateKeyList, and then use the resultant file as the data file when you run
136 * this test against the new version of the data.
137 */
138
139 import java.io.*;
140 import java.text.*;
141 import java.util.Locale;
142 import java.util.ResourceBundle;
143 import java.util.ResourceBundle.Control;
144 import java.util.MissingResourceException;
145
146 public class LocaleDataTest
147 {
148 public static void main(String[] args) throws Exception {
149
150 // set up our flags and our input and output streams based on the
151 // command-line arguments (exceptions generated here will propagate out
152 // to the environment)
153 BufferedReader in = null;
154 PrintWriter out = null;
155 boolean writeNewFile = false;
156 boolean doThrow = true;
157
158 for (int i = 0; i < args.length; i++) {
159 if (args[i].equals("-w")) {
160 writeNewFile = true;
161 doThrow = false;
162 }
163
164 else if (args[i].equals("-nothrow"))
165 doThrow = false;
166
167 else if (args[i].equals("-s") && in == null)
168 in = new BufferedReader(new EscapeReader(new InputStreamReader(System.in,
169 "ISO8859_1")));
170 else if (!args[i].startsWith("-") && in == null)
171 in = new BufferedReader(new EscapeReader(new InputStreamReader(new
172 FileInputStream(args[i]), "ISO8859_1")));
173 }
174 if (in == null) {
175 File localeData = new File(System.getProperty("test.src", "."), "LocaleData");
176 in = new BufferedReader(new EscapeReader(new InputStreamReader(new
177 FileInputStream(localeData), "ISO8859_1")));
178 }
179 out = new PrintWriter(new EscapeWriter(new OutputStreamWriter(System.out,
180 "ISO8859_1")), true);
181
182 // perform the actual test
183 int errorCount = doTest(in, out, writeNewFile);
184
185 // write out the error count, and throw an exception out into the environment
186 // if there were any errors
187 if (errorCount != 0) {
188 if (!writeNewFile)
189 out.println("Test failed. " + errorCount + " errors.");
190 if (doThrow)
191 throw new Exception("Test failed. " + errorCount + " errors.");
192 }
193 else if (!writeNewFile)
194 out.println("Test passed.");
195
196 in.close();
197 out.close();
198 }
199
200 static int doTest(BufferedReader in, PrintWriter out, boolean writeNewFile)
201 throws Exception {
202 int errorCount = 0;
203
204 String key = null;
205 String expectedValue = null;
206 String line = in.readLine();
207 while (line != null) {
208 if (line.startsWith("#") || line.length() == 0) {
209 if (writeNewFile)
210 out.println(line);
211 }
212
213 else {
214 int index = line.indexOf("=");
215 if (index == -1) {
216 key = line;
217 expectedValue = "";
218 }
219 else {
220 key = line.substring(0, index);
221 if (index + 1 == line.length())
222 expectedValue = "";
223 else
224 expectedValue = line.substring(index + 1);
225 }
226 if (!processLine(key, expectedValue, out, writeNewFile))
227 ++errorCount;
228 }
229 line = in.readLine();
230 }
231 return errorCount;
232 }
233
234 static boolean processLine(String key, String expectedValue, PrintWriter out,
235 boolean writeNewFile) throws Exception {
236 String rbName, localeName, resTag, qualifier;
237 String language = "", country = "", variant = "";
238 int index, oldIndex;
239
240 index = key.indexOf("/");
241 if (index == -1 || index + 1 == key.length())
242 throw new Exception("Malformed input file: no slashes in \"" + key + "\"");
243 rbName = key.substring(0, index);
244
245 oldIndex = index + 1;
246 index = key.indexOf("/", oldIndex);
247 if (index == -1 || index + 1 == key.length())
248 throw new Exception("Malformed input file: \"" + key + "\" is missing locale name");
249 localeName = key.substring(oldIndex, index);
250 boolean use_tag = localeName.indexOf("-") != -1;
251
252 if (use_tag == false && localeName.length() > 0) {
253 language = localeName.substring(0, 2);
254 if (localeName.length() > 3) {
255 country = localeName.substring(3, 5);
256 if (localeName.length() > 5)
257 variant = localeName.substring(6);
258 }
259 }
260
261 oldIndex = index + 1;
262 index = key.indexOf("/", oldIndex);
263 if (index == -1)
264 index = key.length();
265 resTag = key.substring(oldIndex, index);
266
267 // TimeZone name may have "/" in it, for example "Asia/Taipei", so use "Asia\/Taipei in LocaleData.
268 if(resTag.endsWith("\\")) {
269 resTag = resTag.substring(0, resTag.length() - 1);
270 oldIndex = index;
271 index = key.indexOf("/", oldIndex + 1);
272 if (index == -1) index = key.length();
273 resTag += key.substring(oldIndex, index);
274 }
275
276 if (index < key.length() - 1)
277 qualifier = key.substring(index + 1);
278 else
279 qualifier = "";
280
281 String retrievedValue = null;
282 Object resource = null;
283 try {
284 String fullName = null;
285 if (rbName.equals("CalendarData")
286 || rbName.equals("CurrencyNames")
287 || rbName.equals("LocaleNames")
288 || rbName.equals("TimeZoneNames")) {
289 fullName = "sun.util.resources." + rbName;
290 } else {
291 fullName = "sun.text.resources." + rbName;
292 }
293 Locale locale;
294 if (use_tag) {
295 locale = Locale.forLanguageTag(localeName);
296 } else {
297 locale = new Locale(language, country, variant);
298 }
299 ResourceBundle bundle = ResourceBundle.getBundle(fullName,
300 locale,
301 ResourceBundle.Control.getNoFallbackControl(Control.FORMAT_DEFAULT));
302 resource = bundle.getObject(resTag);
303 }
304 catch (MissingResourceException e) {
305 }
306
307 if (resource != null) {
308 if (resource instanceof String) {
309 retrievedValue = (String)resource;
310 }
311 else if (resource instanceof String[]) {
312 int element = Integer.valueOf(qualifier).intValue();
313 String[] stringList = (String[])resource;
314 if (element >= 0 || element < stringList.length)
315 retrievedValue = stringList[element];
316 }
317 else if (resource instanceof String[][]) {
318 String[][] stringArray = (String[][])resource;
319 int slash = qualifier.indexOf("/");
320 if (slash == -1) {
321 for (int i = 0; i < stringArray.length; i++) {
322 if (stringArray[i][0].equals(qualifier))
323 retrievedValue = stringArray[i][1];
324 }
325 }
326 else {
327 int row = Integer.valueOf(qualifier.substring(0, slash)).intValue();
328 int column = Integer.valueOf(qualifier.substring(slash + 1)).intValue();
329 if (row >= 0 || row < stringArray.length || column >= 0 || column <
330 stringArray[row].length)
331 retrievedValue = stringArray[row][column];
332 }
333 }
334 }
335
336 if (retrievedValue == null || !retrievedValue.equals(expectedValue)) {
337 if (retrievedValue == null)
338 retrievedValue = "<MISSING!>";
339
340 if (writeNewFile)
341 out.println(key + "=" + retrievedValue);
342 else {
343 out.println("Mismatch in " + key + ":");
344 out.println(" file = \"" + expectedValue + "\"");
345 out.println(" jvm = \"" + retrievedValue + "\"");
346 }
347 return false;
348 }
349 else {
350 if (writeNewFile)
351 out.println(key + "=" + expectedValue);
352 }
353 return true;
354 }
355 }
356
357 class EscapeReader extends FilterReader {
358 public EscapeReader(Reader in) {
359 super(in);
360 }
361
362 public int read() throws IOException {
363 if (buffer != null) {
364 String b = buffer.toString();
365 int result = b.charAt(0);
366 if (b.length() > 1)
367 buffer = new StringBuffer(b.substring(1));
368 else
369 buffer = null;
370 return result;
371 }
372 else {
373 int result = super.read();
374 if (result != '\\')
375 return result;
376 else {
377 buffer = new StringBuffer();
378 result = super.read();
379 buffer.append((char)result);
380 if (result == 'u') {
381 for (int i = 0; i < 4; i++) {
382 result = super.read();
383 if (result == -1)
384 break;
385 buffer.append((char)result);
386 }
387 String number = buffer.toString().substring(1);
388 result = Integer.parseInt(number, 16);
389 buffer = null;
390 return result;
391 }
392 return '\\';
393 }
394 }
395 }
396
397 public int read(char[] cbuf, int start, int len) throws IOException {
398 int p = start;
399 int end = start + len;
400 int c = 0;
401 while (c != -1 && p < end) {
402 c = read();
403 if (c != -1)
404 cbuf[p++] = (char)c;
405 }
406 if (c == -1 && p == start)
407 return -1;
408 else
409 return p - start;
410 }
411
412 private StringBuffer buffer = null;
413 }
414
415 class EscapeWriter extends FilterWriter {
416 public EscapeWriter(Writer out) {
417 super(out);
418 }
419
420 public void write(int c) throws IOException {
421 if ((c >= ' ' && c <= '\u007e') || c == '\r' || c == '\n')
422 super.write(c);
423 else {
424 super.write('\\');
425 super.write('u');
426 String number = Integer.toHexString(c);
427 if (number.length() < 4)
428 number = zeros.substring(0, 4 - number.length()) + number;
429 super.write(number.charAt(0));
430 super.write(number.charAt(1));
431 super.write(number.charAt(2));
432 super.write(number.charAt(3));
433 }
434 }
435
436 public void write(char[] cbuf, int off, int len) throws IOException {
437 int end = off + len;
438 while (off < end)
439 write(cbuf[off++]);
440 }
441
442 public void write(String str, int off, int len) throws IOException {
443 int end = off + len;
444 while (off < end)
445 write(str.charAt(off++));
446 }
447
448 private static String zeros = "0000";
449 }