1 /*
2 * Copyright (c) 1996, 2010, 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. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 /*
27 * (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved
28 * (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved
29 *
30 * The original version of this source code and documentation is copyrighted
31 * and owned by Taligent, Inc., a wholly-owned subsidiary of IBM. These
32 * materials are provided under terms of a License Agreement between Taligent
33 * and Sun. This technology is protected by multiple US and International
34 * patents. This notice and attribution to Taligent may not be removed.
35 * Taligent is a registered trademark of Taligent, Inc.
36 *
37 */
38
39 package java.text;
40
41 import java.io.IOException;
42 import java.io.ObjectInputStream;
43 import java.io.Serializable;
44 import java.text.spi.DecimalFormatSymbolsProvider;
45 import java.util.Currency;
46 import java.util.Locale;
47 import java.util.ResourceBundle;
48 import java.util.concurrent.ConcurrentHashMap;
49
50 import sun.util.LocaleServiceProviderPool;
51 import sun.util.resources.LocaleData;
52
53 /**
54 * This class represents the set of symbols (such as the decimal separator,
55 * the grouping separator, and so on) needed by <code>DecimalFormat</code>
56 * to format numbers. <code>DecimalFormat</code> creates for itself an instance of
57 * <code>DecimalFormatSymbols</code> from its locale data. If you need to change any
58 * of these symbols, you can get the <code>DecimalFormatSymbols</code> object from
59 * your <code>DecimalFormat</code> and modify it.
60 *
61 * @see java.util.Locale
62 * @see DecimalFormat
63 * @author Mark Davis
64 * @author Alan Liu
65 */
66
67 public class DecimalFormatSymbols implements Cloneable, Serializable {
68
69 /**
70 * Create a DecimalFormatSymbols object for the default locale.
71 * This constructor can only construct instances for the locales
72 * supported by the Java runtime environment, not for those
73 * supported by installed
74 * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider}
75 * implementations. For full locale coverage, use the
76 * {@link #getInstance(Locale) getInstance} method.
77 */
78 public DecimalFormatSymbols() {
79 initialize( Locale.getDefault(Locale.Category.FORMAT) );
80 }
81
82 /**
83 * Create a DecimalFormatSymbols object for the given locale.
84 * This constructor can only construct instances for the locales
85 * supported by the Java runtime environment, not for those
86 * supported by installed
87 * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider}
88 * implementations. For full locale coverage, use the
89 * {@link #getInstance(Locale) getInstance} method.
90 *
91 * @exception NullPointerException if <code>locale</code> is null
92 */
93 public DecimalFormatSymbols( Locale locale ) {
94 initialize( locale );
95 }
96
97 /**
98 * Returns an array of all locales for which the
99 * <code>getInstance</code> methods of this class can return
100 * localized instances.
101 * The returned array represents the union of locales supported by the Java
102 * runtime and by installed
103 * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider}
104 * implementations. It must contain at least a <code>Locale</code>
105 * instance equal to {@link java.util.Locale#US Locale.US}.
106 *
107 * @return An array of locales for which localized
108 * <code>DecimalFormatSymbols</code> instances are available.
109 * @since 1.6
110 */
111 public static Locale[] getAvailableLocales() {
112 LocaleServiceProviderPool pool =
113 LocaleServiceProviderPool.getPool(DecimalFormatSymbolsProvider.class);
114 return pool.getAvailableLocales();
115 }
116
117 /**
118 * Gets the <code>DecimalFormatSymbols</code> instance for the default
119 * locale. This method provides access to <code>DecimalFormatSymbols</code>
120 * instances for locales supported by the Java runtime itself as well
121 * as for those supported by installed
122 * {@link java.text.spi.DecimalFormatSymbolsProvider
123 * DecimalFormatSymbolsProvider} implementations.
124 * @return a <code>DecimalFormatSymbols</code> instance.
125 * @since 1.6
126 */
127 public static final DecimalFormatSymbols getInstance() {
128 return getInstance(Locale.getDefault(Locale.Category.FORMAT));
129 }
130
131 /**
132 * Gets the <code>DecimalFormatSymbols</code> instance for the specified
133 * locale. This method provides access to <code>DecimalFormatSymbols</code>
134 * instances for locales supported by the Java runtime itself as well
135 * as for those supported by installed
136 * {@link java.text.spi.DecimalFormatSymbolsProvider
137 * DecimalFormatSymbolsProvider} implementations.
138 * @param locale the desired locale.
139 * @return a <code>DecimalFormatSymbols</code> instance.
140 * @exception NullPointerException if <code>locale</code> is null
141 * @since 1.6
142 */
143 public static final DecimalFormatSymbols getInstance(Locale locale) {
144
145 // Check whether a provider can provide an implementation that's closer
146 // to the requested locale than what the Java runtime itself can provide.
147 LocaleServiceProviderPool pool =
148 LocaleServiceProviderPool.getPool(DecimalFormatSymbolsProvider.class);
149 if (pool.hasProviders()) {
150 DecimalFormatSymbols providersInstance = pool.getLocalizedObject(
151 DecimalFormatSymbolsGetter.INSTANCE, locale);
152 if (providersInstance != null) {
153 return providersInstance;
154 }
155 }
156
157 return new DecimalFormatSymbols(locale);
158 }
159
160 /**
161 * Gets the character used for zero. Different for Arabic, etc.
162 */
163 public char getZeroDigit() {
164 return zeroDigit;
165 }
166
167 /**
168 * Sets the character used for zero. Different for Arabic, etc.
169 */
170 public void setZeroDigit(char zeroDigit) {
171 this.zeroDigit = zeroDigit;
172 }
173
174 /**
175 * Gets the character used for thousands separator. Different for French, etc.
176 */
177 public char getGroupingSeparator() {
178 return groupingSeparator;
179 }
180
181 /**
182 * Sets the character used for thousands separator. Different for French, etc.
183 */
184 public void setGroupingSeparator(char groupingSeparator) {
185 this.groupingSeparator = groupingSeparator;
186 }
187
188 /**
189 * Gets the character used for decimal sign. Different for French, etc.
190 */
191 public char getDecimalSeparator() {
192 return decimalSeparator;
193 }
194
195 /**
196 * Sets the character used for decimal sign. Different for French, etc.
197 */
198 public void setDecimalSeparator(char decimalSeparator) {
199 this.decimalSeparator = decimalSeparator;
200 }
201
202 /**
203 * Gets the character used for per mille sign. Different for Arabic, etc.
204 */
205 public char getPerMill() {
206 return perMill;
207 }
208
209 /**
210 * Sets the character used for per mille sign. Different for Arabic, etc.
211 */
212 public void setPerMill(char perMill) {
213 this.perMill = perMill;
214 }
215
216 /**
217 * Gets the character used for percent sign. Different for Arabic, etc.
218 */
219 public char getPercent() {
220 return percent;
221 }
222
223 /**
224 * Sets the character used for percent sign. Different for Arabic, etc.
225 */
226 public void setPercent(char percent) {
227 this.percent = percent;
228 }
229
230 /**
231 * Gets the character used for a digit in a pattern.
232 */
233 public char getDigit() {
234 return digit;
235 }
236
237 /**
238 * Sets the character used for a digit in a pattern.
239 */
240 public void setDigit(char digit) {
241 this.digit = digit;
242 }
243
244 /**
245 * Gets the character used to separate positive and negative subpatterns
246 * in a pattern.
247 */
248 public char getPatternSeparator() {
249 return patternSeparator;
250 }
251
252 /**
253 * Sets the character used to separate positive and negative subpatterns
254 * in a pattern.
255 */
256 public void setPatternSeparator(char patternSeparator) {
257 this.patternSeparator = patternSeparator;
258 }
259
260 /**
261 * Gets the string used to represent infinity. Almost always left
262 * unchanged.
263 */
264 public String getInfinity() {
265 return infinity;
266 }
267
268 /**
269 * Sets the string used to represent infinity. Almost always left
270 * unchanged.
271 */
272 public void setInfinity(String infinity) {
273 this.infinity = infinity;
274 }
275
276 /**
277 * Gets the string used to represent "not a number". Almost always left
278 * unchanged.
279 */
280 public String getNaN() {
281 return NaN;
282 }
283
284 /**
285 * Sets the string used to represent "not a number". Almost always left
286 * unchanged.
287 */
288 public void setNaN(String NaN) {
289 this.NaN = NaN;
290 }
291
292 /**
293 * Gets the character used to represent minus sign. If no explicit
294 * negative format is specified, one is formed by prefixing
295 * minusSign to the positive format.
296 */
297 public char getMinusSign() {
298 return minusSign;
299 }
300
301 /**
302 * Sets the character used to represent minus sign. If no explicit
303 * negative format is specified, one is formed by prefixing
304 * minusSign to the positive format.
305 */
306 public void setMinusSign(char minusSign) {
307 this.minusSign = minusSign;
308 }
309
310 /**
311 * Returns the currency symbol for the currency of these
312 * DecimalFormatSymbols in their locale.
313 * @since 1.2
314 */
315 public String getCurrencySymbol()
316 {
317 return currencySymbol;
318 }
319
320 /**
321 * Sets the currency symbol for the currency of these
322 * DecimalFormatSymbols in their locale.
323 * @since 1.2
324 */
325 public void setCurrencySymbol(String currency)
326 {
327 currencySymbol = currency;
328 }
329
330 /**
331 * Returns the ISO 4217 currency code of the currency of these
332 * DecimalFormatSymbols.
333 * @since 1.2
334 */
335 public String getInternationalCurrencySymbol()
336 {
337 return intlCurrencySymbol;
338 }
339
340 /**
341 * Sets the ISO 4217 currency code of the currency of these
342 * DecimalFormatSymbols.
343 * If the currency code is valid (as defined by
344 * {@link java.util.Currency#getInstance(java.lang.String) Currency.getInstance}),
345 * this also sets the currency attribute to the corresponding Currency
346 * instance and the currency symbol attribute to the currency's symbol
347 * in the DecimalFormatSymbols' locale. If the currency code is not valid,
348 * then the currency attribute is set to null and the currency symbol
349 * attribute is not modified.
350 *
351 * @see #setCurrency
352 * @see #setCurrencySymbol
353 * @since 1.2
354 */
355 public void setInternationalCurrencySymbol(String currencyCode)
356 {
357 intlCurrencySymbol = currencyCode;
358 currency = null;
359 if (currencyCode != null) {
360 try {
361 currency = Currency.getInstance(currencyCode);
362 currencySymbol = currency.getSymbol();
363 } catch (IllegalArgumentException e) {
364 }
365 }
366 }
367
368 /**
369 * Gets the currency of these DecimalFormatSymbols. May be null if the
370 * currency symbol attribute was previously set to a value that's not
371 * a valid ISO 4217 currency code.
372 *
373 * @return the currency used, or null
374 * @since 1.4
375 */
376 public Currency getCurrency() {
377 return currency;
378 }
379
380 /**
381 * Sets the currency of these DecimalFormatSymbols.
382 * This also sets the currency symbol attribute to the currency's symbol
383 * in the DecimalFormatSymbols' locale, and the international currency
384 * symbol attribute to the currency's ISO 4217 currency code.
385 *
386 * @param currency the new currency to be used
387 * @exception NullPointerException if <code>currency</code> is null
388 * @since 1.4
389 * @see #setCurrencySymbol
390 * @see #setInternationalCurrencySymbol
391 */
392 public void setCurrency(Currency currency) {
393 if (currency == null) {
394 throw new NullPointerException();
395 }
396 this.currency = currency;
397 intlCurrencySymbol = currency.getCurrencyCode();
398 currencySymbol = currency.getSymbol(locale);
399 }
400
401
402 /**
403 * Returns the monetary decimal separator.
404 * @since 1.2
405 */
406 public char getMonetaryDecimalSeparator()
407 {
408 return monetarySeparator;
409 }
410
411 /**
412 * Sets the monetary decimal separator.
413 * @since 1.2
414 */
415 public void setMonetaryDecimalSeparator(char sep)
416 {
417 monetarySeparator = sep;
418 }
419
420 //------------------------------------------------------------
421 // BEGIN Package Private methods ... to be made public later
422 //------------------------------------------------------------
423
424 /**
425 * Returns the character used to separate the mantissa from the exponent.
426 */
427 char getExponentialSymbol()
428 {
429 return exponential;
430 }
431 /**
432 * Returns the string used to separate the mantissa from the exponent.
433 * Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.
434 *
435 * @return the exponent separator string
436 * @see #setExponentSeparator(java.lang.String)
437 * @since 1.6
438 */
439 public String getExponentSeparator()
440 {
441 return exponentialSeparator;
442 }
443
444 /**
445 * Sets the character used to separate the mantissa from the exponent.
446 */
447 void setExponentialSymbol(char exp)
448 {
449 exponential = exp;
450 }
451
452 /**
453 * Sets the string used to separate the mantissa from the exponent.
454 * Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.
455 *
456 * @param exp the exponent separator string
457 * @exception NullPointerException if <code>exp</code> is null
458 * @see #getExponentSeparator()
459 * @since 1.6
460 */
461 public void setExponentSeparator(String exp)
462 {
463 if (exp == null) {
464 throw new NullPointerException();
465 }
466 exponentialSeparator = exp;
467 }
468
469
470 //------------------------------------------------------------
471 // END Package Private methods ... to be made public later
472 //------------------------------------------------------------
473
474 /**
475 * Standard override.
476 */
477 public Object clone() {
478 try {
479 return (DecimalFormatSymbols)super.clone();
480 // other fields are bit-copied
481 } catch (CloneNotSupportedException e) {
482 throw new InternalError(e);
483 }
484 }
485
486 /**
487 * Override equals.
488 */
489 public boolean equals(Object obj) {
490 if (obj == null) return false;
491 if (this == obj) return true;
492 if (getClass() != obj.getClass()) return false;
493 DecimalFormatSymbols other = (DecimalFormatSymbols) obj;
494 return (zeroDigit == other.zeroDigit &&
495 groupingSeparator == other.groupingSeparator &&
496 decimalSeparator == other.decimalSeparator &&
497 percent == other.percent &&
498 perMill == other.perMill &&
499 digit == other.digit &&
500 minusSign == other.minusSign &&
501 patternSeparator == other.patternSeparator &&
502 infinity.equals(other.infinity) &&
503 NaN.equals(other.NaN) &&
504 currencySymbol.equals(other.currencySymbol) &&
505 intlCurrencySymbol.equals(other.intlCurrencySymbol) &&
506 currency == other.currency &&
507 monetarySeparator == other.monetarySeparator &&
508 exponentialSeparator.equals(other.exponentialSeparator) &&
509 locale.equals(other.locale));
510 }
511
512 /**
513 * Override hashCode.
514 */
515 public int hashCode() {
516 int result = zeroDigit;
517 result = result * 37 + groupingSeparator;
518 result = result * 37 + decimalSeparator;
519 return result;
520 }
521
522 /**
523 * Initializes the symbols from the FormatData resource bundle.
524 */
525 private void initialize( Locale locale ) {
526 this.locale = locale;
527
528 // get resource bundle data - try the cache first
529 boolean needCacheUpdate = false;
530 Object[] data = cachedLocaleData.get(locale);
531 if (data == null) { /* cache miss */
532 // When numbering system is thai (Locale's extension contains u-nu-thai),
533 // we read the data from th_TH_TH.
534 Locale lookupLocale = locale;
535 String numberType = locale.getUnicodeLocaleType("nu");
536 if (numberType != null && numberType.equals("thai")) {
537 lookupLocale = new Locale("th", "TH", "TH");
538 }
539 data = new Object[3];
540 ResourceBundle rb = LocaleData.getNumberFormatData(lookupLocale);
541 data[0] = rb.getStringArray("NumberElements");
542 needCacheUpdate = true;
543 }
544
545 String[] numberElements = (String[]) data[0];
546
547 decimalSeparator = numberElements[0].charAt(0);
548 groupingSeparator = numberElements[1].charAt(0);
549 patternSeparator = numberElements[2].charAt(0);
550 percent = numberElements[3].charAt(0);
551 zeroDigit = numberElements[4].charAt(0); //different for Arabic,etc.
552 digit = numberElements[5].charAt(0);
553 minusSign = numberElements[6].charAt(0);
554 exponential = numberElements[7].charAt(0);
555 exponentialSeparator = numberElements[7]; //string representation new since 1.6
556 perMill = numberElements[8].charAt(0);
557 infinity = numberElements[9];
558 NaN = numberElements[10];
559
560 // Try to obtain the currency used in the locale's country.
561 // Check for empty country string separately because it's a valid
562 // country ID for Locale (and used for the C locale), but not a valid
563 // ISO 3166 country code, and exceptions are expensive.
564 if (!"".equals(locale.getCountry())) {
565 try {
566 currency = Currency.getInstance(locale);
567 } catch (IllegalArgumentException e) {
568 // use default values below for compatibility
569 }
570 }
571 if (currency != null) {
572 intlCurrencySymbol = currency.getCurrencyCode();
573 if (data[1] != null && data[1] == intlCurrencySymbol) {
574 currencySymbol = (String) data[2];
575 } else {
576 currencySymbol = currency.getSymbol(locale);
577 data[1] = intlCurrencySymbol;
578 data[2] = currencySymbol;
579 needCacheUpdate = true;
580 }
581 } else {
582 // default values
583 intlCurrencySymbol = "XXX";
584 try {
585 currency = Currency.getInstance(intlCurrencySymbol);
586 } catch (IllegalArgumentException e) {
587 }
588 currencySymbol = "\u00A4";
589 }
590 // Currently the monetary decimal separator is the same as the
591 // standard decimal separator for all locales that we support.
592 // If that changes, add a new entry to NumberElements.
593 monetarySeparator = decimalSeparator;
594
595 if (needCacheUpdate) {
596 cachedLocaleData.putIfAbsent(locale, data);
597 }
598 }
599
600 /**
601 * Reads the default serializable fields, provides default values for objects
602 * in older serial versions, and initializes non-serializable fields.
603 * If <code>serialVersionOnStream</code>
604 * is less than 1, initializes <code>monetarySeparator</code> to be
605 * the same as <code>decimalSeparator</code> and <code>exponential</code>
606 * to be 'E'.
607 * If <code>serialVersionOnStream</code> is less than 2,
608 * initializes <code>locale</code>to the root locale, and initializes
609 * If <code>serialVersionOnStream</code> is less than 3, it initializes
610 * <code>exponentialSeparator</code> using <code>exponential</code>.
611 * Sets <code>serialVersionOnStream</code> back to the maximum allowed value so that
612 * default serialization will work properly if this object is streamed out again.
613 * Initializes the currency from the intlCurrencySymbol field.
614 *
615 * @since JDK 1.1.6
616 */
617 private void readObject(ObjectInputStream stream)
618 throws IOException, ClassNotFoundException {
619 stream.defaultReadObject();
620 if (serialVersionOnStream < 1) {
621 // Didn't have monetarySeparator or exponential field;
622 // use defaults.
623 monetarySeparator = decimalSeparator;
624 exponential = 'E';
625 }
626 if (serialVersionOnStream < 2) {
627 // didn't have locale; use root locale
628 locale = Locale.ROOT;
629 }
630 if (serialVersionOnStream < 3) {
631 // didn't have exponentialSeparator. Create one using exponential
632 exponentialSeparator = Character.toString(exponential);
633 }
634 serialVersionOnStream = currentSerialVersion;
635
636 if (intlCurrencySymbol != null) {
637 try {
638 currency = Currency.getInstance(intlCurrencySymbol);
639 } catch (IllegalArgumentException e) {
640 }
641 }
642 }
643
644 /**
645 * Character used for zero.
646 *
647 * @serial
648 * @see #getZeroDigit
649 */
650 private char zeroDigit;
651
652 /**
653 * Character used for thousands separator.
654 *
655 * @serial
656 * @see #getGroupingSeparator
657 */
658 private char groupingSeparator;
659
660 /**
661 * Character used for decimal sign.
662 *
663 * @serial
664 * @see #getDecimalSeparator
665 */
666 private char decimalSeparator;
667
668 /**
669 * Character used for per mille sign.
670 *
671 * @serial
672 * @see #getPerMill
673 */
674 private char perMill;
675
676 /**
677 * Character used for percent sign.
678 * @serial
679 * @see #getPercent
680 */
681 private char percent;
682
683 /**
684 * Character used for a digit in a pattern.
685 *
686 * @serial
687 * @see #getDigit
688 */
689 private char digit;
690
691 /**
692 * Character used to separate positive and negative subpatterns
693 * in a pattern.
694 *
695 * @serial
696 * @see #getPatternSeparator
697 */
698 private char patternSeparator;
699
700 /**
701 * String used to represent infinity.
702 * @serial
703 * @see #getInfinity
704 */
705 private String infinity;
706
707 /**
708 * String used to represent "not a number".
709 * @serial
710 * @see #getNaN
711 */
712 private String NaN;
713
714 /**
715 * Character used to represent minus sign.
716 * @serial
717 * @see #getMinusSign
718 */
719 private char minusSign;
720
721 /**
722 * String denoting the local currency, e.g. "$".
723 * @serial
724 * @see #getCurrencySymbol
725 */
726 private String currencySymbol;
727
728 /**
729 * ISO 4217 currency code denoting the local currency, e.g. "USD".
730 * @serial
731 * @see #getInternationalCurrencySymbol
732 */
733 private String intlCurrencySymbol;
734
735 /**
736 * The decimal separator used when formatting currency values.
737 * @serial
738 * @since JDK 1.1.6
739 * @see #getMonetaryDecimalSeparator
740 */
741 private char monetarySeparator; // Field new in JDK 1.1.6
742
743 /**
744 * The character used to distinguish the exponent in a number formatted
745 * in exponential notation, e.g. 'E' for a number such as "1.23E45".
746 * <p>
747 * Note that the public API provides no way to set this field,
748 * even though it is supported by the implementation and the stream format.
749 * The intent is that this will be added to the API in the future.
750 *
751 * @serial
752 * @since JDK 1.1.6
753 */
754 private char exponential; // Field new in JDK 1.1.6
755
756 /**
757 * The string used to separate the mantissa from the exponent.
758 * Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.
759 * <p>
760 * If both <code>exponential</code> and <code>exponentialSeparator</code>
761 * exist, this <code>exponentialSeparator</code> has the precedence.
762 *
763 * @serial
764 * @since 1.6
765 */
766 private String exponentialSeparator; // Field new in JDK 1.6
767
768 /**
769 * The locale of these currency format symbols.
770 *
771 * @serial
772 * @since 1.4
773 */
774 private Locale locale;
775
776 // currency; only the ISO code is serialized.
777 private transient Currency currency;
778
779 // Proclaim JDK 1.1 FCS compatibility
780 static final long serialVersionUID = 5772796243397350300L;
781
782 // The internal serial version which says which version was written
783 // - 0 (default) for version up to JDK 1.1.5
784 // - 1 for version from JDK 1.1.6, which includes two new fields:
785 // monetarySeparator and exponential.
786 // - 2 for version from J2SE 1.4, which includes locale field.
787 // - 3 for version from J2SE 1.6, which includes exponentialSeparator field.
788 private static final int currentSerialVersion = 3;
789
790 /**
791 * Describes the version of <code>DecimalFormatSymbols</code> present on the stream.
792 * Possible values are:
793 * <ul>
794 * <li><b>0</b> (or uninitialized): versions prior to JDK 1.1.6.
795 *
796 * <li><b>1</b>: Versions written by JDK 1.1.6 or later, which include
797 * two new fields: <code>monetarySeparator</code> and <code>exponential</code>.
798 * <li><b>2</b>: Versions written by J2SE 1.4 or later, which include a
799 * new <code>locale</code> field.
800 * <li><b>3</b>: Versions written by J2SE 1.6 or later, which include a
801 * new <code>exponentialSeparator</code> field.
802 * </ul>
803 * When streaming out a <code>DecimalFormatSymbols</code>, the most recent format
804 * (corresponding to the highest allowable <code>serialVersionOnStream</code>)
805 * is always written.
806 *
807 * @serial
808 * @since JDK 1.1.6
809 */
810 private int serialVersionOnStream = currentSerialVersion;
811
812 /**
813 * cache to hold the NumberElements and the Currency
814 * of a Locale.
815 */
816 private static final ConcurrentHashMap<Locale, Object[]> cachedLocaleData = new ConcurrentHashMap<Locale, Object[]>(3);
817
818 /**
819 * Obtains a DecimalFormatSymbols instance from a DecimalFormatSymbolsProvider
820 * implementation.
821 */
822 private static class DecimalFormatSymbolsGetter
823 implements LocaleServiceProviderPool.LocalizedObjectGetter<DecimalFormatSymbolsProvider,
824 DecimalFormatSymbols> {
825 private static final DecimalFormatSymbolsGetter INSTANCE =
826 new DecimalFormatSymbolsGetter();
827
828 public DecimalFormatSymbols getObject(
829 DecimalFormatSymbolsProvider decimalFormatSymbolsProvider,
830 Locale locale,
831 String key,
832 Object... params) {
833 assert params.length == 0;
834 return decimalFormatSymbolsProvider.getInstance(locale);
835 }
836 }
837 }