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	deleteEncounterType(EncounterType encounterType) Purge encounter type from database.
List<EncounterType>	findEncounterTypes(String name) Find Encounter Types matching the given name.
Map<Integer,List<Encounter>>	getAllEncounters(Cohort patients)
List<EncounterType>	getAllEncounterTypes(Boolean includeVoided) Get all encounter types
Integer	getCountOfEncounters(String query, boolean includeVoided) Return the number of encounters matching a patient name or patient identifier
Encounter	getEncounter(Integer encounterId) Get encounter by internal identifier
Encounter	getEncounterByUuid(String uuid) Find Encounter matching a uuid
List<Encounter>	getEncounters(Patient patient, Location location, Date fromDate, Date toDate, Collection<Form> enteredViaForms, Collection<EncounterType> encounterTypes, Collection<User> providers, boolean includeVoided)
List<Encounter>	getEncounters(String query, Integer start, Integer length, boolean includeVoided) Get a list of Encounter by Patient name or identifier based on batch settings
List<Encounter>	getEncountersByPatientId(Integer patientId)
EncounterType	getEncounterType(Integer encounterTypeId) Get encounterType by internal identifier
EncounterType	getEncounterType(String name) Get encounterType by name
EncounterType	getEncounterTypeByUuid(String uuid) Find EncounterType matching a uuid
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
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(Integer encounterId)
                throws DAOException

Get encounter by internal identifier

Parameters:

encounterId - encounter id

Returns:

encounter with given internal identifier

Throws:

DAOException

getEncountersByPatientId

List<Encounter> getEncountersByPatientId(Integer patientId)
                                  throws DAOException

Parameters:

patientId -

Returns:

all encounters for the given patient identifer

Throws:

DAOException

getEncounters

List<Encounter> getEncounters(Patient patient,
                              Location location,
                              Date fromDate,
                              Date toDate,
                              Collection<Form> enteredViaForms,
                              Collection<EncounterType> encounterTypes,
                              Collection<User> providers,
                              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, 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(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(String name)
                        throws DAOException

Get encounterType by name

Parameters:

name - String representation of an encounterType

Returns:

EncounterType

Throws:

DAOException

getAllEncounterTypes

List<EncounterType> getAllEncounterTypes(Boolean includeVoided)
                                  throws DAOException

Get all encounter types

Returns:

encounter types list

Throws:

DAOException

findEncounterTypes

List<EncounterType> findEncounterTypes(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

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

Should:

get saved encounter datetime from database

getEncounterByUuid

Encounter getEncounterByUuid(String uuid)

Find Encounter matching a uuid

Parameters:

uuid -

Returns:

Encounter

getEncounterTypeByUuid

EncounterType getEncounterTypeByUuid(String uuid)

Find EncounterType matching a uuid

Parameters:

uuid -

Returns:

EncounterType

getEncounters

List<Encounter> getEncounters(String query,
                              Integer start,
                              Integer length,
                              boolean includeVoided)

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

Parameters:

query - patient name or identifier

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

Map<Integer,List<Encounter>> getAllEncounters(Cohort patients)

See Also:

EncounterService.getAllEncounters(Cohort)

getCountOfEncounters

Integer getCountOfEncounters(String query,
                             boolean includeVoided)

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

Parameters:

query - patient name or identifier

includeVoided - Specifies whether voided encounters should be included

Returns:

the number of encounters matching the given search phrase

See Also:

EncounterService#getCountOfEncounters(String, boolean)}