org.openmrs.api.db.hibernate

Class HibernateLocationDAO

java.lang.Object

org.openmrs.api.db.hibernate.HibernateLocationDAO

All Implemented Interfaces:

LocationDAO

public class HibernateLocationDAO
extends Object
implements LocationDAO

Hibernate location-related database functions

Constructor Summary

Constructors

Constructor and Description
HibernateLocationDAO()

Method Summary

Modifier and Type	Method and Description
void	deleteLocation(Location location) Completely remove the location from the database.
void	deleteLocationAttributeType(LocationAttributeType locationAttributeType)
void	deleteLocationTag(LocationTag tag) Completely remove the location tag from the database.
List<LocationAttributeType>	getAllLocationAttributeTypes()
List<Location>	getAllLocations(boolean includeRetired) Get all locations
List<LocationTag>	getAllLocationTags(boolean includeRetired) Get all location tags
Long	getCountOfLocations(String nameFragment, Boolean includeRetired)
Location	getLocation(Integer locationId) Get a location by locationId
Location	getLocation(String name) Get a location by name
LocationAttribute	getLocationAttributeByUuid(String uuid)
LocationAttributeType	getLocationAttributeType(Integer id)
LocationAttributeType	getLocationAttributeTypeByName(String name)
LocationAttributeType	getLocationAttributeTypeByUuid(String uuid)
Location	getLocationByUuid(String uuid)
List<Location>	getLocations(String nameFragment, Location parent, Map<LocationAttributeType,String> serializedAttributeValues, boolean includeRetired, Integer start, Integer length) Gets the locations matching the specified arguments
List<Location>	getLocationsHavingAllTags(List<LocationTag> tags) Get locations that have all the location tags specified.
LocationTag	getLocationTag(Integer locationTagId) Get a location tag by locationTagId
LocationTag	getLocationTagByName(String tag) Get a location tag by name
LocationTag	getLocationTagByUuid(String uuid)
List<LocationTag>	getLocationTags(String search) Find all location tags with matching names.
List<Location>	getRootLocations(boolean includeRetired)
Location	saveLocation(Location location) Create or update a location.
LocationAttributeType	saveLocationAttributeType(LocationAttributeType locationAttributeType)
LocationTag	saveLocationTag(LocationTag tag) Create or update a location tag.
void	setSessionFactory(org.hibernate.SessionFactory sessionFactory) Set the Hibernate SessionFactory to connect to the database.

Methods inherited from class java.lang.Object

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

Constructor Detail

HibernateLocationDAO

public HibernateLocationDAO()

Method Detail

setSessionFactory

public void setSessionFactory(org.hibernate.SessionFactory sessionFactory)

Description copied from interface: LocationDAO

Set the Hibernate SessionFactory to connect to the database.

Specified by:

setSessionFactory in interface LocationDAO

See Also:

LocationDAO.setSessionFactory(org.hibernate.SessionFactory)

saveLocation

public Location saveLocation(Location location)

Description copied from interface: LocationDAO

Create or update a location.

Specified by:

saveLocation in interface LocationDAO

Parameters:

location - Location to save

Returns:

the saved Location

See Also:

LocationDAO.saveLocation(org.openmrs.Location)

getLocation

public Location getLocation(Integer locationId)

Description copied from interface: LocationDAO

Get a location by locationId

Specified by:

getLocation in interface LocationDAO

Parameters:

locationId - Internal Integer identifier of the Location to get

Returns:

the requested Location

See Also:

LocationDAO.getLocation(java.lang.Integer)

getLocation

public Location getLocation(String name)

Description copied from interface: LocationDAO

Get a location by name

Specified by:

getLocation in interface LocationDAO

Parameters:

name - String name of the Location to get

Returns:

the requested Location

See Also:

LocationDAO.getLocation(java.lang.String)

getAllLocations

public List<Location> getAllLocations(boolean includeRetired)

Description copied from interface: LocationDAO

Get all locations

Specified by:

getAllLocations in interface LocationDAO

Parameters:

includeRetired - boolean - include retired locations as well?

Returns:

List<Location> object of all Locations, possibly including retired locations

See Also:

LocationDAO.getAllLocations(boolean)

deleteLocation

public void deleteLocation(Location location)

Description copied from interface: LocationDAO

Completely remove the location from the database.

Specified by:

deleteLocation in interface LocationDAO

Parameters:

location - Location object to delete

See Also:

LocationDAO.deleteLocation(org.openmrs.Location)

saveLocationTag

public LocationTag saveLocationTag(LocationTag tag)

Description copied from interface: LocationDAO

Create or update a location tag.

Specified by:

saveLocationTag in interface LocationDAO

Returns:

the saved LocationTag

See Also:

LocationDAO.saveLocation(org.openmrs.Location)

getLocationTag

public LocationTag getLocationTag(Integer locationTagId)

Description copied from interface: LocationDAO

Get a location tag by locationTagId

Specified by:

getLocationTag in interface LocationDAO

Parameters:

locationTagId - Internal Integer identifier of the tag to get

Returns:

the requested LocationTag

See Also:

LocationDAO.getLocationTag(java.lang.Integer)

getLocationTagByName

public LocationTag getLocationTagByName(String tag)

Description copied from interface: LocationDAO

Get a location tag by name

Specified by:

getLocationTagByName in interface LocationDAO

Parameters:

tag - String representation of the LocationTag to get

Returns:

the requested LocationTag

See Also:

LocationDAO.getLocationTagByName(java.lang.String)

getAllLocationTags

public List<LocationTag> getAllLocationTags(boolean includeRetired)

Description copied from interface: LocationDAO

Get all location tags

Specified by:

getAllLocationTags in interface LocationDAO

Parameters:

includeRetired - boolean - include retired tags as well?

Returns:

List<LocationTag> object with all LocationTags, possibly included retired ones

See Also:

LocationDAO.getAllLocationTags(boolean)

getLocationTags

public List<LocationTag> getLocationTags(String search)

Description copied from interface: LocationDAO

Find all location tags with matching names.

Specified by:

getLocationTags in interface LocationDAO

Parameters:

search - name to search

Returns:

List<LocationTag> with all matching LocationTags

See Also:

LocationDAO.getLocationTags(String)

deleteLocationTag

public void deleteLocationTag(LocationTag tag)

Description copied from interface: LocationDAO

Completely remove the location tag from the database.

Specified by:

deleteLocationTag in interface LocationDAO

Parameters:

tag - The LocationTag to delete

See Also:

LocationDAO.deleteLocationTag(org.openmrs.LocationTag)

getLocationByUuid

public Location getLocationByUuid(String uuid)

Specified by:

getLocationByUuid in interface LocationDAO

Parameters:

uuid - the uuid to look for

Returns:

location matching uuid

See Also:

LocationDAO.getLocationByUuid(java.lang.String)

getLocationTagByUuid

public LocationTag getLocationTagByUuid(String uuid)

Specified by:

getLocationTagByUuid in interface LocationDAO

Returns:

location tag or null

See Also:

LocationDAO.getLocationTagByUuid(java.lang.String)

getCountOfLocations

public Long getCountOfLocations(String nameFragment,
                                Boolean includeRetired)

Specified by:

getCountOfLocations in interface LocationDAO

See Also:

LocationDAO.getCountOfLocations(String, Boolean)

getLocations

public List<Location> getLocations(String nameFragment,
                                   Location parent,
                                   Map<LocationAttributeType,String> serializedAttributeValues,
                                   boolean includeRetired,
                                   Integer start,
                                   Integer length)

Description copied from interface: LocationDAO

Gets the locations matching the specified arguments

Specified by:

getLocations in interface LocationDAO

Parameters:

nameFragment - is the string used to search for locations

parent - only return children of this parent

serializedAttributeValues - the serialized attribute values

includeRetired - specifies if retired locations should also be returned

start - the beginning index

length - the number of matching locations to return

Returns:

the list of locations

See Also:

LocationDAO.getLocations(String, org.openmrs.Location, java.util.Map, boolean, Integer, Integer)

getRootLocations

public List<Location> getRootLocations(boolean includeRetired)
                                throws DAOException

Specified by:

getRootLocations in interface LocationDAO

Throws:

DAOException

See Also:

LocationDAO.getRootLocations(boolean)

getAllLocationAttributeTypes

public List<LocationAttributeType> getAllLocationAttributeTypes()

Specified by:

getAllLocationAttributeTypes in interface LocationDAO

See Also:

LocationDAO.getAllLocationAttributeTypes()

getLocationAttributeType

public LocationAttributeType getLocationAttributeType(Integer id)

Specified by:

getLocationAttributeType in interface LocationDAO

See Also:

LocationDAO.getLocationAttributeType(java.lang.Integer)

getLocationAttributeTypeByUuid

public LocationAttributeType getLocationAttributeTypeByUuid(String uuid)

Specified by:

getLocationAttributeTypeByUuid in interface LocationDAO

See Also:

LocationDAO.getLocationAttributeTypeByUuid(java.lang.String)

saveLocationAttributeType

public LocationAttributeType saveLocationAttributeType(LocationAttributeType locationAttributeType)

Specified by:

saveLocationAttributeType in interface LocationDAO

See Also:

LocationDAO.saveLocationAttributeType(org.openmrs.LocationAttributeType)

deleteLocationAttributeType

public void deleteLocationAttributeType(LocationAttributeType locationAttributeType)

Specified by:

deleteLocationAttributeType in interface LocationDAO

See Also:

LocationDAO.deleteLocationAttributeType(org.openmrs.LocationAttributeType)

getLocationAttributeByUuid

public LocationAttribute getLocationAttributeByUuid(String uuid)

Specified by:

getLocationAttributeByUuid in interface LocationDAO

See Also:

LocationDAO.getLocationAttributeByUuid(java.lang.String)

getLocationAttributeTypeByName

public LocationAttributeType getLocationAttributeTypeByName(String name)

Specified by:

getLocationAttributeTypeByName in interface LocationDAO

See Also:

LocationDAO.getLocationAttributeTypeByName(java.lang.String)

getLocationsHavingAllTags

public List<Location> getLocationsHavingAllTags(List<LocationTag> tags)

Description copied from interface: LocationDAO

Get locations that have all the location tags specified.

Specified by:

getLocationsHavingAllTags in interface LocationDAO

Returns:

list of locations Should get locations having all tags Should return empty list when no location has the given tags Should ignore null values in location tag list

See Also:

LocationDAO.getLocationsHavingAllTags(java.util.List)