org.openmrs.api.db

Interface EncounterDAO

All Known Implementing Classes:

HibernateEncounterDAO

public interface EncounterDAO

Encounter-related database functions

Method Summary

Modifier and Type	Method and Description
void	deleteEncounter(Encounter encounter) Purge an encounter from database.
void	deleteEncounterRole(EncounterRole encounterRole) Purge an encounter role from database.
void	deleteEncounterType(EncounterType encounterType) Purge encounter type from database.
java.util.List<EncounterType>	findEncounterTypes(java.lang.String name) Find Encounter Types matching the given name.
java.util.List<EncounterRole>	getAllEncounterRoles(boolean includeRetired) Get all enconter roles and optionally specify whehter to include retired encontered roles
java.util.Map<java.lang.Integer,java.util.List<Encounter>>	getAllEncounters(Cohort patients)
java.util.List<EncounterType>	getAllEncounterTypes(java.lang.Boolean includeVoided) Get all encounter types
java.lang.Long	getCountOfEncounters(java.lang.String query, java.lang.Integer patientId, boolean includeVoided) Return the number of encounters matching a patient name or patient identifier
Encounter	getEncounter(java.lang.Integer encounterId) Get encounter by internal identifier
Encounter	getEncounterByUuid(java.lang.String uuid) Find Encounter matching a uuid
EncounterRole	getEncounterRole(java.lang.Integer encounterRoleId) Get encounter role by internal identifier
EncounterRole	getEncounterRoleByUuid(java.lang.String uuid) Find EncounterRole matching a uuid
java.util.List<Encounter>	getEncounters(Patient patient, Location location, java.util.Date fromDate, java.util.Date toDate, java.util.Collection<Form> enteredViaForms, java.util.Collection<EncounterType> encounterTypes, java.util.Collection<Provider> providers, java.util.Collection<VisitType> visitTypes, java.util.Collection<Visit> visits, boolean includeVoided)
java.util.List<Encounter>	getEncounters(java.lang.String query, java.lang.Integer patientId, java.lang.Integer start, java.lang.Integer length, boolean includeVoided) Get a list of Encounter by Patient name or identifier based on batch settings
java.util.List<Encounter>	getEncountersByPatientId(java.lang.Integer patientId)
java.util.List<Encounter>	getEncountersByVisit(Visit visit, boolean includeVoided)
java.util.List<Encounter>	getEncountersByVisitsAndPatient(Patient patient, boolean includeVoided, java.lang.String query, java.lang.Integer start, java.lang.Integer length)
java.lang.Integer	getEncountersByVisitsAndPatientCount(Patient patient, boolean includeVoided, java.lang.String query)
java.util.List<Encounter>	getEncountersNotAssignedToAnyVisit(Patient patient)
EncounterType	getEncounterType(java.lang.Integer encounterTypeId) Get encounterType by internal identifier
EncounterType	getEncounterType(java.lang.String name) Get encounterType by name
EncounterType	getEncounterTypeByUuid(java.lang.String uuid) Find EncounterType matching a uuid
java.util.Date	getSavedEncounterDatetime(Encounter encounter) Gets the value of encounterDatetime currently saved in the database for the given encounter, bypassing any caches.
Location	getSavedEncounterLocation(Encounter encounter) Gets the location of the encounter
Encounter	saveEncounter(Encounter encounter) Saves an encounter
EncounterRole	saveEncounterRole(EncounterRole encounterRole) Saves an encounter role
EncounterType	saveEncounterType(EncounterType encounterType) Save an Encounter Type

Method Detail

saveEncounter

Encounter saveEncounter(Encounter encounter)
                 throws DAOException

Saves an encounter

Parameters:

encounter - to be saved

Throws:

DAOException

deleteEncounter

void deleteEncounter(Encounter encounter)
              throws DAOException

Purge an encounter from database.

Parameters:

encounter - encounter object to be purged

Throws:

DAOException

getEncounter

Encounter getEncounter(java.lang.Integer encounterId)
                throws DAOException

Get encounter by internal identifier

Parameters:

encounterId - encounter id

Returns:

encounter with given internal identifier

Throws:

DAOException

getEncountersByPatientId

java.util.List<Encounter> getEncountersByPatientId(java.lang.Integer patientId)
                                            throws DAOException

Parameters:

patientId -

Returns:

all encounters for the given patient identifer

Throws:

DAOException

getEncounters

java.util.List<Encounter> getEncounters(Patient patient,
                                        Location location,
                                        java.util.Date fromDate,
                                        java.util.Date toDate,
                                        java.util.Collection<Form> enteredViaForms,
                                        java.util.Collection<EncounterType> encounterTypes,
                                        java.util.Collection<Provider> providers,
                                        java.util.Collection<VisitType> visitTypes,
                                        java.util.Collection<Visit> visits,
                                        boolean includeVoided)

See Also:

EncounterService.getEncounters(org.openmrs.Patient, org.openmrs.Location, java.util.Date, java.util.Date, java.util.Collection, java.util.Collection, java.util.Collection, java.util.Collection, java.util.Collection, boolean)

saveEncounterType

EncounterType saveEncounterType(EncounterType encounterType)

Save an Encounter Type

Parameters:

encounterType -

deleteEncounterType

void deleteEncounterType(EncounterType encounterType)
                  throws DAOException

Purge encounter type from database.

Parameters:

encounterType -

Throws:

DAOException

getEncounterType

EncounterType getEncounterType(java.lang.Integer encounterTypeId)
                        throws DAOException

Get encounterType by internal identifier

Parameters:

encounterTypeId - Internal Integer identifier for an EncounterType

Returns:

EncounterType with given internal identifier

Throws:

DAOException

getEncounterType

EncounterType getEncounterType(java.lang.String name)
                        throws DAOException

Get encounterType by name

Parameters:

name - String representation of an encounterType

Returns:

EncounterType

Throws:

DAOException

getAllEncounterTypes

java.util.List<EncounterType> getAllEncounterTypes(java.lang.Boolean includeVoided)
                                            throws DAOException

Get all encounter types

Returns:

encounter types list

Throws:

DAOException

findEncounterTypes

java.util.List<EncounterType> findEncounterTypes(java.lang.String name)
                                          throws DAOException

Find Encounter Types matching the given name. Search string is case insensitive, so that "NaMe".equals("name") is true.

Parameters:

name -

Returns:

all EncounterTypes that match

Throws:

DAOException

getSavedEncounterDatetime

java.util.Date getSavedEncounterDatetime(Encounter encounter)

Gets the value of encounterDatetime currently saved in the database for the given encounter, bypassing any caches. This is used prior to saving an encounter so that we can change the obs if need be

Parameters:

encounter - the Encounter go the the encounterDatetime of

Returns:

the encounterDatetime currently in the database for this encounter

getEncounterByUuid

Encounter getEncounterByUuid(java.lang.String uuid)

Find Encounter matching a uuid

Parameters:

uuid -

Returns:

Encounter

getEncounterTypeByUuid

EncounterType getEncounterTypeByUuid(java.lang.String uuid)

Find EncounterType matching a uuid

Parameters:

uuid -

Returns:

EncounterType

getEncounters

java.util.List<Encounter> getEncounters(java.lang.String query,
                                        java.lang.Integer patientId,
                                        java.lang.Integer start,
                                        java.lang.Integer length,
                                        boolean includeVoided)

Get a list of Encounter by Patient name or identifier based on batch settings

Parameters:

query - patient name or identifier

patientId - the patient id

start - beginning index for the batch

length - number of encounters to return in the batch

includeVoided - Specifies whether voided encounters should be included

Returns:

list of Encounter based on batch settings

See Also:

EncounterService.getEncounters(String, Integer, Integer, boolean)

getSavedEncounterLocation

Location getSavedEncounterLocation(Encounter encounter)

Gets the location of the encounter

Parameters:

encounter - to be retrieved from the database

Returns:

Location

getAllEncounters

java.util.Map<java.lang.Integer,java.util.List<Encounter>> getAllEncounters(Cohort patients)

See Also:

EncounterService.getAllEncounters(Cohort)

getCountOfEncounters

java.lang.Long getCountOfEncounters(java.lang.String query,
                                    java.lang.Integer patientId,
                                    boolean includeVoided)

Return the number of encounters matching a patient name or patient identifier

Parameters:

query - patient name or identifier

patientId - the patient id

includeVoided - Specifies whether voided encounters should be included

Returns:

the number of encounters matching the given search phrase

See Also:

EncounterService#getCountOfEncounters(String, boolean)}

getEncountersByVisit

java.util.List<Encounter> getEncountersByVisit(Visit visit,
                                               boolean includeVoided)

See Also:

EncounterService.getEncountersByVisit(Visit, boolean)

saveEncounterRole

EncounterRole saveEncounterRole(EncounterRole encounterRole)
                         throws DAOException

Saves an encounter role

Parameters:

encounter - role to be saved

Throws:

DAOException

deleteEncounterRole

void deleteEncounterRole(EncounterRole encounterRole)
                  throws DAOException

Purge an encounter role from database.

Parameters:

encounterRole - encounter role object to be purged

Throws:

DAOException

getEncounterRole

EncounterRole getEncounterRole(java.lang.Integer encounterRoleId)
                        throws DAOException

Get encounter role by internal identifier

Parameters:

encounterRoleId - encounter role id

Returns:

encounter role with given internal identifier

Throws:

DAOException

getEncounterRoleByUuid

EncounterRole getEncounterRoleByUuid(java.lang.String uuid)

Find EncounterRole matching a uuid

Parameters:

uuid -

Returns:

EncounterRole

getAllEncounterRoles

java.util.List<EncounterRole> getAllEncounterRoles(boolean includeRetired)
                                            throws DAOException

Get all enconter roles and optionally specify whehter to include retired encontered roles

Parameters:

includeRetired - include retired

Returns:

enconter roles

Throws:

DAOException

See Also:

org.openmrs.api.EncounterRoleService#getAllEncounterRoles(boolan includeRetired)

getEncountersNotAssignedToAnyVisit

java.util.List<Encounter> getEncountersNotAssignedToAnyVisit(Patient patient)
                                                      throws DAOException

Throws:

DAOException

See Also:

EncounterService.getEncountersNotAssignedToAnyVisit(Patient)

getEncountersByVisitsAndPatient

java.util.List<Encounter> getEncountersByVisitsAndPatient(Patient patient,
                                                          boolean includeVoided,
                                                          java.lang.String query,
                                                          java.lang.Integer start,
                                                          java.lang.Integer length)

See Also:

EncounterService#getEncountersByVisitsAndPatient(Patient, boolean, String, Date, Date)

getEncountersByVisitsAndPatientCount

java.lang.Integer getEncountersByVisitsAndPatientCount(Patient patient,
                                                       boolean includeVoided,
                                                       java.lang.String query)

See Also:

EncounterService.getEncountersByVisitsAndPatientCount(Patient, boolean, String)