org.openmrs.api.db.hibernate

Class HibernateProgramWorkflowDAO

java.lang.Object

org.openmrs.api.db.hibernate.HibernateProgramWorkflowDAO

All Implemented Interfaces:

ProgramWorkflowDAO

public class HibernateProgramWorkflowDAO
extends Object
implements ProgramWorkflowDAO

Hibernate specific ProgramWorkflow related functions.

This class should not be used directly. All calls should go through the ProgramWorkflowService methods.

See Also:

ProgramWorkflowDAO, ProgramWorkflowService

Constructor Summary

Constructors

Constructor and Description
HibernateProgramWorkflowDAO()

Method Summary

Modifier and Type	Method and Description
void	deleteConceptStateConversion(ConceptStateConversion csc) Completely remove a conceptStateConversion from the database (not reversible)
void	deletePatientProgram(PatientProgram patientProgram) Completely remove a patientProgram from the database (not reversible) This method delegates to #purgePatientProgram(patientProgram, boolean) method
void	deleteProgram(Program program) Completely remove a program from the database (not reversible) This method delegates to #purgeProgram(program, boolean) method
List<Program>	findPrograms(String nameFragment) Returns programs that match the given string.
List<ConceptStateConversion>	getAllConceptStateConversions() Returns all conceptStateConversions
List<ProgramAttributeType>	getAllProgramAttributeTypes()
List<Program>	getAllPrograms(boolean includeRetired) Returns all programs
ConceptStateConversion	getConceptStateConversion(Integer conceptStateConversionId) Returns a conceptStateConversion given that conceptStateConversions primary key conceptStateConversionId A null value is returned if no conceptStateConversion exists with this conceptStateConversionId.
ConceptStateConversion	getConceptStateConversion(ProgramWorkflow workflow, Concept trigger) Retrieves the ConceptStateConversion that matches the passed ProgramWorkflow and Concept
ConceptStateConversion	getConceptStateConversionByUuid(String uuid)
PatientProgram	getPatientProgram(Integer patientProgramId) Returns a PatientProgram given that PatientPrograms primary key patientProgramId A null value is returned if no PatientProgram exists with this patientProgramId.
Map<Object,Object>	getPatientProgramAttributeByAttributeName(List<Integer> patientIds, String attributeName)
PatientProgramAttribute	getPatientProgramAttributeByUuid(String uuid)
List<PatientProgram>	getPatientProgramByAttributeNameAndValue(String attributeName, String attributeValue)
PatientProgram	getPatientProgramByUuid(String uuid)
List<PatientProgram>	getPatientPrograms(Cohort cohort, Collection<Program> programs)
List<PatientProgram>	getPatientPrograms(Patient patient, Program program, Date minEnrollmentDate, Date maxEnrollmentDate, Date minCompletionDate, Date maxCompletionDate, boolean includeVoided) Returns PatientPrograms that match the input parameters.
PatientState	getPatientStateByUuid(String uuid)
Program	getProgram(Integer programId) Retrieves a Program from the database by primary key programId
ProgramAttributeType	getProgramAttributeType(Integer id)
ProgramAttributeType	getProgramAttributeTypeByUuid(String uuid)
Program	getProgramByUuid(String uuid)
List<Program>	getProgramsByConcept(Concept concept) Returns a list of Programs that are using a particular concept.
List<Program>	getProgramsByName(String programName, boolean includeRetired) Retrieves the Programs from the dB which have the given name.
List<ProgramWorkflow>	getProgramWorkflowsByConcept(Concept concept) Returns a list of ProgramWorkflows that are using a particular concept.
List<ProgramWorkflowState>	getProgramWorkflowStatesByConcept(Concept concept) Returns a list of ProgramWorkflowStates that are using a particular concept.
ProgramWorkflowState	getState(Integer stateId) Retrieves a ProgramWorkflowState from the database by its primary key.
ProgramWorkflowState	getStateByUuid(String uuid)
ProgramWorkflow	getWorkflow(Integer workflowId) Retrieves a ProgramWorkflow from the database by its primary key.
ProgramWorkflow	getWorkflowByUuid(String uuid)
void	purgeProgramAttributeType(ProgramAttributeType type)
ConceptStateConversion	saveConceptStateConversion(ConceptStateConversion csc) Save ConceptStateConversion to database (create if new or update if changed)
PatientProgram	savePatientProgram(PatientProgram patientProgram) Save patientProgram to database (create if new or update if changed)
Program	saveProgram(Program program) Saves a Program to the database
ProgramAttributeType	saveProgramAttributeType(ProgramAttributeType programAttributeType)
void	setSessionFactory(org.hibernate.SessionFactory sessionFactory) Hibernate Session Factory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HibernateProgramWorkflowDAO

public HibernateProgramWorkflowDAO()

Method Detail

setSessionFactory

public void setSessionFactory(org.hibernate.SessionFactory sessionFactory)

Hibernate Session Factory

Parameters:

sessionFactory -

saveProgram

public Program saveProgram(Program program)
                    throws DAOException

Description copied from interface: ProgramWorkflowDAO

Saves a Program to the database

Specified by:

saveProgram in interface ProgramWorkflowDAO

Parameters:

program - - The Program to save

Returns:

The saved Program

Throws:

DAOException

See Also:

ProgramWorkflowDAO.saveProgram(org.openmrs.Program)

getProgram

public Program getProgram(Integer programId)
                   throws DAOException

Description copied from interface: ProgramWorkflowDAO

Retrieves a Program from the database by primary key programId

Specified by:

getProgram in interface ProgramWorkflowDAO

Parameters:

programId - - The primary key programId to use to retrieve a Program

Returns:

Program - The Program matching the passed programId

Throws:

DAOException

See Also:

ProgramWorkflowDAO.getProgram(java.lang.Integer)

getAllPrograms

public List<Program> getAllPrograms(boolean includeRetired)
                             throws DAOException

Description copied from interface: ProgramWorkflowDAO

Returns all programs

Specified by:

getAllPrograms in interface ProgramWorkflowDAO

Parameters:

includeRetired - whether or not to include retired programs

Returns:

List<Program> all existing programs, including retired based on the input parameter

Throws:

DAOException

See Also:

ProgramWorkflowDAO.getAllPrograms(boolean)

getProgramsByName

public List<Program> getProgramsByName(String programName,
                                       boolean includeRetired)

Description copied from interface: ProgramWorkflowDAO

Retrieves the Programs from the dB which have the given name.

Specified by:

getProgramsByName in interface ProgramWorkflowDAO

Parameters:

programName - the name of the Programs to retrieve.

includeRetired - whether to include retired programs or not Should return an empty list when there is no program in the dB with given name Should return only and exactly the programs with the given name

Returns:

all Programs with the given name.

See Also:

ProgramWorkflowDAO.getProgramsByName(String, boolean)

findPrograms

public List<Program> findPrograms(String nameFragment)
                           throws DAOException

Description copied from interface: ProgramWorkflowDAO

Returns programs that match the given string. A null list will never be returned. An empty list will be returned if there are no programs matching this nameFragment

Specified by:

findPrograms in interface ProgramWorkflowDAO

Parameters:

nameFragment - is the string used to search for programs

Returns:

List<Program> - list of Programs whose name matches the input parameter

Throws:

DAOException

See Also:

ProgramWorkflowDAO.findPrograms(java.lang.String)

deleteProgram

public void deleteProgram(Program program)
                   throws DAOException

Description copied from interface: ProgramWorkflowDAO

Completely remove a program from the database (not reversible) This method delegates to #purgeProgram(program, boolean) method

Specified by:

deleteProgram in interface ProgramWorkflowDAO

Parameters:

program - the Program to clean out of the database.

Throws:

DAOException

See Also:

ProgramWorkflowDAO.deleteProgram(org.openmrs.Program)

savePatientProgram

public PatientProgram savePatientProgram(PatientProgram patientProgram)
                                  throws DAOException

Description copied from interface: ProgramWorkflowDAO

Save patientProgram to database (create if new or update if changed)

Specified by:

savePatientProgram in interface ProgramWorkflowDAO

Parameters:

patientProgram - is the PatientProgram to be saved to the database

Returns:

PatientProgram - the saved PatientProgram

Throws:

DAOException

See Also:

ProgramWorkflowDAO.savePatientProgram(org.openmrs.PatientProgram)

getPatientProgram

public PatientProgram getPatientProgram(Integer patientProgramId)
                                 throws DAOException

Description copied from interface: ProgramWorkflowDAO

Returns a PatientProgram given that PatientPrograms primary key patientProgramId A null value is returned if no PatientProgram exists with this patientProgramId.

Specified by:

getPatientProgram in interface ProgramWorkflowDAO

Parameters:

patientProgramId - integer primary key of the PatientProgram to find

Returns:

PatientProgram object that has patientProgram.patientProgramId = patientProgramId passed in.

Throws:

DAOException

See Also:

ProgramWorkflowDAO.getPatientProgram(java.lang.Integer)

getPatientPrograms

public List<PatientProgram> getPatientPrograms(Patient patient,
                                               Program program,
                                               Date minEnrollmentDate,
                                               Date maxEnrollmentDate,
                                               Date minCompletionDate,
                                               Date maxCompletionDate,
                                               boolean includeVoided)
                                        throws DAOException

Description copied from interface: ProgramWorkflowDAO

Returns PatientPrograms that match the input parameters. If an input parameter is set to null, the parameter will not be used. Calling this method will all null parameters will return all PatientPrograms in the database A null list will never be returned. An empty list will be returned if there are no programs matching the input criteria

Specified by:

getPatientPrograms in interface ProgramWorkflowDAO

Parameters:

patient - - if supplied all PatientPrograms returned will be for this Patient

program - - if supplied all PatientPrograms returned will be for this Program

minEnrollmentDate - - if supplied will limit PatientPrograms to those with enrollments on or after this Date

maxEnrollmentDate - - if supplied will limit PatientPrograms to those with enrollments on or before this Date

minCompletionDate - - if supplied will limit PatientPrograms to those completed on or after this Date OR not yet completed

maxCompletionDate - - if supplied will limit PatientPrograms to those completed on or before this Date

includeVoided - - boolean, if true will return voided PatientPrograms as well. If false, will not return voided PatientPrograms

Returns:

List<PatientProgram> of PatientPrograms that match the passed input parameters

Throws:

DAOException

See Also:

ProgramWorkflowDAO.getPatientPrograms(Patient, Program, Date, Date, Date, Date, boolean)

getPatientPrograms

public List<PatientProgram> getPatientPrograms(Cohort cohort,
                                               Collection<Program> programs)

Specified by:

getPatientPrograms in interface ProgramWorkflowDAO

See Also:

ProgramWorkflowDAO.getPatientPrograms(org.openmrs.Cohort, java.util.Collection)

deletePatientProgram

public void deletePatientProgram(PatientProgram patientProgram)
                          throws DAOException

Description copied from interface: ProgramWorkflowDAO

Completely remove a patientProgram from the database (not reversible) This method delegates to #purgePatientProgram(patientProgram, boolean) method

Specified by:

deletePatientProgram in interface ProgramWorkflowDAO

Parameters:

patientProgram - the PatientProgram to clean out of the database.

Throws:

DAOException

See Also:

ProgramWorkflowDAO.deletePatientProgram(org.openmrs.PatientProgram)

saveConceptStateConversion

public ConceptStateConversion saveConceptStateConversion(ConceptStateConversion csc)
                                                  throws DAOException

Description copied from interface: ProgramWorkflowDAO

Save ConceptStateConversion to database (create if new or update if changed)

Specified by:

saveConceptStateConversion in interface ProgramWorkflowDAO

Parameters:

csc - The ConceptStateConversion to save

Returns:

The saved ConceptStateConversion

Throws:

DAOException

See Also:

ProgramWorkflowDAO.saveConceptStateConversion(org.openmrs.ConceptStateConversion)

getAllConceptStateConversions

public List<ConceptStateConversion> getAllConceptStateConversions()
                                                           throws DAOException

Description copied from interface: ProgramWorkflowDAO

Returns all conceptStateConversions

Specified by:

getAllConceptStateConversions in interface ProgramWorkflowDAO

Returns:

List<ConceptStateConversion> of all ConceptStateConversions that exist

Throws:

DAOException

See Also:

ProgramWorkflowDAO.getAllConceptStateConversions()

getConceptStateConversion

public ConceptStateConversion getConceptStateConversion(Integer conceptStateConversionId)

Description copied from interface: ProgramWorkflowDAO

Returns a conceptStateConversion given that conceptStateConversions primary key conceptStateConversionId A null value is returned if no conceptStateConversion exists with this conceptStateConversionId.

Specified by:

getConceptStateConversion in interface ProgramWorkflowDAO

Parameters:

conceptStateConversionId - integer primary key of the conceptStateConversion to find

Returns:

ConceptStateConversion object that has conceptStateConversion.conceptStateConversionId = conceptStateConversionId passed in.

See Also:

ProgramWorkflowDAO.getConceptStateConversion(java.lang.Integer)

deleteConceptStateConversion

public void deleteConceptStateConversion(ConceptStateConversion csc)

Description copied from interface: ProgramWorkflowDAO

Completely remove a conceptStateConversion from the database (not reversible)

Specified by:

deleteConceptStateConversion in interface ProgramWorkflowDAO

Parameters:

csc - the ConceptStateConversion to clean out of the database.

See Also:

ProgramWorkflowDAO.deleteConceptStateConversion(org.openmrs.ConceptStateConversion)

getConceptStateConversion

public ConceptStateConversion getConceptStateConversion(ProgramWorkflow workflow,
                                                        Concept trigger)

Description copied from interface: ProgramWorkflowDAO

Retrieves the ConceptStateConversion that matches the passed ProgramWorkflow and Concept

Specified by:

getConceptStateConversion in interface ProgramWorkflowDAO

Parameters:

workflow - the ProgramWorkflow to check

trigger - the Concept to check

Returns:

ConceptStateConversion that matches the passed ProgramWorkflow and Concept

See Also:

ProgramWorkflowDAO.getConceptStateConversion(org.openmrs.ProgramWorkflow, org.openmrs.Concept)

getConceptStateConversionByUuid

public ConceptStateConversion getConceptStateConversionByUuid(String uuid)

Specified by:

getConceptStateConversionByUuid in interface ProgramWorkflowDAO

Returns:

concept state conversion or null

See Also:

ProgramWorkflowDAO.getConceptStateConversionByUuid(java.lang.String)

getPatientProgramByUuid

public PatientProgram getPatientProgramByUuid(String uuid)

Specified by:

getPatientProgramByUuid in interface ProgramWorkflowDAO

Returns:

patient program or null

See Also:

ProgramWorkflowDAO.getPatientProgramByUuid(java.lang.String)

getProgramByUuid

public Program getProgramByUuid(String uuid)

Specified by:

getProgramByUuid in interface ProgramWorkflowDAO

Returns:

program or null

See Also:

ProgramWorkflowDAO.getProgramByUuid(java.lang.String)

getState

public ProgramWorkflowState getState(Integer stateId)

Description copied from interface: ProgramWorkflowDAO

Retrieves a ProgramWorkflowState from the database by its primary key.

Specified by:

getState in interface ProgramWorkflowDAO

Parameters:

stateId - the primary key used to retrieve program workflow state

Returns:

the program workflow state matching given id or null if not found

See Also:

ProgramWorkflowDAO.getState(Integer)

getStateByUuid

public ProgramWorkflowState getStateByUuid(String uuid)

Specified by:

getStateByUuid in interface ProgramWorkflowDAO

Returns:

program workflow state or null

See Also:

ProgramWorkflowDAO.getStateByUuid(java.lang.String)

getPatientStateByUuid

public PatientState getPatientStateByUuid(String uuid)

Specified by:

getPatientStateByUuid in interface ProgramWorkflowDAO

getWorkflow

public ProgramWorkflow getWorkflow(Integer workflowId)

Description copied from interface: ProgramWorkflowDAO

Retrieves a ProgramWorkflow from the database by its primary key.

Specified by:

getWorkflow in interface ProgramWorkflowDAO

Parameters:

workflowId - the primary key used to retrieve program workflow

Returns:

the program workflow matching given id or null if not found

See Also:

ProgramWorkflowDAO.getWorkflow(Integer)

getWorkflowByUuid

public ProgramWorkflow getWorkflowByUuid(String uuid)

Specified by:

getWorkflowByUuid in interface ProgramWorkflowDAO

Returns:

program workflow or null

See Also:

ProgramWorkflowDAO.getWorkflowByUuid(java.lang.String)

getProgramsByConcept

public List<Program> getProgramsByConcept(Concept concept)

Description copied from interface: ProgramWorkflowDAO

Returns a list of Programs that are using a particular concept.

Specified by:

getProgramsByConcept in interface ProgramWorkflowDAO

Parameters:

concept - - The Concept being used.

Returns:

- A List of Programs

See Also:

ProgramWorkflowDAO.getProgramsByConcept(org.openmrs.Concept)

getProgramWorkflowsByConcept

public List<ProgramWorkflow> getProgramWorkflowsByConcept(Concept concept)

Description copied from interface: ProgramWorkflowDAO

Returns a list of ProgramWorkflows that are using a particular concept.

Specified by:

getProgramWorkflowsByConcept in interface ProgramWorkflowDAO

Parameters:

concept - - The Concept being used.

Returns:

- A List of ProgramWorkflows

See Also:

ProgramWorkflowDAO.getProgramWorkflowsByConcept(org.openmrs.Concept)

getProgramWorkflowStatesByConcept

public List<ProgramWorkflowState> getProgramWorkflowStatesByConcept(Concept concept)

Description copied from interface: ProgramWorkflowDAO

Returns a list of ProgramWorkflowStates that are using a particular concept.

Specified by:

getProgramWorkflowStatesByConcept in interface ProgramWorkflowDAO

Parameters:

concept - - The Concept being used.

Returns:

- A List of ProgramWorkflowStates

See Also:

ProgramWorkflowDAO.getProgramWorkflowStatesByConcept(org.openmrs.Concept)

getAllProgramAttributeTypes

public List<ProgramAttributeType> getAllProgramAttributeTypes()

Specified by:

getAllProgramAttributeTypes in interface ProgramWorkflowDAO

getProgramAttributeType

public ProgramAttributeType getProgramAttributeType(Integer id)

Specified by:

getProgramAttributeType in interface ProgramWorkflowDAO

getProgramAttributeTypeByUuid

public ProgramAttributeType getProgramAttributeTypeByUuid(String uuid)

Specified by:

getProgramAttributeTypeByUuid in interface ProgramWorkflowDAO

saveProgramAttributeType

public ProgramAttributeType saveProgramAttributeType(ProgramAttributeType programAttributeType)

Specified by:

saveProgramAttributeType in interface ProgramWorkflowDAO

getPatientProgramAttributeByUuid

public PatientProgramAttribute getPatientProgramAttributeByUuid(String uuid)

Specified by:

getPatientProgramAttributeByUuid in interface ProgramWorkflowDAO

purgeProgramAttributeType

public void purgeProgramAttributeType(ProgramAttributeType type)

Specified by:

purgeProgramAttributeType in interface ProgramWorkflowDAO

getPatientProgramByAttributeNameAndValue

public List<PatientProgram> getPatientProgramByAttributeNameAndValue(String attributeName,
                                                                     String attributeValue)

Specified by:

getPatientProgramByAttributeNameAndValue in interface ProgramWorkflowDAO

getPatientProgramAttributeByAttributeName

public Map<Object,Object> getPatientProgramAttributeByAttributeName(List<Integer> patientIds,
                                                                    String attributeName)

Specified by:

getPatientProgramAttributeByAttributeName in interface ProgramWorkflowDAO