Person (OpenMRS 1.8.5-SNAPSHOT API)

java.lang.Object
- org.openmrs.BaseOpenmrsObject
- - org.openmrs.BaseOpenmrsData
  - - org.openmrs.Person

All Implemented Interfaces:

Serializable, Auditable, OpenmrsData, OpenmrsObject, Voidable

Direct Known Subclasses:

Patient
```
public class Person
extends BaseOpenmrsData
implements Serializable
```
A Person in the system. This can be either a small person stub, or indicative of an actual Patient in the system. This class holds the generic person things that both the stubs and patients share. Things like birthdate, names, addresses, and attributes are all generified into the person table (and hence this super class)

See Also:

Patient, Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

protected Integer personId

static long serialVersionUID
- Fields inherited from class org.openmrs.BaseOpenmrsData
  creator

Fields
Modifier and Type	Field and Description
`protected Integer`	`personId`
`static long`	`serialVersionUID`

Constructor Summary

Constructors
Constructor and Description
`Person()` default empty constructor
`Person(Integer personId)` Default constructor taking in the primary key personId value
`Person(Person person)` This constructor is used to build a new Person object copy from another person object (usually a patient or a user subobject).

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addAddress(PersonAddress address)` Convenience method to add the `address` to this person's address list if the address doesn't exist already.
`void`	`addAttribute(PersonAttribute newAttribute)` Convenience method to add the `attribute` to this person's attribute list if the attribute doesn't exist already. Voids any current attribute with type = `newAttribute.getAttributeType()` NOTE: This effectively limits persons to only one attribute of any given type **
`void`	`addName(PersonName name)` Convenience method to add the `name` to this person's name list if the name doesn't exist already.
`boolean`	`equals(Object obj)`
`List<PersonAttribute>`	`getActiveAttributes()` Returns only the non-voided attributes for this person
`Set<PersonAddress>`	`getAddresses()`
`Integer`	`getAge()` Convenience method to calculate this person's age based on the birthdate For a person who lived 1990 to 2000, age would be -5 in 1985, 5 in 1995, 10 in 2000, and 10 2010.
`Integer`	`getAge(Date onDate)` Convenience method: calculates the person's age on a given date based on the birthdate
`PersonAttribute`	`getAttribute(Integer attributeTypeId)` Convenience method to get this person's first attribute that has a PersonAttributeTypeId equal to `attributeTypeId`.
`PersonAttribute`	`getAttribute(PersonAttributeType pat)` Convenience Method to return the first non-voided person attribute matching a person attribute type
`PersonAttribute`	`getAttribute(String attributeName)` Convenience method to get this person's first attribute that has a PersonAttributeType.name equal to `attributeName`.
`Map<String,PersonAttribute>`	`getAttributeMap()` Convenience method to get all of this person's attributes in map form: .
`Set<PersonAttribute>`	`getAttributes()`
`List<PersonAttribute>`	`getAttributes(Integer attributeTypeId)` Convenience method to get all of this person's attributes that have a PersonAttributeType.id equal to `attributeTypeId`.
`List<PersonAttribute>`	`getAttributes(PersonAttributeType personAttributeType)` Convenience method to get all of this person's attributes that have a PersonAttributeType equal to `personAttributeType`.
`List<PersonAttribute>`	`getAttributes(String attributeName)` Convenience method< to get all of this person's attributes that have a PersonAttributeType.name equal to `attributeName`.
`Date`	`getBirthdate()`
`Boolean`	`getBirthdateEstimated()`
`Concept`	`getCauseOfDeath()`
`Boolean`	`getDead()`
`Date`	`getDeathDate()`
`String`	`getFamilyName()` Convenience method to get the family name attribute on this person's preferred PersonName
`String`	`getGender()`
`String`	`getGivenName()` Convenience method to get the given name attribute on this person's preferred PersonName
`Integer`	`getId()`
`String`	`getMiddleName()` Convenience method to get the middle name attribute on this person's preferred PersonName
`Set<PersonName>`	`getNames()`
`PersonAddress`	`getPersonAddress()` Convenience Method to get the "preferred" address for person.
`User`	`getPersonChangedBy()`
`User`	`getPersonCreator()`
`Date`	`getPersonDateChanged()`
`Date`	`getPersonDateCreated()`
`Date`	`getPersonDateVoided()`
`Integer`	`getPersonId()`
`PersonName`	`getPersonName()` Convenience method to get the "preferred" name for the person.
`Boolean`	`getPersonVoided()`
`User`	`getPersonVoidedBy()`
`String`	`getPersonVoidReason()`
`int`	`hashCode()`
`Boolean`	`isBirthdateEstimated()`
`Boolean`	`isDead()`
`boolean`	`isPatient()`
`Boolean`	`isPersonVoided()`
`boolean`	`isUser()` Deprecated. use `UserService.getUsersByPerson(Person, boolean)`
`String`	`printAttributes()` Convenience method for viewing all of the person's current attributes
`void`	`removeAddress(PersonAddress address)` Convenience method to remove the `address` from this person's address list if the address exists already.
`void`	`removeAttribute(PersonAttribute attribute)` Convenience method to get the `attribute` from this person's attribute list if the attribute exists already.
`void`	`removeName(PersonName name)` Convenience method remove the `name` from this person's name list if the name exists already.
`Person`	`replaceSerialization(Map<?,?> sessionMap)` If the serializer wishes, don't serialize this entire object, just the important parts
`void`	`setAddresses(Set<PersonAddress> addresses)`
`void`	`setAttributes(Set<PersonAttribute> attributes)`
`void`	`setBirthdate(Date birthdate)`
`void`	`setBirthdateEstimated(Boolean birthdateEstimated)`
`void`	`setBirthdateFromAge(int age, Date ageOnDate)` Convenience method: sets a person's birth date from an age as of the given date Also sets flag indicating that the birth date is inexact.
`void`	`setCauseOfDeath(Concept causeOfDeath)`
`void`	`setDead(Boolean dead)`
`void`	`setDeathDate(Date deathDate)`
`void`	`setGender(String gender)`
`void`	`setId(Integer id)`
`void`	`setNames(Set<PersonName> names)`
`void`	`setPersonChangedBy(User changedBy)`
`void`	`setPersonCreator(User creator)`
`void`	`setPersonDateChanged(Date dateChanged)`
`void`	`setPersonDateCreated(Date dateCreated)`
`void`	`setPersonDateVoided(Date dateVoided)`
`void`	`setPersonId(Integer personId)`
`void`	`setPersonVoided(Boolean voided)`
`void`	`setPersonVoidedBy(User voidedBy)`
`void`	`setPersonVoidReason(String voidReason)`
`String`	`toString()`

Methods inherited from class org.openmrs.BaseOpenmrsData
getChangedBy, getCreator, getDateChanged, getDateCreated, getDateVoided, getVoided, getVoidedBy, getVoidReason, isVoided, setChangedBy, setCreator, setDateChanged, setDateCreated, setDateVoided, setVoided, setVoidedBy, setVoidReason

Methods inherited from class org.openmrs.BaseOpenmrsObject
getUuid, setUuid

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openmrs.OpenmrsObject
getUuid, setUuid

- Field Detail
  - serialVersionUID
```
public static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - personId
```
protected Integer personId
```
- Constructor Detail
  - Person
```
public Person()
```
    default empty constructor
  - Person
```
public Person(Person person)
```
    This constructor is used to build a new Person object copy from another person object (usually a patient or a user subobject). All attributes are copied over to the new object. NOTE! All child collection objects are copied as pointers, each individual element is not copied.
    
    Parameters:
    
    person - Person to create this person object from
  - Person
```
public Person(Integer personId)
```
    Default constructor taking in the primary key personId value
    
    Parameters:
    
    personId - Integer internal id for this person
    
    Should:
    
    set person id
- Method Detail
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
    
    See Also:
    
    Object.equals(java.lang.Object)
    
    Should:
    
    equal person with same person id, not equal person with different person id, not equal on null, equal person objects with no person id, not equal person objects when one has null person id
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
    
    See Also:
    
    Object.hashCode()
    
    Should:
    
    have same hashcode when equal, have different hash code when not equal, get hash code with null attributes
  - getPersonId
```
public Integer getPersonId()
```
    Returns:
    
    Returns the personId.
  - setPersonId
```
public void setPersonId(Integer personId)
```
    Parameters:
    
    personId - The personId to set.
  - getGender
```
public String getGender()
```
    Returns:
    
    person's gender
  - setGender
```
public void setGender(String gender)
```
    Parameters:
    
    gender - person's gender
  - getBirthdate
```
public Date getBirthdate()
```
    Returns:
    
    person's date of birth
  - setBirthdate
```
public void setBirthdate(Date birthdate)
```
    Parameters:
    
    birthdate - person's date of birth
  - isBirthdateEstimated
```
public Boolean isBirthdateEstimated()
```
    Returns:
    
    true if person's birthdate is estimated
  - getBirthdateEstimated
```
public Boolean getBirthdateEstimated()
```
  - setBirthdateEstimated
```
public void setBirthdateEstimated(Boolean birthdateEstimated)
```
    Parameters:
    
    birthdateEstimated - true if person's birthdate is estimated
  - isDead
```
public Boolean isDead()
```
    Returns:
    
    Returns the death status.
  - getDead
```
public Boolean getDead()
```
    Returns:
    
    Returns the death status.
  - setDead
```
public void setDead(Boolean dead)
```
    Parameters:
    
    dead - The dead to set.
  - getDeathDate
```
public Date getDeathDate()
```
    Returns:
    
    date of person's death
  - setDeathDate
```
public void setDeathDate(Date deathDate)
```
    Parameters:
    
    deathDate - date of person's death
  - getCauseOfDeath
```
public Concept getCauseOfDeath()
```
    Returns:
    
    cause of person's death
  - setCauseOfDeath
```
public void setCauseOfDeath(Concept causeOfDeath)
```
    Parameters:
    
    causeOfDeath - cause of person's death
  - getAddresses
```
public Set<PersonAddress> getAddresses()
```
    Returns:
    
    list of known addresses for person
    
    See Also:
    
    PersonAddress
    
    Should:
    
    not get voided addresses, not fail with null addresses
  - setAddresses
```
public void setAddresses(Set<PersonAddress> addresses)
```
    Parameters:
    
    addresses - Set list of known addresses for person
    
    See Also:
    
    PersonAddress
  - getNames
```
public Set<PersonName> getNames()
```
    Returns:
    
    all known names for person
    
    See Also:
    
    PersonName
    
    Should:
    
    not get voided names, not fail with null names
  - setNames
```
public void setNames(Set<PersonName> names)
```
    Parameters:
    
    names - update all known names for person
    
    See Also:
    
    PersonName
  - getAttributes
```
public Set<PersonAttribute> getAttributes()
```
    Returns:
    
    all known attributes for person
    
    See Also:
    
    PersonAttribute
    
    Should:
    
    not get voided attributes, not fail with null attributes
  - getActiveAttributes
```
public List<PersonAttribute> getActiveAttributes()
```
    Returns only the non-voided attributes for this person
    
    Returns:
    
    list attributes
    
    Should:
    
    not get voided attributes, not fail with null attributes
  - setAttributes
```
public void setAttributes(Set<PersonAttribute> attributes)
```
    Parameters:
    
    attributes - update all known attributes for person
    
    See Also:
    
    PersonAttribute
  - addAttribute
```
public void addAttribute(PersonAttribute newAttribute)
```
    Convenience method to add the attribute to this person's attribute list if the attribute doesn't exist already.
    
    Voids any current attribute with type = newAttribute.getAttributeType()
    
    NOTE: This effectively limits persons to only one attribute of any given type **
    
    Parameters:
    
    newAttribute - PersonAttribute to add to the Person
    
    Should:
    
    fail when new attribute exist, fail when new atribute are the same type with same value, void old attribute when new attribute are the same type with different value, remove attribute when old attribute are temporary, not save an attribute with a null value, not save an attribute with a blank string value, void old attribute when a null or blank string value is added
  - removeAttribute
```
public void removeAttribute(PersonAttribute attribute)
```
    Convenience method to get the attribute from this person's attribute list if the attribute exists already.
    
    Parameters:
    
    attribute -
    
    Should:
    
    not fail when person attribute is null, not fail when person attribute is not exist, remove attribute when exist
  - getAttribute
```
public PersonAttribute getAttribute(PersonAttributeType pat)
```
    Convenience Method to return the first non-voided person attribute matching a person attribute type
    
    Parameters:
    
    pat -
    
    Returns:
    
    PersonAttribute
    
    Should:
    
    not fail when attribute type is null, not return voided attribute, return null when given attribute type is not exist
  - getAttribute
```
public PersonAttribute getAttribute(String attributeName)
```
    Convenience method to get this person's first attribute that has a PersonAttributeType.name equal to attributeName.
    
    Parameters:
    
    attributeName -
  - getAttribute
```
public PersonAttribute getAttribute(Integer attributeTypeId)
```
    Convenience method to get this person's first attribute that has a PersonAttributeTypeId equal to attributeTypeId.
    
    Parameters:
    
    attributeTypeId -
  - getAttributes
```
public List<PersonAttribute> getAttributes(String attributeName)
```
    Convenience method< to get all of this person's attributes that have a PersonAttributeType.name equal to attributeName.
    
    Parameters:
    
    attributeName -
  - getAttributes
```
public List<PersonAttribute> getAttributes(Integer attributeTypeId)
```
    Convenience method to get all of this person's attributes that have a PersonAttributeType.id equal to attributeTypeId.
    
    Parameters:
    
    attributeTypeId -
  - getAttributes
```
public List<PersonAttribute> getAttributes(PersonAttributeType personAttributeType)
```
    Convenience method to get all of this person's attributes that have a PersonAttributeType equal to personAttributeType.
    
    Parameters:
    
    personAttributeType -
  - getAttributeMap
```
public Map<String,PersonAttribute> getAttributeMap()
```
    Convenience method to get all of this person's attributes in map form: .
  - printAttributes
```
public String printAttributes()
```
    Convenience method for viewing all of the person's current attributes
    
    Returns:
    
    Returns a string with all the attributes
  - addName
```
public void addName(PersonName name)
```
    Convenience method to add the name to this person's name list if the name doesn't exist already.
    
    Parameters:
    
    name -
  - removeName
```
public void removeName(PersonName name)
```
    Convenience method remove the name from this person's name list if the name exists already.
    
    Parameters:
    
    name -
  - addAddress
```
public void addAddress(PersonAddress address)
```
    Convenience method to add the address to this person's address list if the address doesn't exist already.
    
    Parameters:
    
    address -
    
    Should:
    
    not add a person address with blank fields
  - removeAddress
```
public void removeAddress(PersonAddress address)
```
    Convenience method to remove the address from this person's address list if the address exists already.
    
    Parameters:
    
    address -
  - getPersonName
```
public PersonName getPersonName()
```
    Convenience method to get the "preferred" name for the person. Returns a blank PersonName object if no names are given.
    
    Returns:
    
    Returns the "preferred" person name.
  - getGivenName
```
public String getGivenName()
```
    Convenience method to get the given name attribute on this person's preferred PersonName
    
    Returns:
    
    String given name of the person
  - getMiddleName
```
public String getMiddleName()
```
    Convenience method to get the middle name attribute on this person's preferred PersonName
    
    Returns:
    
    String middle name of the person
  - getFamilyName
```
public String getFamilyName()
```
    Convenience method to get the family name attribute on this person's preferred PersonName
    
    Returns:
    
    String family name of the person
  - getPersonAddress
```
public PersonAddress getPersonAddress()
```
    Convenience Method to get the "preferred" address for person.
    
    Returns:
    
    Returns the "preferred" person address.
  - getAge
```
public Integer getAge()
```
    Convenience method to calculate this person's age based on the birthdate For a person who lived 1990 to 2000, age would be -5 in 1985, 5 in 1995, 10 in 2000, and 10 2010.
    
    Returns:
    
    Returns age as an Integer.
    
    Should:
    
    get correct age after death
  - getAge
```
public Integer getAge(Date onDate)
```
    Convenience method: calculates the person's age on a given date based on the birthdate
    
    Parameters:
    
    onDate - (null defaults to today)
    
    Returns:
    
    int value of the person's age
    
    Should:
    
    get age before birthday, get age on birthday with no minutes defined, get age on birthday with minutes defined, get age after birthday, get age after death, get age with given date after death, get age with given date before death, get age with given date before birth
  - setBirthdateFromAge
```
public void setBirthdateFromAge(int age,
                                Date ageOnDate)
```
    Convenience method: sets a person's birth date from an age as of the given date Also sets flag indicating that the birth date is inexact. This sets the person's birth date to January 1 of the year that matches this age and date
    
    Parameters:
    
    age - (the age to set)
    
    ageOnDate - (null defaults to today)
  - getPersonChangedBy
```
public User getPersonChangedBy()
```
  - setPersonChangedBy
```
public void setPersonChangedBy(User changedBy)
```
  - getPersonDateChanged
```
public Date getPersonDateChanged()
```
  - setPersonDateChanged
```
public void setPersonDateChanged(Date dateChanged)
```
  - getPersonCreator
```
public User getPersonCreator()
```
  - setPersonCreator
```
public void setPersonCreator(User creator)
```
  - getPersonDateCreated
```
public Date getPersonDateCreated()
```
  - setPersonDateCreated
```
public void setPersonDateCreated(Date dateCreated)
```
  - getPersonDateVoided
```
public Date getPersonDateVoided()
```
  - setPersonDateVoided
```
public void setPersonDateVoided(Date dateVoided)
```
  - setPersonVoided
```
public void setPersonVoided(Boolean voided)
```
  - getPersonVoided
```
public Boolean getPersonVoided()
```
  - isPersonVoided
```
public Boolean isPersonVoided()
```
  - getPersonVoidedBy
```
public User getPersonVoidedBy()
```
  - setPersonVoidedBy
```
public void setPersonVoidedBy(User voidedBy)
```
  - getPersonVoidReason
```
public String getPersonVoidReason()
```
  - setPersonVoidReason
```
public void setPersonVoidReason(String voidReason)
```
  - isPatient
```
public boolean isPatient()
```
    Returns:
    
    true/false whether this person is a patient or not
  - isUser
```
public boolean isUser()
```
    Deprecated. use UserService.getUsersByPerson(Person, boolean)
    
    Returns:
    
    true/false whether this person is a user or not
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
    
    See Also:
    
    Object.toString()
  - replaceSerialization
```
public Person replaceSerialization(Map<?,?> sessionMap)
```
    If the serializer wishes, don't serialize this entire object, just the important parts
    
    Parameters:
    
    sessionMap - serialization session information
    
    Returns:
    
    Person object to serialize
    
    See Also:
    
    OpenmrsUtil.isShortSerialization(Map)
  - getId
```
public Integer getId()
```
    Specified by:
    
    getId in interface OpenmrsObject
    
    Returns:
    
    id - The unique Identifier for the object
    
    Since:
    
    1.5
    
    See Also:
    
    OpenmrsObject.getId()
  - setId
```
public void setId(Integer id)
```
    Specified by:
    
    setId in interface OpenmrsObject
    
    Parameters:
    
    id - - The unique Identifier for the object
    
    Since:
    
    1.5
    
    See Also:
    
    OpenmrsObject.setId(java.lang.Integer)

Class Person

Field Summary

Fields inherited from class org.openmrs.BaseOpenmrsData

Constructor Summary

Method Summary

Methods inherited from class org.openmrs.BaseOpenmrsData

Methods inherited from class org.openmrs.BaseOpenmrsObject

Methods inherited from class java.lang.Object

Methods inherited from interface org.openmrs.OpenmrsObject

Field Detail

serialVersionUID

personId

Constructor Detail

Person

Person

Person

Method Detail

equals

hashCode

getPersonId

setPersonId

getGender

setGender

getBirthdate

setBirthdate

isBirthdateEstimated

getBirthdateEstimated

setBirthdateEstimated

isDead

getDead

setDead

getDeathDate

setDeathDate

getCauseOfDeath

setCauseOfDeath

getAddresses

setAddresses

getNames

setNames

getAttributes

getActiveAttributes

setAttributes

addAttribute

removeAttribute

getAttribute

getAttribute

getAttribute

getAttributes

getAttributes

getAttributes

getAttributeMap

printAttributes

addName

removeName

addAddress

removeAddress

getPersonName

getGivenName

getMiddleName

getFamilyName

getPersonAddress

getAge

getAge

setBirthdateFromAge

getPersonChangedBy

setPersonChangedBy

getPersonDateChanged

setPersonDateChanged

getPersonCreator

setPersonCreator

getPersonDateCreated

setPersonDateCreated

getPersonDateVoided

setPersonDateVoided

setPersonVoided

getPersonVoided

isPersonVoided

getPersonVoidedBy

setPersonVoidedBy

getPersonVoidReason