organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-07 06:25:30 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 1

ICU-12186 merge API promotion branch and update APIChangeReport

Browse source 
X-SVN-Rev: 38473
This commit is contained in:
Scott Russell 2016-03-03 04:17:43 +00:00
parent d743a8b947
commit 3fb3162cce
5 changed files with 119 additions and 53 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

104
icu4j/APIChangeReport.html
View file

@ -2,30 +2,71 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>ICU4J API Comparison: ICU4J 56.1 with ICU4J 57.0.1</title>
<title>ICU4J API Comparison: ICU4J 56.1 with ICU4J 57.1</title>
<!-- Copyright 2016, IBM, All Rights Reserved. -->
</head>
<body>
<h1>ICU4J API Comparison: ICU4J 56.1 with ICU4J 57.0.1</h1>
<h1>ICU4J API Comparison: ICU4J 56.1 with ICU4J 57.1</h1>
<hr/>
<h2>Removed from ICU4J 56.1</h2>
<p>(no API removed)</p>
<h3>Package com.ibm.icu.text</h3>
<ul>
DateFormat
<ul>
<li><span style='color:orange'>(draft)</span> public static final int TIME_SEPARATOR</li>
</ul>
DateFormat.Field
<ul>
<li><span style='color:orange'>(draft)</span> public static final DateFormat.Field TIME_SEPARATOR</li>
</ul>
DateFormatSymbols
<ul>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getTimeSeparatorString</i>()</li>
<li><span style='color:orange'>(draft)</span> public void <i>setTimeSeparatorString</i>(java.lang.String)</li>
</ul>
</ul>
<hr/>
<h2>Deprecated or Obsoleted in ICU4J 57.0.1</h2>
<h2>Deprecated or Obsoleted in ICU4J 57.1</h2>
<p>(no API obsoleted)</p>
<hr/>
<h2>Changed in ICU4J 57.0.1 (old, new)</h2>
<h2>Changed in ICU4J 57.1 (old, new)</h2>
<p>(no API changed)</p>
<hr/>
<h2>Promoted to stable in ICU4J 57.0.1</h2>
<p>(no API promoted to stable)</p>
<h2>Promoted to stable in ICU4J 57.1</h2>
<h3>Package com.ibm.icu.text</h3>
<ul>
<li><span style='color:green'>(stable)</span> public static class <i>LocaleDisplayNames.UiListItem</i></li>
<li><span style='color:green'>(stable)</span> public final class <i>ScientificNumberFormatter</i></li>
LocaleDisplayNames
<ul>
<li><span style='color:green'>(stable)</span> public java.util.List&lt;LocaleDisplayNames.UiListItem&gt; <i>getUiList</i>(java.util.Set&lt;ULocale&gt;, boolean, java.util.Comparator&lt;java.lang.Object&gt;)</li>
<li><span style='color:green'>(stable)</span> public abstract java.util.List&lt;LocaleDisplayNames.UiListItem&gt; <i>getUiListCompareWholeItems</i>(java.util.Set&lt;ULocale&gt;, java.util.Comparator&lt;LocaleDisplayNames.UiListItem&gt;)</li>
</ul>
MeasureFormat
<ul>
<li><span style='color:green'>(stable)</span> public java.lang.StringBuilder <i>formatMeasurePerUnit</i>(Measure, MeasureUnit, java.lang.StringBuilder, java.text.FieldPosition)</li>
</ul>
</ul>
<h3>Package com.ibm.icu.util</h3>
<ul>
IslamicCalendar
<ul>
<li><span style='color:green'>(stable)</span> public IslamicCalendar.CalculationType <i>getCalculationType</i>()</li>
<li><span style='color:green'>(stable)</span> public void <i>setCalculationType</i>(IslamicCalendar.CalculationType)</li>
</ul>
</ul>
<hr/>
<h2>Added in ICU4J 57.0.1</h2>
<h2>Added in ICU4J 57.1</h2>
<h3>Package com.ibm.icu.lang</h3>
<ul>
@ -41,9 +82,54 @@ UProperty
<h3>Package com.ibm.icu.text</h3>
<ul>
<li><span style='color:orange'>(draft)</span> public final class <i>SimpleFormatter</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>RelativeDateTimeFormatter.RelativeDateTimeUnit</i></li>
DateFormat.Field
<ul>
<li><span style='color:orange'>(draft)</span> public static final DateFormat.Field AM_PM_MIDNIGHT_NOON</li>
<li><span style='color:orange'>(draft)</span> public static final DateFormat.Field FLEXIBLE_DAY_PERIOD</li>
</ul>
RelativeDateTimeFormatter
<ul>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>format</i>(double, RelativeDateTimeFormatter.RelativeDateTimeUnit)</li>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>formatNumeric</i>(double, RelativeDateTimeFormatter.RelativeDateTimeUnit)</li>
</ul>
RelativeDateTimeFormatter.RelativeDateTimeUnit
<ul>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit DAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit FRIDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit HOUR</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MINUTE</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MONDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MONTH</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit QUARTER</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SATURDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SECOND</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SUNDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit THURSDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit TUESDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit WEDNESDAY</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit WEEK</li>
<li><span style='color:orange'>(draft)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit YEAR</li>
</ul>
SimpleDateFormat
<ul>
<li><span style='color:orange'>(draft)</span> protected int <i>matchDayPeriodString</i>(java.lang.String, int, java.lang.String[], int, Output&lt;DayPeriodRules.DayPeriod&gt;)</li>
</ul>
</ul>
<h3>Package com.ibm.icu.util</h3>
<ul>
MeasureUnit
<ul>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit GALLON_IMPERIAL</li>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit MILE_PER_GALLON_IMPERIAL</li>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit MILLIGRAM_PER_DECILITER</li>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit MILLIMOLE_PER_LITER</li>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit PART_PER_MILLION</li>
</ul>
</ul>
<hr/>
<p><i><font size="-1">Contents generated by ReportAPI tool on Sat Jan 30 01:35:42 EST 2016<br/>Copyright (C) 2016, International Business Machines Corporation, All Rights Reserved.</font></i></p>
<p><i><font size="-1">Contents generated by ReportAPI tool on Wed Mar 02 22:57:30 EST 2016<br/>Copyright (C) 2016, International Business Machines Corporation, All Rights Reserved.</font></i></p>
</body>
</html>

36
icu4j/main/classes/core/src/com/ibm/icu/text/LocaleDisplayNames.java
View file

@ -278,8 +278,7 @@ public abstract class LocaleDisplayNames {
* @param localeSet a list of locales to present in a UI list. The casing uses the settings in the LocaleDisplayNames instance.
* @return an ordered list of UiListItems.
* @throws IllformedLocaleException if any of the locales in localeSet are malformed.
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public List<UiListItem> getUiList(Set<ULocale> localeSet, boolean inSelf, Comparator<Object> collator) {
return getUiListCompareWholeItems(localeSet, UiListItem.getComparator(collator, inSelf));
@ -292,39 +291,33 @@ public abstract class LocaleDisplayNames {
* @param localeSet a list of locales to present in a UI list. The casing uses the settings in the LocaleDisplayNames instance.
* @return an ordered list of UiListItems.
* @throws IllformedLocaleException if any of the locales in localeSet are malformed.
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public abstract List<UiListItem> getUiListCompareWholeItems(Set<ULocale> localeSet, Comparator<UiListItem> comparator);
/**
* Struct-like class used to return information for constructing a UI list, each corresponding to a locale.
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static class UiListItem {
/**
* Returns the minimized locale for an input locale, such as sr-Cyrl → sr
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public final ULocale minimized;
/**
* Returns the modified locale for an input locale, such as sr → sr-Cyrl, where there is also an sr-Latn in the list
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public final ULocale modified;
/**
* Returns the name of the modified locale in the display locale, such as "Englisch (VS)" (for 'en-US', where the display locale is 'de').
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public final String nameInDisplayLocale;
/**
* Returns the name of the modified locale in itself, such as "English (US)" (for 'en-US').
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public final String nameInSelf;
@ -334,8 +327,7 @@ public abstract class LocaleDisplayNames {
* @param modified modified for an input locale
* @param nameInDisplayLocale name of the modified locale in the display locale
* @param nameInSelf name of the modified locale in itself
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public UiListItem(ULocale minimized, ULocale modified, String nameInDisplayLocale, String nameInSelf) {
this.minimized = minimized;
@ -347,8 +339,7 @@ public abstract class LocaleDisplayNames {
/**
* {@inheritDoc}
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
@Override
public boolean equals(Object obj) {
@ -362,8 +353,7 @@ public abstract class LocaleDisplayNames {
/**
* {@inheritDoc}
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
@Override
public int hashCode() {
@ -373,8 +363,7 @@ public abstract class LocaleDisplayNames {
/**
* {@inheritDoc}
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
@Override
public String toString() {
@ -387,8 +376,7 @@ public abstract class LocaleDisplayNames {
* @param inSelf if true, compares the nameInSelf, otherwise the nameInDisplayLocale
* @param comparator (meant for strings, but because Java Collator doesn't have &lt;String&gt;...)
* @return UiListItem comparator
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static Comparator<UiListItem> getComparator(Comparator<Object> comparator, boolean inSelf) {
return new UiListItemComparator(comparator, inSelf);

3
icu4j/main/classes/core/src/com/ibm/icu/text/MeasureFormat.java
View file

@ -491,8 +491,7 @@ public class MeasureFormat extends UFormat {
* @param appendTo formatted string appended here.
* @param pos The field position.
* @return appendTo.
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public StringBuilder formatMeasurePerUnit(
Measure measure,

18
icu4j/main/classes/core/src/com/ibm/icu/text/ScientificNumberFormatter.java
View file

@ -30,8 +30,7 @@ import com.ibm.icu.util.ULocale;
* System.out.println(fmt.format(1.23456e-78));
* </pre>
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*
*/
public final class ScientificNumberFormatter {
@ -46,8 +45,7 @@ public final class ScientificNumberFormatter {
* @param locale The locale
* @return The ScientificNumberFormatter instance.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static ScientificNumberFormatter getSuperscriptInstance(ULocale locale) {
return getInstanceForLocale(locale, SUPER_SCRIPT);
@ -61,8 +59,7 @@ public final class ScientificNumberFormatter {
* clones it when creating the ScientificNumberFormatter.
* @return the ScientificNumberFormatter instance.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static ScientificNumberFormatter getSuperscriptInstance(
DecimalFormat df) {
@ -77,8 +74,7 @@ public final class ScientificNumberFormatter {
* @param endMarkup the markup to end superscript e.g {@code </sup>}
* @return The ScientificNumberFormatter instance.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static ScientificNumberFormatter getMarkupInstance(
ULocale locale,
@ -98,8 +94,7 @@ public final class ScientificNumberFormatter {
* @param endMarkup the markup to end superscript e.g {@code </sup>}
* @return The ScientificNumberFormatter instance.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public static ScientificNumberFormatter getMarkupInstance(
DecimalFormat df,
@ -115,8 +110,7 @@ public final class ScientificNumberFormatter {
* anything that DecimalFormat#format(Object) accepts.
* @return the formatted string.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public String format(Object number) {
synchronized (fmt) {

11
icu4j/main/classes/core/src/com/ibm/icu/util/IslamicCalendar.java
View file

@ -1,6 +1,6 @@
/*
*******************************************************************************
* Copyright (C) 1996-2015, International Business Machines Corporation and *
* Copyright (C) 1996-2016, International Business Machines Corporation and *
* others. All Rights Reserved. *
*******************************************************************************
*/
@ -324,6 +324,7 @@ public class IslamicCalendar extends Calendar {
* @param beCivil <code>true</code> to use the civil calendar,
* <code>false</code> to use the astronomical calendar.
* @stable ICU 2.8
* @discouraged ICU 57 use setCalculationType(CalculationType) instead
*/
public void setCivil(boolean beCivil)
{
@ -351,7 +352,7 @@ public class IslamicCalendar extends Calendar {
* calendar, or <code>false</code> if using the religious, astronomical
* calendar.
* @stable ICU 2.8
*
* @discouraged ICU 57 use getCalculationType() instead
*/
public boolean isCivil() {
if(cType == CalculationType.ISLAMIC_CIVIL) {
@ -951,8 +952,7 @@ public class IslamicCalendar extends Calendar {
/**
* sets the calculation type for this calendar.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public void setCalculationType(CalculationType type) {
cType = type;
@ -967,8 +967,7 @@ public class IslamicCalendar extends Calendar {
/**
* gets the calculation type for this calendar.
*
* @draft ICU 55
* @provisional This API might change or be removed in a future release.
* @stable ICU 55
*/
public CalculationType getCalculationType() {
return cType;