Representing a name using Java™

A Name object allows you to represent a user or server name so that you can access the parts of the name as properties. Use createName in Session to create a Name object and specify a name. If the name is in the form of a hierarchical name, it is treated as a hierarchical name; otherwise, it is treated as a flat name. Use getUserNameList to get a vector of Name objects representing the current user name and alternate user name; use getUserNameObject to get a Name object representing the current user name; use getUserGroupNameList to get a vector of Name objects representing the groups to which the current user belongs.

The following methods access the Name properties. These methods return an empty string for undefined properties.

  • isHierarchical returns true if the name is hierarchical.
  • getAbbreviated returns a String value containing the abbreviated form of a hierarchical name.
  • getCanonical returns a String value containing the canonical form of a hierarchical name.
  • getCommon returns a String value containing the common name (CN=) component of a hierarchical name.
  • getCountry returns a String value containing the country/region (C=) component of a hierarchical name.
  • getOrganization returns a String value containing the organization (O=) component of a hierarchical name.
  • getOrgUnit1 returns a String value containing the first organizational unit (OU=) component of a hierarchical name.
  • getOrgUnit2 returns a String value containing the second organizational unit (OU=) component of a hierarchical name.
  • getOrgUnit3 returns a String value containing the third organizational unit (OU=) component of a hierarchical name.
  • getOrgUnit4 returns a String value containing the fourth organizational unit (OU=) component of a hierarchical name.
  • getKeyword returns a String value containing the country\organization\organizational unit 1\organizational unit 2\organizational unit 3\organizational unit 4.
  • getGeneration returns a String value containing the generation component of a hierarchical name (Q=), for example, "Jr."
  • getGiven returns a String value containing the given component of a hierarchical name (G=).
  • getInitials returns a String value containing the initials component of a hierarchical name (I=).
  • getSurname returns a String value containing the surname part of a name.
  • getADMD returns a String value containing the administration management domain name component of a hierarchical name (A=).
  • getPRMD returns a String value containing the private management domain name component of a hierarchical name (P=).
  • getLanguage returns a String value containing the language associated with a name.
  • getParent returns a Session object representing the current session.
  • getAddr821 returns a String value containing an Internet address in RFC 821 format.
  • getAddr822Comment1 returns a String value containing the Comment1 part of an Internet address in RFC 822 format.
  • getAddr822Comment2 returns a String value containing the Comment2 part of an Internet address in RFC 822 format.
  • getAddr822Comment3 returns a String value containing the Comment3 part of an Internet address in RFC 822 format.
  • getAddr822LocalPart returns a String value containing the LocalPart part of an Internet address in RFC 822 format.
  • getAddr822Phrase returns a String value containing the Phrase part of an Internet address in RFC 822 format.