org.openmrs

Class PatientProgram

java.lang.Object

org.openmrs.BaseOpenmrsObject

org.openmrs.BaseOpenmrsData

org.openmrs.PatientProgram

All Implemented Interfaces:

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

public class PatientProgram
extends BaseOpenmrsData
implements java.io.Serializable

PatientProgram

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID

Fields inherited from class org.openmrs.BaseOpenmrsData

creator

Constructor Summary

Constructors

Constructor and Description
PatientProgram() Default Constructor
PatientProgram(java.lang.Integer patientProgramId) Constructor with id

Method Summary

Modifier and Type	Method and Description
PatientProgram	copy() Does a mostly-shallow copy of this PatientProgram.
protected PatientProgram	copyHelper(PatientProgram target) The purpose of this method is to allow subclasses of PatientProgram to delegate a portion of their copy() method back to the superclass, in case the base class implementation changes.
boolean	getActive() Returns true if the associated Patient is currently enrolled in the associated Program
boolean	getActive(java.util.Date onDate) Returns true if the associated Patient is enrolled in the associated Program on the passed Date
PatientState	getCurrentState() Deprecated. use getCurrentState(ProgramWorkflow)
PatientState	getCurrentState(ProgramWorkflow programWorkflow) Returns the current PatientState for the passed ProgramWorkflow within this PatientProgram.
java.util.Set<PatientState>	getCurrentStates() Returns a Set of all current PatientStates for the PatientProgram
java.util.Date	getDateCompleted()
java.util.Date	getDateEnrolled()
java.lang.Integer	getId()
Location	getLocation()
Concept	getOutcome()
Patient	getPatient()
java.lang.Integer	getPatientProgramId()
PatientState	getPatientState(java.lang.Integer patientStateId) Returns the PatientState associated with this PatientProgram that has an id that matches the passed patientStateId
Program	getProgram()
java.util.Set<PatientState>	getStates()
void	setDateCompleted(java.util.Date dateCompleted)
void	setDateEnrolled(java.util.Date dateEnrolled)
void	setId(java.lang.Integer id)
void	setLocation(Location location)
void	setOutcome(Concept concept)
void	setPatient(Patient patient)
void	setPatientProgramId(java.lang.Integer patientProgramId)
void	setProgram(Program program)
void	setStates(java.util.Set<PatientState> states)
java.util.List<PatientState>	statesInWorkflow(ProgramWorkflow programWorkflow, boolean includeVoided) Returns a List of all PatientStates in the passed ProgramWorkflow for the PatientProgram
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 ].
void	transitionToState(ProgramWorkflowState programWorkflowState, java.util.Date onDate) Attempts to transition the PatientProgram to the passed ProgramWorkflowState on the passed Date by ending the most recent PatientState in the PatientProgram and creating a new one with the passed ProgramWorkflowState This will throw an IllegalArgumentException if the transition is invalid
void	voidLastState(ProgramWorkflow workflow, User voidBy, java.util.Date voidDate, java.lang.String voidReason) Attempts to void the latest PatientState in the PatientProgram If earlier PatientStates exist, it will try to reset the endDate to null so that the next latest state becomes the current PatientState

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

PatientProgram

public PatientProgram()

Default Constructor

PatientProgram

public PatientProgram(java.lang.Integer patientProgramId)

Constructor with id

Method Detail

copy

public PatientProgram copy()

Does a mostly-shallow copy of this PatientProgram. Does not copy patientProgramId. The 'states' property will be deep-copied.

Returns:

a shallow copy of this PatientProgram

copyHelper

protected PatientProgram copyHelper(PatientProgram target)

The purpose of this method is to allow subclasses of PatientProgram to delegate a portion of their copy() method back to the superclass, in case the base class implementation changes.

Parameters:

target - a PatientProgram that will have the state of this copied into it

Returns:

the PatientProgram that was passed in, with state copied into it

getActive

public boolean getActive(java.util.Date onDate)

Returns true if the associated Patient is enrolled in the associated Program on the passed Date

Parameters:

onDate - - Date to check for PatientProgram enrollment

Returns:

boolean - true if the associated Patient is enrolled in the associated Program on the passed Date

getActive

public boolean getActive()

Returns true if the associated Patient is currently enrolled in the associated Program

Returns:

boolean - true if the associated Patient is currently enrolled in the associated Program

getPatientState

public PatientState getPatientState(java.lang.Integer patientStateId)

Returns the PatientState associated with this PatientProgram that has an id that matches the passed patientStateId

Parameters:

patientStateId - - The identifier to use to lookup a PatientState

Returns:

PatientState that has an id that matches the passed patientStateId

transitionToState

public void transitionToState(ProgramWorkflowState programWorkflowState,
                              java.util.Date onDate)

Attempts to transition the PatientProgram to the passed ProgramWorkflowState on the passed Date by ending the most recent PatientState in the PatientProgram and creating a new one with the passed ProgramWorkflowState This will throw an IllegalArgumentException if the transition is invalid

Parameters:

programWorkflowState - - The ProgramWorkflowState to transition to

onDate - - The Date of the transition

Throws:

java.lang.IllegalArgumentException

voidLastState

public void voidLastState(ProgramWorkflow workflow,
                          User voidBy,
                          java.util.Date voidDate,
                          java.lang.String voidReason)

Attempts to void the latest PatientState in the PatientProgram If earlier PatientStates exist, it will try to reset the endDate to null so that the next latest state becomes the current PatientState

Parameters:

workflow - - The ProgramWorkflow whose last PatientState within the current PatientProgram we want to void

voidBy - - The user who is voiding the PatientState

voidDate - - The date to void the PatientState

voidReason - - The reason for voiding the PatientState

getCurrentState

public PatientState getCurrentState(ProgramWorkflow programWorkflow)

Returns the current PatientState for the passed ProgramWorkflow within this PatientProgram.

Parameters:

programWorkflow - The ProgramWorkflow whose current PatientState we want to retrieve

Returns:

PatientState The current PatientState for the passed ProgramWorkflow within this PatientProgram

getCurrentState

public PatientState getCurrentState()

Deprecated. use getCurrentState(ProgramWorkflow)

getCurrentStates

public java.util.Set<PatientState> getCurrentStates()

Returns a Set of all current PatientStates for the PatientProgram

Returns:

Set of all current PatientStates for the PatientProgram

statesInWorkflow

public java.util.List<PatientState> statesInWorkflow(ProgramWorkflow programWorkflow,
                                                     boolean includeVoided)

Returns a List of all PatientStates in the passed ProgramWorkflow for the PatientProgram

Parameters:

programWorkflow - - The ProgramWorkflow to check

includeVoided - - If true, return voided PatientStates in the returned List

Returns:

List of all PatientStates in the passed ProgramWorkflow for the PatientProgram

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()

getOutcome

public Concept getOutcome()

setOutcome

public void setOutcome(Concept concept)

getDateCompleted

public java.util.Date getDateCompleted()

setDateCompleted

public void setDateCompleted(java.util.Date dateCompleted)

getDateEnrolled

public java.util.Date getDateEnrolled()

setDateEnrolled

public void setDateEnrolled(java.util.Date dateEnrolled)

getPatient

public Patient getPatient()

setPatient

public void setPatient(Patient patient)

getPatientProgramId

public java.lang.Integer getPatientProgramId()

setPatientProgramId

public void setPatientProgramId(java.lang.Integer patientProgramId)

getProgram

public Program getProgram()

setProgram

public void setProgram(Program program)

getStates

public java.util.Set<PatientState> getStates()

setStates

public void setStates(java.util.Set<PatientState> states)

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)

getLocation

public Location getLocation()

Returns:

the location

Since:

1.8

setLocation

public void setLocation(Location location)

Parameters:

location - the location to set

Since:

1.8