ICU-5362 fix internal APIs

X-SVN-Rev: 20227
This commit is contained in:
Ram Viswanadha 2006-09-01 19:47:16 +00:00
parent 5a3215ad04
commit d8dd554dd7
3 changed files with 86 additions and 87 deletions

View File

@ -1760,7 +1760,7 @@ public final class Normalizer implements Cloneable {
* @param c The code point whose closure set is to be retrieved * @param c The code point whose closure set is to be retrieved
* @param dest The char array to recive the closure set * @param dest The char array to recive the closure set
* @internal * @internal
* @stable ICU 2.4 * @deprecated This API is ICU internal only.
*/ */
public static int getFC_NFKC_Closure(int c,char[] dest) { public static int getFC_NFKC_Closure(int c,char[] dest) {
return NormalizerImpl.getFC_NFKC_Closure(c,dest); return NormalizerImpl.getFC_NFKC_Closure(c,dest);
@ -1770,7 +1770,7 @@ public final class Normalizer implements Cloneable {
* @param c The the code point whose closure set is to be retrieved * @param c The the code point whose closure set is to be retrieved
* @return String representation of the closure set * @return String representation of the closure set
* @internal * @internal
* @stable ICU 2.4 * @deprecated This API is ICU internal only.
*/ */
public static String getFC_NFKC_Closure(int c) { public static String getFC_NFKC_Closure(int c) {
char[] dest = new char[10]; char[] dest = new char[10];

View File

@ -86,14 +86,14 @@ import com.ibm.icu.text.SimpleDateFormat;
* locale that will ask the services to use the host platform's values).</li> * locale that will ask the services to use the host platform's values).</li>
* </ul> * </ul>
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public class GlobalizationPreferences implements Freezable { public class GlobalizationPreferences implements Freezable {
/** /**
* Number Format types * Number Format types
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public static final int public static final int
NF_NUMBER = 0, // NumberFormat.NUMBERSTYLE NF_NUMBER = 0, // NumberFormat.NUMBERSTYLE
@ -106,8 +106,8 @@ public class GlobalizationPreferences implements Freezable {
/** /**
* Date Format types * Date Format types
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public static final int public static final int
DF_FULL = DateFormat.FULL, // 0 DF_FULL = DateFormat.FULL, // 0
@ -120,8 +120,8 @@ public class GlobalizationPreferences implements Freezable {
/** /**
* For selecting a choice of display names * For selecting a choice of display names
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public static final int public static final int
ID_LOCALE = 0, ID_LOCALE = 0,
@ -139,7 +139,7 @@ public class GlobalizationPreferences implements Freezable {
/** /**
* Break iterator types * Break iterator types
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only * @deprecated This API is ICU internal only
*/ */
public static final int public static final int
@ -161,8 +161,8 @@ public class GlobalizationPreferences implements Freezable {
* @param locales list of locales in priority order, eg {"be", "fr"} * @param locales list of locales in priority order, eg {"be", "fr"}
* for Breton first, then French if that fails. * for Breton first, then French if that fails.
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setLocales(List inputLocales) { public GlobalizationPreferences setLocales(List inputLocales) {
if (isFrozen()) { if (isFrozen()) {
@ -176,8 +176,8 @@ public class GlobalizationPreferences implements Freezable {
* Get a copy of the language/locale priority list * Get a copy of the language/locale priority list
* *
* @return a copy of the language/locale priority list. * @return a copy of the language/locale priority list.
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public List getLocales() { public List getLocales() {
List result; List result;
@ -194,8 +194,8 @@ public class GlobalizationPreferences implements Freezable {
* Convenience function for getting the locales in priority order * Convenience function for getting the locales in priority order
* @param index The index (0..n) of the desired item. * @param index The index (0..n) of the desired item.
* @return desired item. null if index is out of range * @return desired item. null if index is out of range
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public ULocale getLocale(int index) { public ULocale getLocale(int index) {
List lcls = locales; List lcls = locales;
@ -215,8 +215,8 @@ public class GlobalizationPreferences implements Freezable {
* @see #setLocales(List locales) * @see #setLocales(List locales)
* @param uLocales list of locales in an array * @param uLocales list of locales in an array
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setLocales(ULocale[] uLocales) { public GlobalizationPreferences setLocales(ULocale[] uLocales) {
if (isFrozen()) { if (isFrozen()) {
@ -232,8 +232,8 @@ public class GlobalizationPreferences implements Freezable {
* @see #setLocales(List locales) * @see #setLocales(List locales)
* @param uLocale single locale * @param uLocale single locale
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setLocale(ULocale uLocale) { public GlobalizationPreferences setLocale(ULocale uLocale) {
if (isFrozen()) { if (isFrozen()) {
@ -250,8 +250,8 @@ public class GlobalizationPreferences implements Freezable {
* @param acceptLanguageString Accept-Language list, as defined by * @param acceptLanguageString Accept-Language list, as defined by
* Section 14.4 of the RFC 2616 (HTTP 1.1) * Section 14.4 of the RFC 2616 (HTTP 1.1)
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setLocales(String acceptLanguageString) { public GlobalizationPreferences setLocales(String acceptLanguageString) {
if (isFrozen()) { if (isFrozen()) {
@ -309,8 +309,8 @@ public class GlobalizationPreferences implements Freezable {
* class name * class name
* @return a resource bundle for the given base name and locale based on the * @return a resource bundle for the given base name and locale based on the
* language/locale priority list stored in this object * language/locale priority list stored in this object
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public ResourceBundle getResourceBundle(String baseName) { public ResourceBundle getResourceBundle(String baseName) {
return getResourceBundle(baseName, null); return getResourceBundle(baseName, null);
@ -326,8 +326,8 @@ public class GlobalizationPreferences implements Freezable {
* @param loader the class object from which to load the resource bundle * @param loader the class object from which to load the resource bundle
* @return a resource bundle for the given base name and locale based on the * @return a resource bundle for the given base name and locale based on the
* language/locale priority list stored in this object * language/locale priority list stored in this object
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public ResourceBundle getResourceBundle(String baseName, ClassLoader loader) { public ResourceBundle getResourceBundle(String baseName, ClassLoader loader) {
UResourceBundle urb = null; UResourceBundle urb = null;
@ -381,8 +381,8 @@ public class GlobalizationPreferences implements Freezable {
* *
* @param territory code * @param territory code
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setTerritory(String territory) { public GlobalizationPreferences setTerritory(String territory) {
if (isFrozen()) { if (isFrozen()) {
@ -397,8 +397,8 @@ public class GlobalizationPreferences implements Freezable {
* computed from the general locale setting. * computed from the general locale setting.
* *
* @return territory code, explicit or implicit. * @return territory code, explicit or implicit.
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public String getTerritory() { public String getTerritory() {
if (territory == null) { if (territory == null) {
@ -412,8 +412,8 @@ public class GlobalizationPreferences implements Freezable {
* *
* @param currency Valid ISO 4217 currency code. * @param currency Valid ISO 4217 currency code.
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setCurrency(Currency currency) { public GlobalizationPreferences setCurrency(Currency currency) {
if (isFrozen()) { if (isFrozen()) {
@ -427,8 +427,8 @@ public class GlobalizationPreferences implements Freezable {
* Get a copy of the currency computed according to the settings. * Get a copy of the currency computed according to the settings.
* *
* @return currency code, explicit or implicit. * @return currency code, explicit or implicit.
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public Currency getCurrency() { public Currency getCurrency() {
if (currency == null) { if (currency == null) {
@ -442,8 +442,8 @@ public class GlobalizationPreferences implements Freezable {
* *
* @param calendar arbitrary calendar * @param calendar arbitrary calendar
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setCalendar(Calendar calendar) { public GlobalizationPreferences setCalendar(Calendar calendar) {
if (isFrozen()) { if (isFrozen()) {
@ -457,8 +457,8 @@ public class GlobalizationPreferences implements Freezable {
* Get a copy of the calendar according to the settings. * Get a copy of the calendar according to the settings.
* *
* @return calendar explicit or implicit. * @return calendar explicit or implicit.
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public Calendar getCalendar() { public Calendar getCalendar() {
if (calendar == null) { if (calendar == null) {
@ -474,8 +474,8 @@ public class GlobalizationPreferences implements Freezable {
* *
* @param timezone a valid TZID (see UTS#35). * @param timezone a valid TZID (see UTS#35).
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setTimeZone(TimeZone timezone) { public GlobalizationPreferences setTimeZone(TimeZone timezone) {
if (isFrozen()) { if (isFrozen()) {
@ -490,8 +490,8 @@ public class GlobalizationPreferences implements Freezable {
* heuristically computed from other settings. * heuristically computed from other settings.
* *
* @return timezone, either implicitly or explicitly set * @return timezone, either implicitly or explicitly set
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public TimeZone getTimeZone() { public TimeZone getTimeZone() {
if (timezone == null) { if (timezone == null) {
@ -504,8 +504,8 @@ public class GlobalizationPreferences implements Freezable {
* Get a copy of the collator according to the settings. * Get a copy of the collator according to the settings.
* *
* @return collator explicit or implicit. * @return collator explicit or implicit.
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public Collator getCollator() { public Collator getCollator() {
if (collator == null) { if (collator == null) {
@ -522,8 +522,8 @@ public class GlobalizationPreferences implements Freezable {
* Explicitly set the collator for this object. * Explicitly set the collator for this object.
* @param collator * @param collator
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setCollator(Collator collator) { public GlobalizationPreferences setCollator(Collator collator) {
if (isFrozen()) { if (isFrozen()) {
@ -583,8 +583,8 @@ public class GlobalizationPreferences implements Freezable {
* @param id language code, script code, ... * @param id language code, script code, ...
* @param type specifies the type of the ID: ID_LANGUAGE, etc. * @param type specifies the type of the ID: ID_LANGUAGE, etc.
* @return the display name * @return the display name
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public String getDisplayName(String id, int type) { public String getDisplayName(String id, int type) {
String result = id; String result = id;
@ -674,8 +674,8 @@ public class GlobalizationPreferences implements Freezable {
* @param timeStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE * @param timeStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE
* @param format The date format * @param format The date format
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setDateFormat(int dateStyle, int timeStyle, DateFormat format) { public GlobalizationPreferences setDateFormat(int dateStyle, int timeStyle, DateFormat format) {
if (isFrozen()) { if (isFrozen()) {
@ -698,8 +698,8 @@ public class GlobalizationPreferences implements Freezable {
* @param dateStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE * @param dateStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE
* @param timeStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE * @param timeStyle DF_FULL, DF_LONG, DF_MEDIUM, DF_SHORT or DF_NONE
* @return a DateFormat, according to the above description * @return a DateFormat, according to the above description
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public DateFormat getDateFormat(int dateStyle, int timeStyle) { public DateFormat getDateFormat(int dateStyle, int timeStyle) {
if (dateStyle == DF_NONE && timeStyle == DF_NONE if (dateStyle == DF_NONE && timeStyle == DF_NONE
@ -728,8 +728,8 @@ public class GlobalizationPreferences implements Freezable {
* used. * used.
* *
* @param style NF_NUMBER, NF_CURRENCY, NF_PERCENT, NF_SCIENTIFIC, NF_INTEGER * @param style NF_NUMBER, NF_CURRENCY, NF_PERCENT, NF_SCIENTIFIC, NF_INTEGER
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public NumberFormat getNumberFormat(int style) { public NumberFormat getNumberFormat(int style) {
if (style < 0 || style >= NF_LIMIT) { if (style < 0 || style >= NF_LIMIT) {
@ -753,8 +753,8 @@ public class GlobalizationPreferences implements Freezable {
* @param style NF_NUMBER, NF_CURRENCY, NF_PERCENT, NF_SCIENTIFIC, NF_INTEGER * @param style NF_NUMBER, NF_CURRENCY, NF_PERCENT, NF_SCIENTIFIC, NF_INTEGER
* @param format The number format * @param format The number format
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences setNumberFormat(int style, NumberFormat format) { public GlobalizationPreferences setNumberFormat(int style, NumberFormat format) {
if (isFrozen()) { if (isFrozen()) {
@ -771,8 +771,8 @@ public class GlobalizationPreferences implements Freezable {
* Restore the object to the initial state. * Restore the object to the initial state.
* *
* @return this, for chaining * @return this, for chaining
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public GlobalizationPreferences reset() { public GlobalizationPreferences reset() {
if (isFrozen()) { if (isFrozen()) {
@ -826,8 +826,8 @@ public class GlobalizationPreferences implements Freezable {
* to customize the algorithm used for populating the locale list. * to customize the algorithm used for populating the locale list.
* *
* @param localeList The list of input locales * @param localeList The list of input locales
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected List processLocales(List inputLocales) { protected List processLocales(List inputLocales) {
List result = new ArrayList(); List result = new ArrayList();
@ -957,8 +957,8 @@ public class GlobalizationPreferences implements Freezable {
* *
* @param dateStyle * @param dateStyle
* @param timeStyle * @param timeStyle
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected DateFormat guessDateFormat(int dateStyle, int timeStyle) { protected DateFormat guessDateFormat(int dateStyle, int timeStyle) {
DateFormat result; DateFormat result;
@ -982,8 +982,8 @@ public class GlobalizationPreferences implements Freezable {
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @param style * @param style
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected NumberFormat guessNumberFormat(int style) { protected NumberFormat guessNumberFormat(int style) {
NumberFormat result; NumberFormat result;
@ -1017,8 +1017,8 @@ public class GlobalizationPreferences implements Freezable {
/** /**
* This function can be overridden by subclasses to use different heuristics. * This function can be overridden by subclasses to use different heuristics.
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected String guessTerritory() { protected String guessTerritory() {
String result; String result;
@ -1053,8 +1053,8 @@ public class GlobalizationPreferences implements Freezable {
/** /**
* This function can be overridden by subclasses to use different heuristics * This function can be overridden by subclasses to use different heuristics
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected Currency guessCurrency() { protected Currency guessCurrency() {
return Currency.getInstance(new ULocale("und-" + getTerritory())); return Currency.getInstance(new ULocale("und-" + getTerritory()));
@ -1065,8 +1065,8 @@ public class GlobalizationPreferences implements Freezable {
* <b>It MUST return a 'safe' value, * <b>It MUST return a 'safe' value,
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected List guessLocales() { protected List guessLocales() {
if (implicitLocales == null) { if (implicitLocales == null) {
@ -1082,8 +1082,8 @@ public class GlobalizationPreferences implements Freezable {
* <b>It MUST return a 'safe' value, * <b>It MUST return a 'safe' value,
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected Collator guessCollator() { protected Collator guessCollator() {
ULocale collLocale = getAvailableLocale(TYPE_COLLATOR); ULocale collLocale = getAvailableLocale(TYPE_COLLATOR);
@ -1099,8 +1099,8 @@ public class GlobalizationPreferences implements Freezable {
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @param type * @param type
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected BreakIterator guessBreakIterator(int type) { protected BreakIterator guessBreakIterator(int type) {
BreakIterator bitr = null; BreakIterator bitr = null;
@ -1135,8 +1135,8 @@ public class GlobalizationPreferences implements Freezable {
* <b>It MUST return a 'safe' value, * <b>It MUST return a 'safe' value,
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected TimeZone guessTimeZone() { protected TimeZone guessTimeZone() {
// TODO fix using real data // TODO fix using real data
@ -1169,8 +1169,8 @@ public class GlobalizationPreferences implements Freezable {
* <b>It MUST return a 'safe' value, * <b>It MUST return a 'safe' value,
* one whose modification will not affect this object.</b> * one whose modification will not affect this object.</b>
* *
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
protected Calendar guessCalendar() { protected Calendar guessCalendar() {
ULocale calLocale = getAvailableLocale(TYPE_CALENDAR); ULocale calLocale = getAvailableLocale(TYPE_CALENDAR);
@ -1497,16 +1497,16 @@ public class GlobalizationPreferences implements Freezable {
private boolean frozen; private boolean frozen;
/** /**
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public boolean isFrozen() { public boolean isFrozen() {
return frozen; return frozen;
} }
/** /**
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public Object freeze() { public Object freeze() {
frozen = true; frozen = true;
@ -1514,8 +1514,8 @@ public class GlobalizationPreferences implements Freezable {
} }
/** /**
* @internal * @draft ICU 3.6
* @deprecated This API is ICU internal only. * @provisional This API might change or be removed in a future release.
*/ */
public Object cloneAsThawed() { public Object cloneAsThawed() {
try { try {

View File

@ -125,8 +125,7 @@ public final class VersionInfo
/** /**
* Data version string for ICU's internal data * Data version string for ICU's internal data
* @internal * @internal
* @draft ICU 3.0 * @deprecated This API is ICU internal only.
* @provisional This API might change or be removed in a future release.
*/ */
public static final String ICU_DATA_VERSION = "36b"; public static final String ICU_DATA_VERSION = "36b";