| /* | |
| * Copyright (c) 2007, 2025, Oracle and/or its affiliates. All rights reserved. | |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| * | |
| * This code is free software; you can redistribute it and/or modify it | |
| * under the terms of the GNU General Public License version 2 only, as | |
| * published by the Free Software Foundation. | |
| * | |
| * This code is distributed in the hope that it will be useful, but WITHOUT | |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| * version 2 for more details (a copy is included in the LICENSE file that | |
| * accompanied this code). | |
| * | |
| * You should have received a copy of the GNU General Public License version | |
| * 2 along with this work; if not, write to the Free Software Foundation, | |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| * | |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| * or visit www.oracle.com if you need additional information or have any | |
| * questions. | |
| */ | |
| /* | |
| * @test | |
| * @bug 4052473 4052679 4055602 4066550 4067619 4068012 4068073 4070174 4070452 | |
| * 4070178 4070450 4070695 4070725 4070795 4071003 4071183 4071782 4072013 | |
| * 4072388 4072773 4075404 4084356 4087238 4092361 4094033 4094371 4098518 | |
| * 4099810 4103218 4103220 4103861 4112136 4113638 4113654 4117054 4122468 | |
| * 4122840 4139860 4156708 4175306 4215747 4209960 4290801 4900884 4942982 | |
| * 4518811 4945388 4936845 4794068 4461740 4965260 4984277 4826794 5032580 | |
| * 5102005 5074431 6182685 6208712 6277020 6245766 6351682 6386647 6379382 | |
| * 6414459 6455680 6498742 6558863 6488119 6547501 6497154 6558856 6481177 | |
| * 6379214 6485516 6486607 4225362 4494727 6533691 6531591 6531593 6570259 | |
| * 6509039 6609737 6610748 6645271 6507067 6873931 6450945 6645268 6646611 | |
| * 6645405 6650730 6910489 6573250 6870908 6585666 6716626 6914413 6916787 | |
| * 6919624 6998391 7019267 7020960 7025837 7020583 7036905 7066203 7101495 | |
| * 7003124 7085757 7028073 7171028 7189611 8000983 7195759 8004489 8006509 | |
| * 7114053 7074882 7040556 8008577 8013836 8021121 6192407 6931564 8027695 | |
| * 8017142 8037343 8055222 8042126 8074791 8075173 8080774 8129361 8134916 | |
| * 8145136 8145952 8164784 8037111 8081643 7037368 8178872 8185841 8190918 | |
| * 8187946 8195478 8181157 8179071 8193552 8202026 8204269 8202537 8208746 | |
| * 8209775 8221432 8227127 8230284 8231273 8233579 8234288 8250665 8255086 | |
| * 8251317 8274658 8283277 8283805 8265315 8287868 8295564 8284840 8296715 | |
| * 8301206 8303472 8317979 8306116 8174269 8333582 8357075 8357882 8367021 | |
| * @summary Verify locale data | |
| * @modules java.base/sun.util.resources | |
| * @modules jdk.localedata | |
| * @run main LocaleDataTest | |
| * | |
| */ | |
| /* | |
| * This file is available under and governed by the GNU General Public | |
| * License version 2 only, as published by the Free Software Foundation. | |
| * However, the following notice accompanied the original version of this | |
| * file and, per its terms, should not be removed: | |
| * | |
| * (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved | |
| * (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved | |
| * | |
| * Portions copyright (c) 2007 Sun Microsystems, Inc. | |
| * All Rights Reserved. | |
| * | |
| * The original version of this source code and documentation | |
| * is copyrighted and owned by Taligent, Inc., a wholly-owned | |
| * subsidiary of IBM. These materials are provided under terms | |
| * of a License Agreement between Taligent and Sun. This technology | |
| * is protected by multiple US and International patents. | |
| * | |
| * This notice and attribution to Taligent may not be removed. | |
| * Taligent is a registered trademark of Taligent, Inc. | |
| * | |
| * Permission to use, copy, modify, and distribute this software | |
| * and its documentation for NON-COMMERCIAL purposes and without | |
| * fee is hereby granted provided that this copyright notice | |
| * appears in all copies. Please refer to the file "copyright.html" | |
| * for further important copyright and licensing information. | |
| * | |
| * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF | |
| * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED | |
| * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A | |
| * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR | |
| * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR | |
| * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. | |
| * | |
| */ | |
| /* This test is a generalized test for verifying changes to the locale data. | |
| * It is driven by an external file that specifies the particular pieces of locale | |
| * data to check. That file is in .properties file format: a series of key/value | |
| * pairs delimited by newline characters, with the keys separated from the values | |
| * by = signs. The keys are similar in syntax to a Unix pathname, with keys at | |
| * successive levels of containment in the resource-data hierarchy separated by | |
| * slashes. The file is in UTF-8 encoding. The program also allows blank lines | |
| * and comment lines to be interspersed with the data. Comment lines | |
| * begin with '#'. | |
| * | |
| * A data file for this test would look something like this:<pre> | |
| * FormatData//MonthNames/0=January | |
| * FormatData//MonthNames/1=February | |
| * LocaleNames//US=United States | |
| * LocaleNames//FR=France | |
| * FormatData/fr_FR/MonthNames/0=janvier | |
| * FormatData/fr_FR/MonthNames/1=février | |
| * LocaleNames/fr_FR/US=États-Unis | |
| * LocaleNames/fr_FR/FR=France</pre> | |
| * | |
| * Second field which designates locale is in the form of: | |
| * 1) Legacy locale notation using '_' as a locale component(language/country/variant) separator. | |
| * language is a mandatory component. country and variant are optional, however, | |
| * variant cannot exist without country. So for example, while "ja"/"ja_JP"/"ja_JP_JP" are valid, | |
| * "_JP"/"ja__JP" are invalid. | |
| * | |
| * 2) BCP47 language tag notation in which we can specify language tag with '-' as a subtag | |
| * separator. Language tag can be specified with '-' in locale field like this: | |
| * <pre>LocaleNames/sr-Latn/SR=Surinam | |
| * FormatData/sr-Latn-BA/DayNames/2=utorak</pre> | |
| * | |
| * The command-line syntax of this test is | |
| * <tt>java --add-exports java.base/sun.util.resources=ALL-UNNAMED LocaleDataTest.java [-w] [{ -s | <filename> }]</tt> | |
| * | |
| * This program always sends its results to standard output. If -w is not specified, | |
| * this program prints out only the differences between the data file and the actual | |
| * resource data. If -w is specified, the program prints out every entry, comment, | |
| * and blank line from the data file. Where there is a difference between the data | |
| * file and the resource data, the data is the data from the resources. This feature | |
| * can be used to quickly generate a new data file. | |
| * | |
| * The user can specify an optional filename or -s. If the user specifies a filename, | |
| * the program uses that file as the data file. If the user specifies -s, the program | |
| * reads its input from standard input rather than from a file. If the user specifies | |
| * neither, the program reads its input from a file called LocaleData.cldr in the same | |
| * directory the program itself resides in. | |
| * | |
| * The -nothrow option prevents the program from throwing an exception when it | |
| * gets an error. -w implies -nothrow. | |
| * | |
| * Other command-line options can be specified, but are ignored. | |
| * | |
| * It's important to note what this test will NOT test. Certain changes to the locale | |
| * data are meant to have certain effects on the internationalization frameworks. For | |
| * instance, we could ensure round-trip formatting/parsing integrity for the full | |
| * date/time format of SimpleDateFormat by making sure that the full date and time | |
| * patterns include sufficient data. The test of this is not whether changes were | |
| * made to the locale data; it's whether using this data gives round-trip integrity. | |
| * Likewise, changing the currency patterns to use ¤ instead of local currency | |
| * symbols isn't something that can be tested by this test; instead, you want to | |
| * actually format currency values and make sure the proper currency symbol was used. | |
| * | |
| * This test by itself doesn't do an exhaustive comparison of locale data. It is | |
| * possible to do this manually, however: Use the GenerateKeyList tool to produce | |
| * a complete list of keys for the two versions of the locales you want to compare, | |
| * and then diff them. This will flag additions and deletions. Generate a data file | |
| * for the base version of the data using the -w option and the output from | |
| * GenerateKeyList, and then use the resultant file as the data file when you run | |
| * this test against the new version of the data. | |
| */ | |
| import java.io.BufferedReader; | |
| import java.io.File; | |
| import java.io.FileInputStream; | |
| import java.io.InputStreamReader; | |
| import java.io.OutputStreamWriter; | |
| import java.io.PrintWriter; | |
| import java.nio.charset.StandardCharsets; | |
| import java.util.Locale; | |
| import java.util.MissingResourceException; | |
| import java.util.ResourceBundle; | |
| import sun.util.resources.LocaleData; | |
| public class LocaleDataTest | |
| { | |
| static final String TEXT_RESOURCES_PACKAGE = "sun.text.resources.cldr"; | |
| static final String UTIL_RESOURCES_PACKAGE = "sun.util.resources.cldr"; | |
| static final String DEFAULT_DATAFILE = "LocaleData.cldr"; | |
| public static void main(String[] args) throws Exception { | |
| // set up our flags and our input and output streams based on the | |
| // command-line arguments (exceptions generated here will propagate out | |
| // to the environment) | |
| BufferedReader in = null; | |
| PrintWriter out = null; | |
| boolean writeNewFile = false; | |
| boolean doThrow = true; | |
| for (int i = 0; i < args.length; i++) { | |
| if (args[i].equals("-w")) { | |
| writeNewFile = true; | |
| doThrow = false; | |
| } | |
| else if (args[i].equals("-nothrow")) | |
| doThrow = false; | |
| else if (args[i].equals("-s") && in == null) | |
| in = new BufferedReader(new InputStreamReader(System.in, StandardCharsets.UTF_8)); | |
| else if (!args[i].startsWith("-") && in == null) | |
| in = new BufferedReader(new InputStreamReader(new | |
| FileInputStream(args[i]), StandardCharsets.UTF_8)); | |
| } | |
| if (in == null) { | |
| File localeData = new File(System.getProperty("test.src", "."), DEFAULT_DATAFILE); | |
| in = new BufferedReader(new InputStreamReader(new | |
| FileInputStream(localeData), StandardCharsets.UTF_8)); | |
| } | |
| out = new PrintWriter(new OutputStreamWriter(System.out, StandardCharsets.UTF_8), true); | |
| // perform the actual test | |
| int errorCount = doTest(in, out, writeNewFile); | |
| // write out the error count, and throw an exception out into the environment | |
| // if there were any errors | |
| if (errorCount != 0) { | |
| if (!writeNewFile) | |
| out.println("Test failed. " + errorCount + " errors."); | |
| if (doThrow) | |
| throw new Exception("Test failed. " + errorCount + " errors."); | |
| } | |
| else if (!writeNewFile) | |
| out.println("Test passed."); | |
| in.close(); | |
| out.close(); | |
| } | |
| static int doTest(BufferedReader in, PrintWriter out, boolean writeNewFile) | |
| throws Exception { | |
| int errorCount = 0; | |
| String key = null; | |
| String expectedValue = null; | |
| String line = in.readLine(); | |
| while (line != null) { | |
| if (line.startsWith("#") || line.length() == 0) { | |
| if (writeNewFile) | |
| out.println(line); | |
| } | |
| else { | |
| int index = line.indexOf("="); | |
| if (index == -1) { | |
| key = line; | |
| expectedValue = ""; | |
| } | |
| else { | |
| key = line.substring(0, index); | |
| if (index + 1 == line.length()) | |
| expectedValue = ""; | |
| else | |
| expectedValue = line.substring(index + 1); | |
| } | |
| if (!processLine(key, expectedValue, out, writeNewFile)) | |
| ++errorCount; | |
| } | |
| line = in.readLine(); | |
| } | |
| return errorCount; | |
| } | |
| static boolean processLine(String key, String expectedValue, PrintWriter out, | |
| boolean writeNewFile) throws Exception { | |
| String rbName, localeName, resTag, qualifier; | |
| String language = "", country = "", variant = ""; | |
| int index, oldIndex; | |
| index = key.indexOf("/"); | |
| if (index == -1 || index + 1 == key.length()) | |
| throw new Exception("Malformed input file: no slashes in \"" + key + "\""); | |
| rbName = key.substring(0, index); | |
| oldIndex = index + 1; | |
| index = key.indexOf("/", oldIndex); | |
| if (index == -1 || index + 1 == key.length()) | |
| throw new Exception("Malformed input file: \"" + key + "\" is missing locale name"); | |
| localeName = key.substring(oldIndex, index); | |
| boolean use_tag = localeName.indexOf("-") != -1; | |
| if (use_tag == false && localeName.length() > 0) { | |
| String[] locDetails = localeName.split("_"); | |
| switch (locDetails.length) { | |
| case 1: | |
| language = locDetails[0]; | |
| break; | |
| case 2: | |
| language = locDetails[0]; | |
| country = locDetails[1]; | |
| break; | |
| case 3: | |
| language = locDetails[0]; | |
| country = locDetails[1]; | |
| variant = locDetails[2]; | |
| break; | |
| default: | |
| throw new Exception("locale not specified properly " + locDetails); | |
| } | |
| } | |
| oldIndex = index + 1; | |
| index = key.indexOf("/", oldIndex); | |
| if (index == -1) | |
| index = key.length(); | |
| resTag = key.substring(oldIndex, index); | |
| // TimeZone name may have "/" in it, for example "Asia/Taipei", so use "Asia\/Taipei in LocaleData.cldr. | |
| if(resTag.endsWith("\\")) { | |
| resTag = resTag.substring(0, resTag.length() - 1); | |
| oldIndex = index; | |
| index = key.indexOf("/", oldIndex + 1); | |
| if (index == -1) index = key.length(); | |
| resTag += key.substring(oldIndex, index); | |
| } | |
| if (index < key.length() - 1) | |
| qualifier = key.substring(index + 1); | |
| else | |
| qualifier = ""; | |
| String retrievedValue = null; | |
| Object resource = null; | |
| try { | |
| String fullName = null; | |
| if (rbName.equals("CalendarData") | |
| || rbName.equals("CurrencyNames") | |
| || rbName.equals("LocaleNames") | |
| || rbName.equals("TimeZoneNames")) { | |
| fullName = UTIL_RESOURCES_PACKAGE + "." + rbName; | |
| } else { | |
| fullName = TEXT_RESOURCES_PACKAGE + "." + rbName; | |
| } | |
| Locale locale; | |
| if (use_tag) { | |
| locale = Locale.forLanguageTag(localeName); | |
| } else { | |
| locale = Locale.of(language, country, variant); | |
| } | |
| ResourceBundle bundle = LocaleData.getBundle(fullName, locale); | |
| resource = bundle.getObject(resTag); | |
| } | |
| catch (MissingResourceException e) { | |
| } | |
| if (resource != null) { | |
| if (resource instanceof String) { | |
| retrievedValue = (String)resource; | |
| } | |
| else if (resource instanceof String[]) { | |
| int element = Integer.valueOf(qualifier).intValue(); | |
| String[] stringList = (String[])resource; | |
| if (element >= 0 && element < stringList.length) | |
| retrievedValue = stringList[element]; | |
| } | |
| else if (resource instanceof String[][]) { | |
| String[][] stringArray = (String[][])resource; | |
| int slash = qualifier.indexOf("/"); | |
| if (slash == -1) { | |
| for (int i = 0; i < stringArray.length; i++) { | |
| if (stringArray[i][0].equals(qualifier)) | |
| retrievedValue = stringArray[i][1]; | |
| } | |
| } | |
| else { | |
| int row = Integer.valueOf(qualifier.substring(0, slash)).intValue(); | |
| int column = Integer.valueOf(qualifier.substring(slash + 1)).intValue(); | |
| if (row >= 0 && row < stringArray.length && column >= 0 && column < | |
| stringArray[row].length) | |
| retrievedValue = stringArray[row][column]; | |
| } | |
| } | |
| } | |
| if (retrievedValue == null || !retrievedValue.equals(expectedValue)) { | |
| if (retrievedValue == null) | |
| retrievedValue = "<MISSING!>"; | |
| if (writeNewFile) | |
| out.println(key + "=" + retrievedValue); | |
| else { | |
| out.println("Mismatch in " + key + ":"); | |
| out.println(" file = \"" + expectedValue + "\""); | |
| out.println(" jvm = \"" + retrievedValue + "\""); | |
| } | |
| return false; | |
| } | |
| else { | |
| if (writeNewFile) | |
| out.println(key + "=" + expectedValue); | |
| } | |
| return true; | |
| } | |
| } |