org.openmrs

Class Patient

java.lang.Object

org.openmrs.BaseOpenmrsObject

org.openmrs.BaseOpenmrsData

org.openmrs.BaseChangeableOpenmrsData

org.openmrs.Person

org.openmrs.Patient

All Implemented Interfaces:

Serializable, Auditable, Changeable, Creatable, OpenmrsData, OpenmrsObject, Voidable

public class Patient
extends Person

Defines a Patient in the system. A patient is simply an extension of a person and all that that implies.

Version:

2.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID

Fields inherited from class org.openmrs.Person

personId

Fields inherited from class org.openmrs.BaseOpenmrsData

creator

Constructor Summary

Constructors

Constructor and Description
Patient() default constructor
Patient(Integer patientId) Constructor with default patient id
Patient(Patient patient) This constructor creates a new Patient object from the given Patient object.
Patient(Person person) This constructor creates a new Patient object from the given Person object.

Method Summary

Modifier and Type	Method and Description
void	addIdentifier(PatientIdentifier patientIdentifier) Will add this PatientIdentifier if the patient doesn't contain it already
void	addIdentifiers(Collection<PatientIdentifier> patientIdentifiers) Will only add PatientIdentifiers in this list that this patient does not have already
List<PatientIdentifier>	getActiveIdentifiers() Returns only the non-voided identifiers for this patient.
String	getAllergyStatus() Returns allergy status maintained by the supporting infrastructure.
Integer	getId()
Set<PatientIdentifier>	getIdentifiers() Get all of this patients identifiers -- both voided and non-voided ones.
Integer	getPatientId()
PatientIdentifier	getPatientIdentifier() Convenience method to get the first "preferred" identifier for a patient.
PatientIdentifier	getPatientIdentifier(Integer identifierTypeId) Returns the first (preferred) patient identifier matching identifierTypeId
PatientIdentifier	getPatientIdentifier(PatientIdentifierType pit) Returns the first (preferred) patient identifier matching a PatientIdentifierType Otherwise, returns the first non-voided identifier Otherwise, null
PatientIdentifier	getPatientIdentifier(String identifierTypeName) Returns the (preferred) patient identifier matching identifierTypeName Otherwise returns that last PatientIdenitifer
List<PatientIdentifier>	getPatientIdentifiers(PatientIdentifierType pit) Returns only the non-voided identifiers for this patient.
Person	getPerson() Returns the person represented
void	removeIdentifier(PatientIdentifier patientIdentifier) Convenience method to remove the given identifier from this patient's list of identifiers.
void	setAllergyStatus(String allergyStatus) Sets the allergy status for a patient.
void	setId(Integer id)
void	setIdentifiers(Set<PatientIdentifier> identifiers) Update all identifiers for patient
void	setPatientId(Integer patientId) Sets the internal identifier for a patient.
void	setPersonId(Integer personId) Overrides the parent setPersonId(Integer) so that we can be sure patient id is also set correctly.
String	toString() Returns a string equal to the value of: ClassName{hashCode=..., uuid=...}

Methods inherited from class org.openmrs.Person

addAddress, addAttribute, addName, getActiveAttributes, getAddresses, getAge, getAge, getAllAttributeMap, getAttribute, getAttribute, getAttribute, getAttributeMap, getAttributes, getAttributes, getAttributes, getAttributes, getBirthdate, getBirthdateEstimated, getBirthDateTime, getBirthtime, getCauseOfDeath, getCauseOfDeathNonCoded, getDead, getDeathDate, getDeathdateEstimated, getFamilyName, getGender, getGivenName, getIsPatient, getMiddleName, getNames, getPersonAddress, getPersonChangedBy, getPersonCreator, getPersonDateChanged, getPersonDateCreated, getPersonDateVoided, getPersonId, getPersonName, getPersonVoided, getPersonVoidedBy, getPersonVoidReason, isBirthdateEstimated, isDead, isPatient, isPersonVoided, printAttributes, removeAddress, removeAttribute, removeName, setAddresses, setAttributes, setBirthdate, setBirthdateEstimated, setBirthdateFromAge, setBirthtime, setCauseOfDeath, setCauseOfDeathNonCoded, setDead, setDeathDate, setDeathdateEstimated, setGender, setNames, setPatient, setPersonChangedBy, setPersonCreator, setPersonDateChanged, setPersonDateCreated, setPersonDateVoided, setPersonVoided, setPersonVoidedBy, setPersonVoidReason

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

Constructor Detail

Patient

public Patient()

default constructor

Patient

public Patient(Person person)

This constructor creates a new Patient object from the given Person object. 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 - the person object to copy onto a new Patient

See Also:

Person(Person)

Patient

public Patient(Integer patientId)

Constructor with default patient id

Parameters:

patientId -

Patient

public Patient(Patient patient)

This constructor creates a new Patient object from the given Patient object. All attributes are copied over to the new object. In effect creating a clone/duplicate.

Parameters:

patient - the person object to copy onto a new Patient

Since:

2.2.0

Method Detail

getPatientId

public Integer getPatientId()

Returns:

internal identifier for patient

setPatientId

public void setPatientId(Integer patientId)

Sets the internal identifier for a patient. This should never be called directly. It exists only for the use of the supporting infrastructure.

Parameters:

patientId -

getAllergyStatus

public String getAllergyStatus()

Returns allergy status maintained by the supporting infrastructure.

Returns:

current allargy status for patient

Since:

2.0 Should return allergy status maintained by the supporting infrastructure

setAllergyStatus

public void setAllergyStatus(String allergyStatus)

Sets the allergy status for a patient. This should never be called directly. It should reflect allergy status maintained by the supporting infrastructure.

Parameters:

allergyStatus -

Since:

2.0 Should not be called by service client

setPersonId

public void setPersonId(Integer personId)

Overrides the parent setPersonId(Integer) so that we can be sure patient id is also set correctly.

Overrides:

setPersonId in class Person

Parameters:

personId - The personId to set.

See Also:

Person.setPersonId(java.lang.Integer)

getIdentifiers

public Set<PatientIdentifier> getIdentifiers()

Get all of this patients identifiers -- both voided and non-voided ones. If you want only non-voided identifiers, use getActiveIdentifiers()

Returns:

Set of all known identifiers for this patient

See Also:

PatientIdentifier, Should not return null

setIdentifiers

public void setIdentifiers(Set<PatientIdentifier> identifiers)

Update all identifiers for patient

Parameters:

identifiers - Set<PatientIdentifier> to set as update all known identifiers for patient

See Also:

PatientIdentifier

addIdentifiers

public void addIdentifiers(Collection<PatientIdentifier> patientIdentifiers)

Will only add PatientIdentifiers in this list that this patient does not have already

Parameters:

patientIdentifiers -

addIdentifier

public void addIdentifier(PatientIdentifier patientIdentifier)

Will add this PatientIdentifier if the patient doesn't contain it already

Parameters:

patientIdentifier - Should not fail with null identifiers list Should add identifier to current list Should not add identifier that is in list already

removeIdentifier

public void removeIdentifier(PatientIdentifier patientIdentifier)

Convenience method to remove the given identifier from this patient's list of identifiers. If patientIdentifier is null, nothing is done.

Parameters:

patientIdentifier - the identifier to remove Should remove identifier if exists

getPatientIdentifier

public PatientIdentifier getPatientIdentifier()

Convenience method to get the first "preferred" identifier for a patient. Otherwise, returns the first non-voided identifier Otherwise, null

Returns:

Returns the "preferred" patient identifier.

getPatientIdentifier

public PatientIdentifier getPatientIdentifier(PatientIdentifierType pit)

Returns the first (preferred) patient identifier matching a PatientIdentifierType Otherwise, returns the first non-voided identifier Otherwise, null

Parameters:

pit - The PatientIdentifierType of which to return the PatientIdentifier

Returns:

Returns a PatientIdentifier of the specified type.

getPatientIdentifier

public PatientIdentifier getPatientIdentifier(Integer identifierTypeId)

Returns the first (preferred) patient identifier matching identifierTypeId

Parameters:

identifierTypeId -

Returns:

preferred patient identifier

getPatientIdentifier

public PatientIdentifier getPatientIdentifier(String identifierTypeName)

Returns the (preferred) patient identifier matching identifierTypeName Otherwise returns that last PatientIdenitifer

Parameters:

identifierTypeName -

Returns:

preferred patient identifier

getActiveIdentifiers

public List<PatientIdentifier> getActiveIdentifiers()

Returns only the non-voided identifiers for this patient. If you want all identifiers, use getIdentifiers()

Returns:

list of non-voided identifiers for this patient

See Also:

Should return preferred identifiers first in the list

getPatientIdentifiers

public List<PatientIdentifier> getPatientIdentifiers(PatientIdentifierType pit)

Returns only the non-voided identifiers for this patient. If you want all identifiers, use getIdentifiers()

Parameters:

pit - PatientIdentifierType

Returns:

list of non-voided identifiers for this patient

See Also:

getIdentifiers()

toString

public String toString()

Description copied from class: BaseOpenmrsObject

Returns a string equal to the value of:

ClassName{hashCode=..., uuid=...}

If the uuid field is null, it returns:

ClassName{hashCode=...}

Should include hashCode if uuid is null Should include uuid if not null

Overrides:

toString in class Person

See Also:

Object.toString()

getId

public Integer getId()

Specified by:

getId in interface OpenmrsObject

Overrides:

getId in class Person

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

Overrides:

setId in class Person

Parameters:

id - - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.setId(java.lang.Integer)

getPerson

public Person getPerson()

Returns the person represented

Returns:

the person represented by this object

Since:

1.10.0