Person (OpenMRS 1.10.7-SNAPSHOT API)

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

All Implemented Interfaces:

java.io.Serializable, Auditable, OpenmrsData, OpenmrsObject, Voidable

Direct Known Subclasses:

Patient
```
public class Person
extends BaseOpenmrsData
implements java.io.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 java.lang.Integer personId

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

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

Constructor Summary

Constructors
Constructor and Description
`Person()` default empty constructor
`Person(java.lang.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.
`java.util.List<PersonAttribute>`	`getActiveAttributes()` Returns only the non-voided attributes for this person
`java.util.Set<PersonAddress>`	`getAddresses()`
`java.lang.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.
`java.lang.Integer`	`getAge(java.util.Date onDate)` Convenience method: calculates the person's age on a given date based on the birthdate
`PersonAttribute`	`getAttribute(java.lang.Integer attributeTypeId)` Convenience method to get this person's first attribute that has a PersonAttributeTypeId equal to `attributeTypeId`. Returns null if this person has no non-voided `PersonAttribute` with the given type id or this person has no attributes. The given id cannot be null.
`PersonAttribute`	`getAttribute(PersonAttributeType pat)` Convenience Method to return the first non-voided person attribute matching a person attribute type.
`PersonAttribute`	`getAttribute(java.lang.String attributeName)` Convenience method to get this person's first attribute that has a PersonAttributeType.name equal to `attributeName`. Returns null if this person has no non-voided `PersonAttribute` with the given type name, the given name is null, or this person has no attributes.
`java.util.Map<java.lang.String,PersonAttribute>`	`getAttributeMap()` Convenience method to get all of this person's attributes in map form: .
`java.util.Set<PersonAttribute>`	`getAttributes()`
`java.util.List<PersonAttribute>`	`getAttributes(java.lang.Integer attributeTypeId)` Convenience method to get all of this person's attributes that have a PersonAttributeType.id equal to `attributeTypeId`.
`java.util.List<PersonAttribute>`	`getAttributes(PersonAttributeType personAttributeType)` Convenience method to get all of this person's attributes that have a PersonAttributeType equal to `personAttributeType`.
`java.util.List<PersonAttribute>`	`getAttributes(java.lang.String attributeName)` Convenience method< to get all of this person's attributes that have a PersonAttributeType.name equal to `attributeName`.
`java.util.Date`	`getBirthdate()`
`java.lang.Boolean`	`getBirthdateEstimated()`
`java.util.Date`	`getBirthDateTime()`
`java.util.Date`	`getBirthtime()`
`Concept`	`getCauseOfDeath()`
`java.lang.Boolean`	`getDead()`
`java.util.Date`	`getDeathDate()`
`java.lang.String`	`getFamilyName()` Convenience method to get the family name attribute on this person's preferred PersonName
`java.lang.String`	`getGender()`
`java.lang.String`	`getGivenName()` Convenience method to get the given name attribute on this person's preferred PersonName
`java.lang.Integer`	`getId()`
`boolean`	`getIsPatient()`
`java.lang.String`	`getMiddleName()` Convenience method to get the middle name attribute on this person's preferred PersonName
`java.util.Set<PersonName>`	`getNames()`
`PersonAddress`	`getPersonAddress()` Convenience method to get the `PersonAddress` object that is marked as "preferred".
`User`	`getPersonChangedBy()`
`User`	`getPersonCreator()`
`java.util.Date`	`getPersonDateChanged()`
`java.util.Date`	`getPersonDateCreated()`
`java.util.Date`	`getPersonDateVoided()`
`java.lang.Integer`	`getPersonId()`
`PersonName`	`getPersonName()` Convenience method to get the `PersonName` object that is marked as "preferred".
`java.lang.Boolean`	`getPersonVoided()`
`User`	`getPersonVoidedBy()`
`java.lang.String`	`getPersonVoidReason()`
`java.lang.Boolean`	`isBirthdateEstimated()`
`java.lang.Boolean`	`isDead()`
`boolean`	`isPatient()`
`java.lang.Boolean`	`isPersonVoided()`
`boolean`	`isUser()` Deprecated. use `UserService.getUsersByPerson(Person, boolean)`
`java.lang.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(java.util.Map<?,?> sessionMap)` If the serializer wishes, don't serialize this entire object, just the important parts
`void`	`setAddresses(java.util.Set<PersonAddress> addresses)`
`void`	`setAttributes(java.util.Set<PersonAttribute> attributes)`
`void`	`setBirthdate(java.util.Date birthdate)`
`void`	`setBirthdateEstimated(java.lang.Boolean birthdateEstimated)`
`void`	`setBirthdateFromAge(int age, java.util.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`	`setBirthtime(java.util.Date birthtime)`
`void`	`setCauseOfDeath(Concept causeOfDeath)`
`void`	`setDead(java.lang.Boolean dead)`
`void`	`setDeathDate(java.util.Date deathDate)`
`void`	`setGender(java.lang.String gender)`
`void`	`setId(java.lang.Integer id)`
`void`	`setNames(java.util.Set<PersonName> names)`
`void`	`setPersonChangedBy(User changedBy)`
`void`	`setPersonCreator(User creator)`
`void`	`setPersonDateChanged(java.util.Date dateChanged)`
`void`	`setPersonDateCreated(java.util.Date dateCreated)`
`void`	`setPersonDateVoided(java.util.Date dateVoided)`
`void`	`setPersonId(java.lang.Integer personId)`
`void`	`setPersonVoided(java.lang.Boolean voided)`
`void`	`setPersonVoidedBy(User voidedBy)`
`void`	`setPersonVoidReason(java.lang.String voidReason)`
`java.lang.String`	`toString()` Returns a string consisting of the name of the class of which the object is an instance and the `uuid` field surrounded by `[` and `]`.

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
equals, getUuid, hashCode, 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 java.lang.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(java.lang.Integer personId)
```
    Default constructor taking in the primary key personId value
    
    Parameters:
    
    personId - Integer internal id for this person
- Method Detail
  - getPersonId
```
public java.lang.Integer getPersonId()
```
    Returns:
    
    Returns the personId.
  - setPersonId
```
public void setPersonId(java.lang.Integer personId)
```
    Parameters:
    
    personId - The personId to set.
  - getGender
```
public java.lang.String getGender()
```
    Returns:
    
    person's gender
  - setGender
```
public void setGender(java.lang.String gender)
```
    Parameters:
    
    gender - person's gender
  - getBirthdate
```
public java.util.Date getBirthdate()
```
    Returns:
    
    person's date of birth
  - setBirthdate
```
public void setBirthdate(java.util.Date birthdate)
```
    Parameters:
    
    birthdate - person's date of birth
  - isBirthdateEstimated
```
public java.lang.Boolean isBirthdateEstimated()
```
    Returns:
    
    true if person's birthdate is estimated
  - getBirthdateEstimated
```
public java.lang.Boolean getBirthdateEstimated()
```
  - setBirthdateEstimated
```
public void setBirthdateEstimated(java.lang.Boolean birthdateEstimated)
```
    Parameters:
    
    birthdateEstimated - true if person's birthdate is estimated
  - setBirthtime
```
public void setBirthtime(java.util.Date birthtime)
```
    Parameters:
    
    birthtime - person's time of birth
  - getBirthDateTime
```
public java.util.Date getBirthDateTime()
```
    Returns:
    
    person's time of birth with the date portion set to the date from person's birthdate
  - getBirthtime
```
public java.util.Date getBirthtime()
```
    Returns:
    
    person's time of birth.
  - isDead
```
public java.lang.Boolean isDead()
```
    Returns:
    
    Returns the death status.
  - getDead
```
public java.lang.Boolean getDead()
```
    Returns:
    
    Returns the death status.
  - setDead
```
public void setDead(java.lang.Boolean dead)
```
    Parameters:
    
    dead - The dead to set.
  - getDeathDate
```
public java.util.Date getDeathDate()
```
    Returns:
    
    date of person's death
  - setDeathDate
```
public void setDeathDate(java.util.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 java.util.Set<PersonAddress> getAddresses()
```
    Returns:
    
    list of known addresses for person
    
    See Also:
    
    PersonAddress
  - setAddresses
```
public void setAddresses(java.util.Set<PersonAddress> addresses)
```
    Parameters:
    
    addresses - Set list of known addresses for person
    
    See Also:
    
    PersonAddress
  - getNames
```
public java.util.Set<PersonName> getNames()
```
    Returns:
    
    all known names for person
    
    See Also:
    
    PersonName
  - setNames
```
public void setNames(java.util.Set<PersonName> names)
```
    Parameters:
    
    names - update all known names for person
    
    See Also:
    
    PersonName
  - getAttributes
```
public java.util.Set<PersonAttribute> getAttributes()
```
    Returns:
    
    all known attributes for person
    
    See Also:
    
    PersonAttribute
  - getActiveAttributes
```
public java.util.List<PersonAttribute> getActiveAttributes()
```
    Returns only the non-voided attributes for this person
    
    Returns:
    
    list attributes
  - setAttributes
```
public void setAttributes(java.util.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
  - 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 -
  - getAttribute
```
public PersonAttribute getAttribute(PersonAttributeType pat)
```
    Convenience Method to return the first non-voided person attribute matching a person attribute type.
    
    Returns null if this person has no non-voided PersonAttribute with the given PersonAttributeType, the given PersonAttributeType is null, or this person has no attributes.
    
    Parameters:
    
    pat - the PersonAttributeType to look for (can be a stub, see BaseOpenmrsObject.equals(Object) for how its compared)
    
    Returns:
    
    PersonAttribute that matches the given type
  - getAttribute
```
public PersonAttribute getAttribute(java.lang.String attributeName)
```
    Convenience method to get this person's first attribute that has a PersonAttributeType.name equal to attributeName.
    
    Returns null if this person has no non-voided PersonAttribute with the given type name, the given name is null, or this person has no attributes.
    
    Parameters:
    
    attributeName - the name string to match on
    
    Returns:
    
    PersonAttribute whose BaseOpenmrsMetadata.getName() matchs the given name string
  - getAttribute
```
public PersonAttribute getAttribute(java.lang.Integer attributeTypeId)
```
    Convenience method to get this person's first attribute that has a PersonAttributeTypeId equal to attributeTypeId.
    
    Returns null if this person has no non-voided PersonAttribute with the given type id or this person has no attributes.
    
    The given id cannot be null.
    
    Parameters:
    
    attributeTypeId - the id of the PersonAttributeType to look for
    
    Returns:
    
    PersonAttribute whose PersonAttributeType.getId() equals the given Integer id
  - getAttributes
```
public java.util.List<PersonAttribute> getAttributes(java.lang.String attributeName)
```
    Convenience method< to get all of this person's attributes that have a PersonAttributeType.name equal to attributeName.
    
    Parameters:
    
    attributeName -
  - getAttributes
```
public java.util.List<PersonAttribute> getAttributes(java.lang.Integer attributeTypeId)
```
    Convenience method to get all of this person's attributes that have a PersonAttributeType.id equal to attributeTypeId.
    
    Parameters:
    
    attributeTypeId -
  - getAttributes
```
public java.util.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 java.util.Map<java.lang.String,PersonAttribute> getAttributeMap()
```
    Convenience method to get all of this person's attributes in map form: .
  - printAttributes
```
public java.lang.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 -
  - 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 PersonName object that is marked as "preferred".
    
    If two names are marked as preferred (or no names), the database ordering comes into effect and the one that was created most recently will be returned.
    
    This method will never return a voided name, even if it is marked as preferred.
    
    Null is returned if this person has no names or all voided names.
    
    Returns:
    
    the "preferred" person name.
    
    See Also:
    
    getNames(), PersonName.isPreferred()
  - getGivenName
```
public java.lang.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 java.lang.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 java.lang.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 PersonAddress object that is marked as "preferred".
    
    If two addresses are marked as preferred (or no addresses), the database ordering comes into effect and the one that was created most recently will be returned.
    
    This method will never return a voided address, even if it is marked as preferred.
    
    Null is returned if this person has no addresses or all voided addresses.
    
    Returns:
    
    the "preferred" person address.
    
    See Also:
    
    getAddresses(), PersonAddress.isPreferred()
  - getAge
```
public java.lang.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.
  - getAge
```
public java.lang.Integer getAge(java.util.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
  - setBirthdateFromAge
```
public void setBirthdateFromAge(int age,
                                java.util.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 java.util.Date getPersonDateChanged()
```
  - setPersonDateChanged
```
public void setPersonDateChanged(java.util.Date dateChanged)
```
  - getPersonCreator
```
public User getPersonCreator()
```
  - setPersonCreator
```
public void setPersonCreator(User creator)
```
  - getPersonDateCreated
```
public java.util.Date getPersonDateCreated()
```
  - setPersonDateCreated
```
public void setPersonDateCreated(java.util.Date dateCreated)
```
  - getPersonDateVoided
```
public java.util.Date getPersonDateVoided()
```
  - setPersonDateVoided
```
public void setPersonDateVoided(java.util.Date dateVoided)
```
  - setPersonVoided
```
public void setPersonVoided(java.lang.Boolean voided)
```
  - getPersonVoided
```
public java.lang.Boolean getPersonVoided()
```
  - isPersonVoided
```
public java.lang.Boolean isPersonVoided()
```
  - getPersonVoidedBy
```
public User getPersonVoidedBy()
```
  - setPersonVoidedBy
```
public void setPersonVoidedBy(User voidedBy)
```
  - getPersonVoidReason
```
public java.lang.String getPersonVoidReason()
```
  - setPersonVoidReason
```
public void setPersonVoidReason(java.lang.String voidReason)
```
  - isPatient
```
public boolean isPatient()
```
    Returns:
    
    true/false whether this person is a patient or not
  - getIsPatient
```
public boolean getIsPatient()
```
  - isUser
```
public boolean isUser()
```
    Deprecated. use UserService.getUsersByPerson(Person, boolean)
    
    Returns:
    
    true/false whether this person is a user or not
  - toString
```
public java.lang.String toString()
```
    Description copied from class: BaseOpenmrsObject
    Returns a string consisting of the name of the class of which the object is an instance and the uuid field surrounded by [ and ]. In other words, this method returns a string equal to the value of:
    getClass().getName() + '[' + uuid + ']'
    If the uuid field is null, it delegates to Object.toString()
    Overrides:
    
    toString in class BaseOpenmrsObject
    
    See Also:
    
    Object.toString()
  - replaceSerialization
```
public Person replaceSerialization(java.util.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 java.lang.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(java.lang.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

getPersonId

setPersonId

getGender

setGender

getBirthdate

setBirthdate

isBirthdateEstimated

getBirthdateEstimated

setBirthdateEstimated

setBirthtime

getBirthDateTime

getBirthtime

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