* 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 {
* @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);
* @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);
* <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 {
* @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);
* </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 {
* @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() {
* @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() {
* @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() {
* @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() {
* (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) {
* @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) {
* 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 {
* @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) {
* @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) {
* @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) {
* @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) {
* @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() {
* <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")
/**
* @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 {
* @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() {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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) {
/**
* @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() {
/**
* @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 {
* @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() {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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) {
/**
* @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() {
* 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 {
/**
* @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 {
/**
* @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) {
* @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() {
/**
* @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) {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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() {
/**
* @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 {
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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() {
* 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 {
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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) {
/**
* @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() {
/**
* @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 {
* @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() {
/**
* @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() {
/**
* @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 {
/**
* @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) {
/**
* @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() {
* 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> {
* {@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() {
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @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() {
/**
* @internal ICU 72 technology preview
- * @deprecated This API is for ICU internal use only.
+ * @deprecated This API is for technology preview only.
*/
@Deprecated
@Override
/**
* @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 {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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) {
/**
* @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() {
* </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 {
* @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() {
* @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) {
* @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() {
* @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) {
* @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() {
* @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) {
* @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() {
* 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 {
* @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) {
* @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) {
* @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) {
* @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() {
* @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) {
* @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) {
* @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() {
* @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) {
* @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) {
* @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() {
* @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() {
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) {
}
* 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 {
* @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) {
* {@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
* {@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
* {@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
* {@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
* {@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
* {@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
* {@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
* 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 {
* @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);
* <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 {
* @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);
* 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() {
* @see SimplePersonName
* @deprecated This API is for technology preview only.
*/
+@Deprecated
public interface PersonName {
//==============================================================================
// Identifiers used to request field values from the PersonName object
* @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"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
GIVEN("given"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
GIVEN2("given2"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SURNAME("surname"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SURNAME2("surname2"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SUFFIX("suffix"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
PREFERRED_ORDER("preferredOrder");
private final String name;
/**
* 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;
/**
* 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)) {
* @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:
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
INFORMAL("informal"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
PREFIX("prefix"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
CORE("core"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
INITIAL("initial"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
MONOGRAM("monogram"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
ALL_CAPS("allCaps"),
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
INITIAL_CAP("initialCap");
private final String name;
/**
* 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;
/**
* 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)) {
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Locale getNameLocale();
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public String getFieldValue(NameField identifier, Set<FieldModifier> modifiers);
}
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+@Deprecated
public class PersonNameFormatter {
//==============================================================================
// Parameters that control formatting behavior
* @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,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
MEDIUM,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SHORT
}
* @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,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
REFERRING,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
MONOGRAM
}
* @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,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
INFORMAL
}
* @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,
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SORTING,
/**
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
SURNAME_ALLCAPS
}
* @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.
* @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;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder setLength(Length length) {
this.length = length;
return this;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder setUsage(Usage usage) {
this.usage = usage;
return this;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder setFormality(Formality formality) {
this.formality = formality;
return this;
* @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;
* @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);
}
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public static Builder builder() {
return new Builder();
}
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder toBuilder() {
Builder builder = builder();
builder.setLocale(impl.getLocale());
* @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);
/**
* @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);
}
* @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.
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder setLocale(Locale locale) {
this.locale = locale;
return this;
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public Builder addField(NameField field,
Collection<FieldModifier> modifiers,
String value) {
* @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
* @internal ICU 72 technology preview
* @deprecated This API is for technology preview only.
*/
+ @Deprecated
public static Builder builder() {
return new Builder();
}
* @deprecated This API is for technology preview only.
*/
@Override
+ @Deprecated
public Locale getNameLocale() {
return nameLocale;
}
* @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();