Class SimplePersonName

java.lang.Object
com.ibm.icu.text.SimplePersonName
All Implemented Interfaces:
PersonName

public class SimplePersonName extends Object implements PersonName
A concrete implementation of PersonNameFormatter.PersonName that simply stores the field values in a Map. A caller can store both raw field values (such as "given") and modified field values (such as "given-informal") in a SimplePersonName. But beyond storing and returning modified field values provided to it by the caller, SimplePersonName relies on the PersonNameFormatter's default handling of field modifiers.
  • Method Details

    • builder

      public static SimplePersonName.Builder builder()
      Returns a Builder object that can be used to construct a new SimplePersonName object.
      Returns:
      A Builder object that can be used to construct a new SimplePersonName object.
    • getNameLocale

      public Locale getNameLocale()
      Returns the locale of the name-- that is, the language or country of origin for the person being named.
      Specified by:
      getNameLocale in interface PersonName
      Returns:
      The name's locale, or null if it's unknown.
    • getPreferredOrder

      public PersonName.PreferredOrder getPreferredOrder()
      Returns the preferred field order for the name. This will be DEFAULT, unless the caller sets it to something else using the builder.
      Specified by:
      getPreferredOrder in interface PersonName
      Returns:
      The name's preferred field order.
    • getFieldValue

      public String getFieldValue(PersonName.NameField nameField, Set<PersonName.FieldModifier> modifiers)
      Returns one field of the name, possibly in a modified form. This class can store modified versions of fields, provided at construction time, and this function will return them. Otherwise, it ignores modifiers and relies on PersonNameFormat's default modifier handling.
      Specified by:
      getFieldValue in interface PersonName
      Parameters:
      nameField - The identifier of the requested field.
      modifiers - An IN/OUT parameter that specifies modifiers to apply to the basic field value. On return, this list will contain any modifiers that this object didn't handle. This class will always return this set unmodified, unless a modified version of the requested field was provided at construction time.
      Returns:
      The value of the requested field, optionally modified by some or all of the requested modifiers, or null if the requested field isn't present in the name.
    • toString

      @Deprecated public String toString()
      Deprecated.
      This API is ICU internal only.
      Overrides:
      toString in class Object