ICU-21957 BRS72 J API signature file

This commit is contained in:
Yoshito Umaoka 2022-09-22 09:48:11 -04:00
parent b5acb0ffc2
commit 306be3ddf6
15 changed files with 190 additions and 154 deletions

View file

@ -10,7 +10,7 @@ import java.util.Map;
* that can be used from {@link MessageFormatter}.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface Formatter {
@ -23,7 +23,7 @@ public interface Formatter {
* @return the formatted string.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
String formatToString(Object toFormat, Map<String, Object> variableOptions);
@ -37,7 +37,7 @@ public interface Formatter {
* @return the formatted placeholder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
FormattedPlaceholder format(Object toFormat, Map<String, Object> variableOptions);

View file

@ -13,7 +13,7 @@ import java.util.Map;
* <p>We use it to create and cache various formatters with various options.</p>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface FormatterFactory {
@ -26,7 +26,7 @@ public interface FormatterFactory {
* @throws IllegalArgumentException
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
Formatter createFormatter(Locale locale, Map<String, Object> fixedOptions);

View file

@ -101,7 +101,7 @@ import java.util.Map;
* </table>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public class MessageFormatter {
@ -145,7 +145,7 @@ public class MessageFormatter {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -159,7 +159,7 @@ public class MessageFormatter {
* @return the locale.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Locale getLocale() {
@ -176,7 +176,7 @@ public class MessageFormatter {
* @return the pattern.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getPattern() {
@ -195,7 +195,7 @@ public class MessageFormatter {
* @return the data model.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Mf2DataModel getDataModel() {
@ -213,7 +213,7 @@ public class MessageFormatter {
* (for example wrong argument type, or null arguments, etc.)
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String formatToString(Map<String, Object> arguments) {
@ -228,7 +228,7 @@ public class MessageFormatter {
* @return the {@link FormattedMessage} class representing the message with parameters replaced.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public FormattedMessage format(Map<String, Object> arguments) {
@ -239,7 +239,7 @@ public class MessageFormatter {
* A {@code Builder} used to build instances of {@link MessageFormatter}.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -259,7 +259,7 @@ public class MessageFormatter {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setLocale(Locale locale) {
@ -275,7 +275,7 @@ public class MessageFormatter {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setPattern(String pattern) {
@ -297,7 +297,7 @@ public class MessageFormatter {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setFunctionRegistry(Mf2FunctionRegistry functionRegistry) {
@ -313,7 +313,7 @@ public class MessageFormatter {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setDataModel(Mf2DataModel dataModel) {
@ -328,7 +328,7 @@ public class MessageFormatter {
* @return the {@link MessageFormatter} created.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public MessageFormatter build() {

View file

@ -21,7 +21,7 @@ import java.util.StringJoiner;
* <a target="github" href="https://github.com/unicode-org/message-format-wg/blob/main/spec/message.ebnf">EBNF</a>.</p>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@SuppressWarnings("javadoc")
@ -29,7 +29,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class SelectorKeys {
@ -46,7 +46,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -55,7 +55,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public List<String> getKeys() {
@ -64,7 +64,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -78,7 +78,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -90,7 +90,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder add(String key) {
@ -100,7 +100,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addAll(Collection<String> otherKeys) {
@ -110,7 +110,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public SelectorKeys build() {
@ -121,7 +121,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Pattern {
@ -138,7 +138,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -147,7 +147,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public List<Part> getParts() {
@ -156,7 +156,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -172,7 +172,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -184,7 +184,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder add(Part part) {
@ -194,7 +194,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addAll(Collection<Part> otherParts) {
@ -204,7 +204,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Pattern build() {
@ -219,7 +219,7 @@ public class Mf2DataModel {
* and that plain text {@link Text} and {@link Expression} are Part(s).
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface Part {
@ -227,7 +227,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Text implements Part {
@ -235,7 +235,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
private Text(Builder builder) {
@ -248,7 +248,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -257,7 +257,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Text(String value) {
@ -266,7 +266,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getValue() {
@ -275,7 +275,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -285,7 +285,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -297,7 +297,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setValue(String value) {
@ -307,7 +307,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Text build() {
@ -318,7 +318,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Expression implements Part {
@ -339,7 +339,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -348,7 +348,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Value getOperand() {
@ -357,7 +357,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getFunctionName() {
@ -366,7 +366,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Map<String, Value> getOptions() {
@ -375,7 +375,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -397,7 +397,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -411,7 +411,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setOperand(Value operand) {
@ -421,7 +421,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setFunctionName(String functionName) {
@ -431,7 +431,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addOption(String key, Value value) {
@ -441,7 +441,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addOptions(Map<String, Value> otherOptions) {
@ -451,7 +451,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Expression build() {
@ -470,7 +470,7 @@ public class Mf2DataModel {
* A Value can be either a Literal, or a Variable, but not both.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Value {
@ -489,7 +489,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -498,7 +498,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getLiteral() {
@ -507,7 +507,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getVariableName() {
@ -516,7 +516,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public boolean isLiteral() {
@ -525,7 +525,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public boolean isVariable() {
@ -534,7 +534,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -544,7 +544,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -557,7 +557,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setLiteral(String literal) {
@ -568,7 +568,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setVariableName(String variableName) {
@ -579,7 +579,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Value build() {
@ -590,7 +590,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Variable {
@ -606,7 +606,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -615,7 +615,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getName() {
@ -624,7 +624,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -636,7 +636,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setName(String name) {
@ -646,7 +646,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Variable build() {
@ -659,7 +659,7 @@ public class Mf2DataModel {
* This is only to not force LinkedHashMap on the public API.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class OrderedMap<K, V> extends LinkedHashMap<K, V> {
@ -669,7 +669,7 @@ public class Mf2DataModel {
* {@inheritDoc}
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public OrderedMap() {
@ -695,7 +695,7 @@ public class Mf2DataModel {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -704,7 +704,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public OrderedMap<String, Expression> getLocalVariables() {
@ -713,7 +713,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public List<Expression> getSelectors() {
@ -722,7 +722,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public OrderedMap<SelectorKeys, Pattern> getVariants() {
@ -731,7 +731,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Pattern getPattern() {
@ -740,7 +740,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -772,7 +772,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -787,7 +787,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addLocalVariable(String variableName, Expression expression) {
@ -797,7 +797,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addLocalVariables(OrderedMap<String, Expression> otherLocalVariables) {
@ -807,7 +807,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addSelector(Expression otherSelector) {
@ -817,7 +817,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addSelectors(List<Expression> otherSelectors) {
@ -827,7 +827,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addVariant(SelectorKeys keys, Pattern newPattern) {
@ -837,7 +837,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addVariants(OrderedMap<SelectorKeys, Pattern> otherVariants) {
@ -847,7 +847,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setPattern(Pattern pattern) {
@ -857,7 +857,7 @@ public class Mf2DataModel {
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Mf2DataModel build() {

View file

@ -27,7 +27,7 @@ import java.util.Set;
* </ul>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public class Mf2FunctionRegistry {
@ -47,7 +47,7 @@ public class Mf2FunctionRegistry {
* @return the Builder.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
@ -71,7 +71,7 @@ public class Mf2FunctionRegistry {
* @return the factory creating formatters for {@code name}. Returns {@code null} if none is registered.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public FormatterFactory getFormatter(String formatterName) {
@ -84,7 +84,7 @@ public class Mf2FunctionRegistry {
* @return a set of all the known formatter names.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Set<String> getFormatterNames() {
@ -98,7 +98,7 @@ public class Mf2FunctionRegistry {
* @return the name of the formatter class, if registered. Returns {@code null} otherwise.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getDefaultFormatterNameForType(Class<?> clazz) {
@ -125,7 +125,7 @@ public class Mf2FunctionRegistry {
* @return a set of all the known classes that have mapping to function names.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Set<Class<?>> getDefaultFormatterTypes() {
@ -143,7 +143,7 @@ public class Mf2FunctionRegistry {
* @see #getFormatter(String)
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public SelectorFactory getSelector(String selectorName) {
@ -156,7 +156,7 @@ public class Mf2FunctionRegistry {
* @return a set of all the known selector names.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Set<String> getSelectorNames() {
@ -167,7 +167,7 @@ public class Mf2FunctionRegistry {
* A {@code Builder} used to build instances of {@link Mf2FunctionRegistry}.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
@ -186,7 +186,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addAll(Mf2FunctionRegistry functionRegistry) {
@ -204,7 +204,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setFormatter(String formatterName, FormatterFactory formatterFactory) {
@ -219,7 +219,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder removeFormatter(String formatterName) {
@ -233,7 +233,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder clearFormatters() {
@ -249,7 +249,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setDefaultFormatterNameForType(Class<?> clazz, String formatterName) {
@ -264,7 +264,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder removeDefaultFormatterNameForType(Class<?> clazz) {
@ -278,7 +278,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder clearDefaultFormatterNames() {
@ -294,7 +294,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setSelector(String selectorName, SelectorFactory selectorFactory) {
@ -309,7 +309,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder removeSelector(String selectorName) {
@ -323,7 +323,7 @@ public class Mf2FunctionRegistry {
* @return the builder, for fluent use.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder clearSelectors() {
@ -337,7 +337,7 @@ public class Mf2FunctionRegistry {
* @return the function registry created.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Mf2FunctionRegistry build() {

View file

@ -117,52 +117,27 @@ class Mf2Serializer implements EventHandler {
Mf2Serializer() {}
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
@Override
public void reset(CharSequence input) {
this.input = input.toString();
tokens.clear();
}
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
@Override
public void startNonterminal(String name, int begin) {
tokens.add(new Token(Token.Kind.NONTERMINAL_START, name, begin, -1, input));
}
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
@Override
public void endNonterminal(String name, int end) {
tokens.add(new Token(Token.Kind.NONTERMINAL_END, name, -1, end, input));
}
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
@Override
public void terminal(String name, int begin, int end) {
tokens.add(new Token(Token.Kind.TERMINAL, name, begin, end, input));
}
/**
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
@Override
public void whitespace(int begin, int end) {
}

View file

@ -15,7 +15,7 @@ import com.ibm.icu.text.FormattedValue;
* Expect it to change.
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public class PlainStringFormattedValue implements FormattedValue {
@ -27,7 +27,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* @param value the string value to store
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public PlainStringFormattedValue(String value) {
@ -41,7 +41,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -53,7 +53,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -65,7 +65,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -77,7 +77,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -96,7 +96,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -110,7 +110,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
@ -122,7 +122,7 @@ public class PlainStringFormattedValue implements FormattedValue {
* {@inheritDoc}
*
* @internal ICU 72 technology preview. Visible For Testing.
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override

View file

@ -14,7 +14,7 @@ import java.util.Map;
* and <code>select</code> in {@link com.ibm.icu.text.MessageFormat}.</p>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface Selector {
@ -30,7 +30,7 @@ public interface Selector {
* @return the formatted string.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
boolean matches(Object value, String key, Map<String, Object> variableOptions);

View file

@ -13,7 +13,7 @@ import java.util.Map;
* <p>The we use it to create and cache various selectors with various options.</p>
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface SelectorFactory {
@ -25,7 +25,7 @@ public interface SelectorFactory {
* @return The Selector.
*
* @internal ICU 72 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
Selector createSelector(Locale locale, Map<String, Object> fixedOptions);

View file

@ -152,7 +152,7 @@ public class FormattedNumber implements FormattedValue {
* The gender of the formatted output.
*
* @internal ICU 69 technology preview
* @deprecated This API is for ICU internal use only.
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getGender() {

View file

@ -17,6 +17,7 @@ import java.util.Set;
* @see SimplePersonName
* @deprecated This API is for technology preview only.
*/
@Deprecated
public interface PersonName {
//==============================================================================
// Identifiers used to request field values from the PersonName object
@ -26,12 +27,14 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
enum NameField {
/**
* Contains titles and other words that precede the actual name, such as "Mr."
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
PREFIX("prefix"),
/**
@ -39,6 +42,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
GIVEN("given"),
/**
@ -47,6 +51,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
GIVEN2("given2"),
/**
@ -54,6 +59,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SURNAME("surname"),
/**
@ -63,6 +69,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SURNAME2("surname2"),
/**
@ -71,6 +78,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SUFFIX("suffix"),
/**
@ -82,6 +90,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
PREFERRED_ORDER("preferredOrder");
private final String name;
@ -92,8 +101,10 @@ public interface PersonName {
/**
* Returns the NameField's display name.
* @internal
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
public String toString() {
return name;
@ -102,7 +113,9 @@ public interface PersonName {
/**
* Returns the appropriate NameField for its display name.
* @internal
* @deprecated This API is for ICU internal use only.
*/
@Deprecated
public static NameField forString(String name) {
for (NameField field : values()) {
if (field.name.equals(name)) {
@ -118,6 +131,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
enum FieldModifier {
/**
* Requests an "informal" variant of the field, generally a nickname of some type:
@ -127,6 +141,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
INFORMAL("informal"),
/**
@ -137,6 +152,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
PREFIX("prefix"),
/**
@ -147,6 +163,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
CORE("core"),
/**
@ -156,6 +173,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
INITIAL("initial"),
/**
@ -166,6 +184,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
MONOGRAM("monogram"),
/**
@ -174,6 +193,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
ALL_CAPS("allCaps"),
/**
@ -183,6 +203,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
INITIAL_CAP("initialCap");
private final String name;
@ -193,8 +214,10 @@ public interface PersonName {
/**
* Returns the FieldModifier's display name.
* @internal
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
public String toString() {
return name;
@ -202,8 +225,10 @@ public interface PersonName {
/**
* Returns the appropriate fieldModifier for its display name.
* @internal
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static FieldModifier forString(String name) {
for (FieldModifier modifier : values()) {
if (modifier.name.equals(name)) {
@ -224,6 +249,7 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Locale getNameLocale();
/**
@ -239,5 +265,6 @@ public interface PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getFieldValue(NameField identifier, Set<FieldModifier> modifiers);
}

View file

@ -25,6 +25,7 @@ import com.ibm.icu.impl.personname.PersonNameFormatterImpl;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public class PersonNameFormatter {
//==============================================================================
// Parameters that control formatting behavior
@ -34,12 +35,14 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public enum Length {
/**
* The longest name length. Generally uses most of the fields in the name object.
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
LONG,
/**
@ -48,6 +51,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
MEDIUM,
/**
@ -56,6 +60,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SHORT
}
@ -64,12 +69,14 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public enum Usage {
/**
* Used for when the name is going to be used to address the user directly: "Turn left here, John."
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
ADDRESSING,
/**
@ -77,6 +84,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
REFERRING,
/**
@ -87,6 +95,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
MONOGRAM
}
@ -95,12 +104,14 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public enum Formality {
/**
* The more formal version of the name.
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
FORMAL,
/**
@ -109,6 +120,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
INFORMAL
}
@ -117,6 +129,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public enum Options {
/**
* Causes the formatter to generate results suitable for inclusion in a sorted list. For GN-first languages,
@ -125,6 +138,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SORTING,
/**
@ -133,6 +147,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
SURNAME_ALLCAPS
}
@ -147,6 +162,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static class Builder {
/**
* Sets the locale for the formatter to be constructed.
@ -155,6 +171,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setLocale(Locale locale) {
if (locale != null) {
this.locale = locale;
@ -169,6 +186,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setLength(Length length) {
this.length = length;
return this;
@ -181,6 +199,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setUsage(Usage usage) {
this.usage = usage;
return this;
@ -193,6 +212,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setFormality(Formality formality) {
this.formality = formality;
return this;
@ -207,6 +227,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setOptions(Set<Options> options) {
this.options = options;
return this;
@ -221,6 +242,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public PersonNameFormatter build() {
return new PersonNameFormatter(locale, length, usage, formality, options);
}
@ -244,6 +266,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
return new Builder();
}
@ -255,6 +278,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder toBuilder() {
Builder builder = builder();
builder.setLocale(impl.getLocale());
@ -273,6 +297,7 @@ public class PersonNameFormatter {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String formatToString(PersonName name) {
// TODO: Add a format() method that returns a FormattedPersonName object that descends from FormattedValue.
return impl.formatToString(name);
@ -286,7 +311,9 @@ public class PersonNameFormatter {
/**
* @internal For unit testing only!
* @deprecated This API is for unit testing only.
*/
@Deprecated
public PersonNameFormatter(Locale locale, String[] patterns) {
this.impl = new PersonNameFormatterImpl(locale, patterns);
}

View file

@ -21,14 +21,15 @@ import java.util.TreeSet;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public class SimplePersonName implements PersonName {
/**
* A utility class for constructing a SimplePersonName. Use SimplePersonName.builder()
* to get a new Builder instance.
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*
*/
@Deprecated
public static class Builder {
/**
* Set the locale for the new name object.
@ -38,6 +39,7 @@ public class SimplePersonName implements PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder setLocale(Locale locale) {
this.locale = locale;
return this;
@ -53,6 +55,7 @@ public class SimplePersonName implements PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public Builder addField(NameField field,
Collection<FieldModifier> modifiers,
String value) {
@ -83,6 +86,7 @@ public class SimplePersonName implements PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public SimplePersonName build() {
// special-case code for the "surname" field -- if it isn't specified, but "surname-prefix" and
// "surname-core" both are, let "surname" be the other two fields joined with a space
@ -112,6 +116,7 @@ public class SimplePersonName implements PersonName {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public static Builder builder() {
return new Builder();
}
@ -131,6 +136,7 @@ public class SimplePersonName implements PersonName {
* @deprecated This API is for technology preview only.
*/
@Override
@Deprecated
public Locale getNameLocale() {
return nameLocale;
}
@ -150,6 +156,7 @@ public class SimplePersonName implements PersonName {
* @deprecated This API is for technology preview only.
*/
@Override
@Deprecated
public String getFieldValue(NameField nameField, Set<FieldModifier> modifiers) {
// first look for the fully modified name in the internal table
String fieldName = nameField.toString();

Binary file not shown.

Binary file not shown.