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