com.dropbox.core.v2.users

Class Name

java.lang.Object

com.dropbox.core.v2.users.Name

public class Name
extends Object

Representations for a person's name to assist with internationalization.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Name.Serializer For internal use only.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	abbreviatedName
protected String	displayName
protected String	familiarName
protected String	givenName
protected String	surname

Constructor Summary

Constructors

Constructor and Description
Name(String givenName, String surname, String familiarName, String displayName, String abbreviatedName) Representations for a person's name to assist with internationalization.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getAbbreviatedName() An abbreviated form of the person's name.
String	getDisplayName() A name that can be used directly to represent the name of a user's Dropbox account.
String	getFamiliarName() Locale-dependent name.
String	getGivenName() Also known as a first name.
String	getSurname() Also known as a last name or family name.
int	hashCode()
String	toString()
String	toStringMultiline() Returns a String representation of this object formatted for easier readability.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

givenName

protected final String givenName

surname

protected final String surname

familiarName

protected final String familiarName

displayName

protected final String displayName

abbreviatedName

protected final String abbreviatedName

Constructor Detail

Name

public Name(String givenName,
            String surname,
            String familiarName,
            String displayName,
            String abbreviatedName)

Representations for a person's name to assist with internationalization.

Parameters:

givenName - Also known as a first name. Must not be null.

surname - Also known as a last name or family name. Must not be null.

familiarName - Locale-dependent name. In the US, a person's familiar name is their getGivenName(), but elsewhere, it could be any combination of a person's getGivenName() and getSurname(). Must not be null.

displayName - A name that can be used directly to represent the name of a user's Dropbox account. Must not be null.

abbreviatedName - An abbreviated form of the person's name. Their initials in most locales. Must not be null.

Throws:

IllegalArgumentException - If any argument does not meet its preconditions.

Method Detail

getGivenName

public String getGivenName()

Also known as a first name.

Returns:

value for this field, never null.

getSurname

public String getSurname()

Also known as a last name or family name.

Returns:

value for this field, never null.

getFamiliarName

public String getFamiliarName()

Locale-dependent name. In the US, a person's familiar name is their getGivenName(), but elsewhere, it could be any combination of a person's getGivenName() and getSurname().

Returns:

value for this field, never null.

getDisplayName

public String getDisplayName()

A name that can be used directly to represent the name of a user's Dropbox account.

Returns:

value for this field, never null.

getAbbreviatedName

public String getAbbreviatedName()

An abbreviated form of the person's name. Their initials in most locales.

Returns:

value for this field, never null.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

toStringMultiline

public String toStringMultiline()

Returns a String representation of this object formatted for easier readability.

The returned String may contain newlines.

Returns:

Formatted, multiline String representation of this object