Showing the changes to java/pkg/java/text/spi (14 of 18352 files). Show all
Unified · Split
Binary file not shown.
| @@ -0,0 +1,107 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.BreakIterator; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide concrete implementations of the | |
| 35 | + * {@link java.text.BreakIterator BreakIterator} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class BreakIteratorProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected BreakIteratorProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>BreakIterator</code> instance | |
| 50 | + * for <a href="../BreakIterator.html#word">word breaks</a> | |
| 51 | + * for the given locale. | |
| 52 | + * @param locale the desired locale | |
| 53 | + * @return A break iterator for word breaks | |
| 54 | + * @exception NullPointerException if <code>locale</code> is null | |
| 55 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 56 | + * one of the locales returned from | |
| 57 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 58 | + * getAvailableLocales()}. | |
| 59 | + * @see java.text.BreakIterator#getWordInstance(java.util.Locale) | |
| 60 | + */ | |
| 61 | + public abstract BreakIterator getWordInstance(Locale locale); | |
| 62 | + | |
| 63 | + /** | |
| 64 | + * Returns a new <code>BreakIterator</code> instance | |
| 65 | + * for <a href="../BreakIterator.html#line">line breaks</a> | |
| 66 | + * for the given locale. | |
| 67 | + * @param locale the desired locale | |
| 68 | + * @return A break iterator for line breaks | |
| 69 | + * @exception NullPointerException if <code>locale</code> is null | |
| 70 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 71 | + * one of the locales returned from | |
| 72 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 73 | + * getAvailableLocales()}. | |
| 74 | + * @see java.text.BreakIterator#getLineInstance(java.util.Locale) | |
| 75 | + */ | |
| 76 | + public abstract BreakIterator getLineInstance(Locale locale); | |
| 77 | + | |
| 78 | + /** | |
| 79 | + * Returns a new <code>BreakIterator</code> instance | |
| 80 | + * for <a href="../BreakIterator.html#character">character breaks</a> | |
| 81 | + * for the given locale. | |
| 82 | + * @param locale the desired locale | |
| 83 | + * @return A break iterator for character breaks | |
| 84 | + * @exception NullPointerException if <code>locale</code> is null | |
| 85 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 86 | + * one of the locales returned from | |
| 87 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 88 | + * getAvailableLocales()}. | |
| 89 | + * @see java.text.BreakIterator#getCharacterInstance(java.util.Locale) | |
| 90 | + */ | |
| 91 | + public abstract BreakIterator getCharacterInstance(Locale locale); | |
| 92 | + | |
| 93 | + /** | |
| 94 | + * Returns a new <code>BreakIterator</code> instance | |
| 95 | + * for <a href="../BreakIterator.html#sentence">sentence breaks</a> | |
| 96 | + * for the given locale. | |
| 97 | + * @param locale the desired locale | |
| 98 | + * @return A break iterator for sentence breaks | |
| 99 | + * @exception NullPointerException if <code>locale</code> is null | |
| 100 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 101 | + * one of the locales returned from | |
| 102 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 103 | + * getAvailableLocales()}. | |
| 104 | + * @see java.text.BreakIterator#getSentenceInstance(java.util.Locale) | |
| 105 | + */ | |
| 106 | + public abstract BreakIterator getSentenceInstance(Locale locale); | |
| 107 | +} | |
Binary file not shown.
| @@ -0,0 +1,61 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.Collator; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide concrete implementations of the | |
| 35 | + * {@link java.text.Collator Collator} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class CollatorProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected CollatorProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>Collator</code> instance for the specified locale. | |
| 50 | + * @param locale the desired locale. | |
| 51 | + * @return the <code>Collator</code> for the desired locale. | |
| 52 | + * @exception NullPointerException if | |
| 53 | + * <code>locale</code> is null | |
| 54 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 55 | + * one of the locales returned from | |
| 56 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 57 | + * getAvailableLocales()}. | |
| 58 | + * @see java.text.Collator#getInstance(java.util.Locale) | |
| 59 | + */ | |
| 60 | + public abstract Collator getInstance(Locale locale); | |
| 61 | +} | |
Binary file not shown.
| @@ -0,0 +1,114 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.DateFormat; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide concrete implementations of the | |
| 35 | + * {@link java.text.DateFormat DateFormat} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class DateFormatProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected DateFormatProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>DateFormat</code> instance which formats time | |
| 50 | + * with the given formatting style for the specified locale. | |
| 51 | + * @param style the given formatting style. Either one of | |
| 52 | + * {@link java.text.DateFormat#SHORT DateFormat.SHORT}, | |
| 53 | + * {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM}, | |
| 54 | + * {@link java.text.DateFormat#LONG DateFormat.LONG}, or | |
| 55 | + * {@link java.text.DateFormat#FULL DateFormat.FULL}. | |
| 56 | + * @param locale the desired locale. | |
| 57 | + * @exception IllegalArgumentException if <code>style</code> is invalid, | |
| 58 | + * or if <code>locale</code> isn't | |
| 59 | + * one of the locales returned from | |
| 60 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 61 | + * getAvailableLocales()}. | |
| 62 | + * @exception NullPointerException if <code>locale</code> is null | |
| 63 | + * @return a time formatter. | |
| 64 | + * @see java.text.DateFormat#getTimeInstance(int, java.util.Locale) | |
| 65 | + */ | |
| 66 | + public abstract DateFormat getTimeInstance(int style, Locale locale); | |
| 67 | + | |
| 68 | + /** | |
| 69 | + * Returns a new <code>DateFormat</code> instance which formats date | |
| 70 | + * with the given formatting style for the specified locale. | |
| 71 | + * @param style the given formatting style. Either one of | |
| 72 | + * {@link java.text.DateFormat#SHORT DateFormat.SHORT}, | |
| 73 | + * {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM}, | |
| 74 | + * {@link java.text.DateFormat#LONG DateFormat.LONG}, or | |
| 75 | + * {@link java.text.DateFormat#FULL DateFormat.FULL}. | |
| 76 | + * @param locale the desired locale. | |
| 77 | + * @exception IllegalArgumentException if <code>style</code> is invalid, | |
| 78 | + * or if <code>locale</code> isn't | |
| 79 | + * one of the locales returned from | |
| 80 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 81 | + * getAvailableLocales()}. | |
| 82 | + * @exception NullPointerException if <code>locale</code> is null | |
| 83 | + * @return a date formatter. | |
| 84 | + * @see java.text.DateFormat#getDateInstance(int, java.util.Locale) | |
| 85 | + */ | |
| 86 | + public abstract DateFormat getDateInstance(int style, Locale locale); | |
| 87 | + | |
| 88 | + /** | |
| 89 | + * Returns a new <code>DateFormat</code> instance which formats date and time | |
| 90 | + * with the given formatting style for the specified locale. | |
| 91 | + * @param dateStyle the given date formatting style. Either one of | |
| 92 | + * {@link java.text.DateFormat#SHORT DateFormat.SHORT}, | |
| 93 | + * {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM}, | |
| 94 | + * {@link java.text.DateFormat#LONG DateFormat.LONG}, or | |
| 95 | + * {@link java.text.DateFormat#FULL DateFormat.FULL}. | |
| 96 | + * @param timeStyle the given time formatting style. Either one of | |
| 97 | + * {@link java.text.DateFormat#SHORT DateFormat.SHORT}, | |
| 98 | + * {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM}, | |
| 99 | + * {@link java.text.DateFormat#LONG DateFormat.LONG}, or | |
| 100 | + * {@link java.text.DateFormat#FULL DateFormat.FULL}. | |
| 101 | + * @param locale the desired locale. | |
| 102 | + * @exception IllegalArgumentException if <code>dateStyle</code> or | |
| 103 | + * <code>timeStyle</code> is invalid, | |
| 104 | + * or if <code>locale</code> isn't | |
| 105 | + * one of the locales returned from | |
| 106 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 107 | + * getAvailableLocales()}. | |
| 108 | + * @exception NullPointerException if <code>locale</code> is null | |
| 109 | + * @return a date/time formatter. | |
| 110 | + * @see java.text.DateFormat#getDateTimeInstance(int, int, java.util.Locale) | |
| 111 | + */ | |
| 112 | + public abstract DateFormat | |
| 113 | + getDateTimeInstance(int dateStyle, int timeStyle, Locale locale); | |
| 114 | +} | |
Binary file not shown.
| @@ -0,0 +1,62 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.DateFormatSymbols; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide instances of the | |
| 35 | + * {@link java.text.DateFormatSymbols DateFormatSymbols} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class DateFormatSymbolsProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected DateFormatSymbolsProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>DateFormatSymbols</code> instance for the | |
| 50 | + * specified locale. | |
| 51 | + * | |
| 52 | + * @param locale the desired locale | |
| 53 | + * @exception NullPointerException if <code>locale</code> is null | |
| 54 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 55 | + * one of the locales returned from | |
| 56 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 57 | + * getAvailableLocales()}. | |
| 58 | + * @return a <code>DateFormatSymbols</code> instance. | |
| 59 | + * @see java.text.DateFormatSymbols#getInstance(java.util.Locale) | |
| 60 | + */ | |
| 61 | + public abstract DateFormatSymbols getInstance(Locale locale); | |
| 62 | +} | |
Binary file not shown.
| @@ -0,0 +1,62 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.DecimalFormatSymbols; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide instances of the | |
| 35 | + * {@link java.text.DecimalFormatSymbols DecimalFormatSymbols} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class DecimalFormatSymbolsProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected DecimalFormatSymbolsProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>DecimalFormatSymbols</code> instance for the | |
| 50 | + * specified locale. | |
| 51 | + * | |
| 52 | + * @param locale the desired locale | |
| 53 | + * @exception NullPointerException if <code>locale</code> is null | |
| 54 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 55 | + * one of the locales returned from | |
| 56 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 57 | + * getAvailableLocales()}. | |
| 58 | + * @return a <code>DecimalFormatSymbols</code> instance. | |
| 59 | + * @see java.text.DecimalFormatSymbols#getInstance(java.util.Locale) | |
| 60 | + */ | |
| 61 | + public abstract DecimalFormatSymbols getInstance(Locale locale); | |
| 62 | +} | |
Binary file not shown.
| @@ -0,0 +1,113 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 2005, 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 | +package java.text.spi; | |
| 27 | + | |
| 28 | +import java.text.NumberFormat; | |
| 29 | +import java.util.Locale; | |
| 30 | +import java.util.spi.LocaleServiceProvider; | |
| 31 | + | |
| 32 | +/** | |
| 33 | + * An abstract class for service providers that | |
| 34 | + * provide concrete implementations of the | |
| 35 | + * {@link java.text.NumberFormat NumberFormat} class. | |
| 36 | + * | |
| 37 | + * @since 1.6 | |
| 38 | + */ | |
| 39 | +public abstract class NumberFormatProvider extends LocaleServiceProvider { | |
| 40 | + | |
| 41 | + /** | |
| 42 | + * Sole constructor. (For invocation by subclass constructors, typically | |
| 43 | + * implicit.) | |
| 44 | + */ | |
| 45 | + protected NumberFormatProvider() { | |
| 46 | + } | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Returns a new <code>NumberFormat</code> instance which formats | |
| 50 | + * monetary values for the specified locale. | |
| 51 | + * | |
| 52 | + * @param locale the desired locale. | |
| 53 | + * @exception NullPointerException if <code>locale</code> is null | |
| 54 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 55 | + * one of the locales returned from | |
| 56 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 57 | + * getAvailableLocales()}. | |
| 58 | + * @return a currency formatter | |
| 59 | + * @see java.text.NumberFormat#getCurrencyInstance(java.util.Locale) | |
| 60 | + */ | |
| 61 | + public abstract NumberFormat getCurrencyInstance(Locale locale); | |
| 62 | + | |
| 63 | + /** | |
| 64 | + * Returns a new <code>NumberFormat</code> instance which formats | |
| 65 | + * integer values for the specified locale. | |
| 66 | + * The returned number format is configured to | |
| 67 | + * round floating point numbers to the nearest integer using | |
| 68 | + * half-even rounding (see {@link java.math.RoundingMode#HALF_EVEN HALF_EVEN}) | |
| 69 | + * for formatting, and to parse only the integer part of | |
| 70 | + * an input string (see {@link | |
| 71 | + * java.text.NumberFormat#isParseIntegerOnly isParseIntegerOnly}). | |
| 72 | + * | |
| 73 | + * @param locale the desired locale | |
| 74 | + * @exception NullPointerException if <code>locale</code> is null | |
| 75 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 76 | + * one of the locales returned from | |
| 77 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 78 | + * getAvailableLocales()}. | |
| 79 | + * @return a number format for integer values | |
| 80 | + * @see java.text.NumberFormat#getIntegerInstance(java.util.Locale) | |
| 81 | + */ | |
| 82 | + public abstract NumberFormat getIntegerInstance(Locale locale); | |
| 83 | + | |
| 84 | + /** | |
| 85 | + * Returns a new general-purpose <code>NumberFormat</code> instance for | |
| 86 | + * the specified locale. | |
| 87 | + * | |
| 88 | + * @param locale the desired locale | |
| 89 | + * @exception NullPointerException if <code>locale</code> is null | |
| 90 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 91 | + * one of the locales returned from | |
| 92 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 93 | + * getAvailableLocales()}. | |
| 94 | + * @return a general-purpose number formatter | |
| 95 | + * @see java.text.NumberFormat#getNumberInstance(java.util.Locale) | |
| 96 | + */ | |
| 97 | + public abstract NumberFormat getNumberInstance(Locale locale); | |
| 98 | + | |
| 99 | + /** | |
| 100 | + * Returns a new <code>NumberFormat</code> instance which formats | |
| 101 | + * percentage values for the specified locale. | |
| 102 | + * | |
| 103 | + * @param locale the desired locale | |
| 104 | + * @exception NullPointerException if <code>locale</code> is null | |
| 105 | + * @exception IllegalArgumentException if <code>locale</code> isn't | |
| 106 | + * one of the locales returned from | |
| 107 | + * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales() | |
| 108 | + * getAvailableLocales()}. | |
| 109 | + * @return a percent formatter | |
| 110 | + * @see java.text.NumberFormat#getPercentInstance(java.util.Locale) | |
| 111 | + */ | |
| 112 | + public abstract NumberFormat getPercentInstance(Locale locale); | |
| 113 | +} | |
| @@ -0,0 +1,13 @@ | ||
| 1 | +<../../../../../mkconfig | |
| 2 | + | |
| 3 | +TARG=\ | |
| 4 | + BreakIteratorProvider.dis\ | |
| 5 | + CollatorProvider.dis\ | |
| 6 | + DateFormatProvider.dis\ | |
| 7 | + DateFormatSymbolsProvider.dis\ | |
| 8 | + DecimalFormatSymbolsProvider.dis\ | |
| 9 | + NumberFormatProvider.dis\ | |
| 10 | + | |
| 11 | +DISBIN=$ROOT/java/dis/java/java/java/text/spi | |
| 12 | + | |
| 13 | +<$ROOT/mkfiles/mkjava | |
| @@ -0,0 +1,50 @@ | ||
| 1 | +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> | |
| 2 | +<html> | |
| 3 | +<head> | |
| 4 | +<!-- | |
| 5 | +Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. | |
| 6 | +DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| 7 | + | |
| 8 | +This code is free software; you can redistribute it and/or modify it | |
| 9 | +under the terms of the GNU General Public License version 2 only, as | |
| 10 | +published by the Free Software Foundation. Oracle designates this | |
| 11 | +particular file as subject to the "Classpath" exception as provided | |
| 12 | +by Oracle in the LICENSE file that accompanied this code. | |
| 13 | + | |
| 14 | +This code is distributed in the hope that it will be useful, but WITHOUT | |
| 15 | +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 16 | +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 17 | +version 2 for more details (a copy is included in the LICENSE file that | |
| 18 | +accompanied this code). | |
| 19 | + | |
| 20 | +You should have received a copy of the GNU General Public License version | |
| 21 | +2 along with this work; if not, write to the Free Software Foundation, | |
| 22 | +Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| 23 | + | |
| 24 | +Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| 25 | +or visit www.oracle.com if you need additional information or have any | |
| 26 | +questions. | |
| 27 | +--> | |
| 28 | + | |
| 29 | +</head> | |
| 30 | +<body bgcolor="white"> | |
| 31 | +Service provider classes for the classes in the java.text package. | |
| 32 | +<!-- | |
| 33 | +<h2>Package Specification</h2> | |
| 34 | + | |
| 35 | +##### FILL IN ANY SPECS NEEDED BY JAVA COMPATIBILITY KIT ##### | |
| 36 | +<ul> | |
| 37 | + <li><a href="">##### REFER TO ANY FRAMEMAKER SPECIFICATION HERE #####</a> | |
| 38 | +</ul> | |
| 39 | + | |
| 40 | +<h2>Related Documentation</h2> | |
| 41 | + | |
| 42 | +For overviews, tutorials, examples, guides, and tool documentation, please see: | |
| 43 | +<ul> | |
| 44 | + <li><a href="">##### REFER TO NON-SPEC DOCUMENTATION HERE #####</a> | |
| 45 | +</ul> | |
| 46 | +--> | |
| 47 | + | |
| 48 | +@since 1.6 | |
| 49 | +</body> | |
| 50 | +</html> | |