ServiceContext (OpenMRS 2.7.0-SNAPSHOT API)

java.lang.Object
- org.openmrs.api.context.ServiceContext

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware
```
public class ServiceContext
extends Object
implements org.springframework.context.ApplicationContextAware
```
Represents an OpenMRS Service Context, which returns the services represented throughout the system.

This class should not be access directly, but rather used through the Context class.

This class is essentially static and only one instance is kept because this is fairly heavy-weight. Spring takes care of filling in the actual service implementations via dependency injection. See the /metadata/api/spring/applicationContext-service.xml file.

Module services are also accessed through this class. See getService(Class)

See Also:

Context

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAdvice(Class cls, org.aopalliance.aop.Advice advice)`
`void`	`addAdvisor(Class cls, org.springframework.aop.Advisor advisor)`
`static void`	`destroyInstance()` Null out the current instance of the ServiceContext.
`void`	`doneRefreshingContext()` Should be called right after any spring context refresh This wakes up all calls to getService that were waiting because `startRefreshingContext` was called
`AdministrationService`	`getAdministrationService()`
`AlertService`	`getAlertService()`
`org.springframework.context.ApplicationContext`	`getApplicationContext()`
`CohortService`	`getCohortService()`
`ConceptService`	`getConceptService()`
`ConditionService`	`getConditionService()`
`DatatypeService`	`getDatatypeService()` Gets the datatype service
`DiagnosisService`	`getDiagnosisService()`
`EncounterService`	`getEncounterService()`
`FormService`	`getFormService()`
`HL7Service`	`getHL7Service()`
`static ServiceContext`	`getInstance()` There should only be one ServiceContext per openmrs (java virtual machine).
`LocationService`	`getLocationService()`
`LogicService`	`getLogicService()`
`MedicationDispenseService`	`getMedicationDispenseService()`
`MessageService`	`getMessageService()`
`MessageSourceService`	`getMessageSourceService()` Gets the MessageSourceService used in the context.
`List<OpenmrsService>`	`getModuleOpenmrsServices(String modulePackage)` Gets a list of services implementing the `OpenmrsService` interface, for a given module.
`ObsService`	`getObsService()`
`OrderService`	`getOrderService()`
`OrderSetService`	`getOrderSetService()`
`PatientService`	`getPatientService()`
`PersonService`	`getPersonService()`
`ProgramWorkflowService`	`getProgramWorkflowService()`
`ProviderService`	`getProviderService()` Gets the provider service.
`<T> T`	`getRegisteredComponent(String beanName, Class<T> type)` Retrieves a bean that match the given type (including subclasses) and name.
`<T> List<T>`	`getRegisteredComponents(Class<T> type)` Retrieves all Beans which have been registered in the Spring `ApplicationContext` that match the given object type (including subclasses).
`SchedulerService`	`getSchedulerService()`
`SerializationService`	`getSerializationService()`
`<T> T`	`getService(Class<? extends T> cls)` Returns the current proxy that is stored for the Class `cls`
`UserService`	`getUserService()`
`VisitService`	`getVisitService()` Gets the visit service.
`boolean`	`isRefreshingContext()` Returns true/false whether startRefreshingContext() has been called without a subsequent call to doneRefreshingContext() yet.
`boolean`	`isUseSystemClassLoader()` Checks if we are using the system class loader.
`void`	`removeAdvice(Class cls, org.aopalliance.aop.Advice advice)`
`void`	`removeAdvisor(Class cls, org.springframework.aop.Advisor advisor)`
`void`	`setAdministrationService(AdministrationService administrationService)`
`void`	`setAlertService(AlertService alertService)`
`void`	`setApplicationContext(org.springframework.context.ApplicationContext applicationContext)`
`void`	`setCohortService(CohortService cs)`
`void`	`setConceptService(ConceptService conceptService)`
`void`	`setConditionService(ConditionService conditionService)`
`void`	`setDatatypeService(DatatypeService datatypeService)` Sets the datatype service
`void`	`setDiagnosisService(DiagnosisService diagnosisService)`
`void`	`setEncounterService(EncounterService encounterService)`
`void`	`setFormService(FormService formService)`
`void`	`setHl7Service(HL7Service hl7Service)`
`void`	`setLocationService(LocationService locationService)`
`void`	`setLogicService(LogicService logicService)`
`void`	`setMedicationDispenseService(MedicationDispenseService medicationDispenseService)`
`void`	`setMessageService(MessageService messageService)` Sets the message service.
`void`	`setMessageSourceService(MessageSourceService messageSourceService)` Sets the MessageSourceService used in the context.
`void`	`setModuleService(List<Object> params)` Allow other services to be added to our service layer Classes will be found/loaded with the ModuleClassLoader `params`[0] = string representing the service interface `params`[1] = service instance
`void`	`setObsService(ObsService obsService)`
`void`	`setOrderService(OrderService orderService)`
`void`	`setOrderSetService(OrderSetService orderSetService)`
`void`	`setPatientService(PatientService patientService)`
`void`	`setPersonService(PersonService personService)`
`void`	`setProgramWorkflowService(ProgramWorkflowService programWorkflowService)`
`void`	`setProviderService(ProviderService providerService)` Sets the provider service.
`static void`	`setRefreshingContext(boolean refreshingContext)`
`void`	`setSchedulerService(SchedulerService schedulerService)` Set the scheduler service.
`void`	`setSerializationService(SerializationService serializationService)`
`void`	`setService(Class cls, Object classInstance)` Allow other services to be added to our service layer
`void`	`setUserService(UserService userService)`
`void`	`setUseSystemClassLoader(boolean useSystemClassLoader)` Set this service context to use the system class loader if the `useSystemClassLoader` is set to true.
`void`	`setVisitService(VisitService visitService)` Sets the visit service.
`void`	`startRefreshingContext()` Should be called right before any spring context refresh This forces all calls to getService to wait until `doneRefreshingContext` is called

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getInstance
```
public static ServiceContext getInstance()
```
    There should only be one ServiceContext per openmrs (java virtual machine). This method should be used when wanting to fetch the service context Note: The ServiceContext shouldn't be used independently. All calls should go through the Context
    
    Returns:
    
    This VM's current ServiceContext.
    
    See Also:
    
    Context
  - destroyInstance
```
public static void destroyInstance()
```
    Null out the current instance of the ServiceContext. This should be used when modules are refreshing (being added/removed) and/or openmrs is shutting down
  - getEncounterService
```
public EncounterService getEncounterService()
```
    Returns:
    
    encounter-related services
  - getLocationService
```
public LocationService getLocationService()
```
    Returns:
    
    location services
  - getObsService
```
public ObsService getObsService()
```
    Returns:
    
    observation services
  - getConditionService
```
public ConditionService getConditionService()
```
    Returns:
    
    condition related service
    
    Since:
    
    2.2
  - setConditionService
```
public void setConditionService(ConditionService conditionService)
```
    Parameters:
    
    conditionService - condition related service
    
    Since:
    
    2.2
  - getDiagnosisService
```
public DiagnosisService getDiagnosisService()
```
    Returns:
    
    diagnosis related service
    
    Since:
    
    2.2
  - setDiagnosisService
```
public void setDiagnosisService(DiagnosisService diagnosisService)
```
    Parameters:
    
    diagnosisService - diagnosis related service
    
    Since:
    
    2.2
  - getMedicationDispenseService
```
public MedicationDispenseService getMedicationDispenseService()
```
    Returns:
    
    MedicationDispense related service
    
    Since:
    
    2.6.0
  - setMedicationDispenseService
```
public void setMedicationDispenseService(MedicationDispenseService medicationDispenseService)
```
    Parameters:
    
    medicationDispenseService - MedicationDispense related service
    
    Since:
    
    2.6.0
  - getCohortService
```
public CohortService getCohortService()
```
    Returns:
    
    cohort related service
  - setCohortService
```
public void setCohortService(CohortService cs)
```
    Parameters:
    
    cs - cohort related service
  - getOrderSetService
```
public OrderSetService getOrderSetService()
```
    Returns:
    
    order set service
  - getOrderService
```
public OrderService getOrderService()
```
    Returns:
    
    order service
  - getFormService
```
public FormService getFormService()
```
    Returns:
    
    form service
  - getSerializationService
```
public SerializationService getSerializationService()
```
    Returns:
    
    serialization service
  - getAdministrationService
```
public AdministrationService getAdministrationService()
```
    Returns:
    
    admin-related services
  - getProgramWorkflowService
```
public ProgramWorkflowService getProgramWorkflowService()
```
    Returns:
    
    programWorkflowService
  - getLogicService
```
public LogicService getLogicService()
```
    Returns:
    
    logicService
  - getSchedulerService
```
public SchedulerService getSchedulerService()
```
    Returns:
    
    scheduler service
  - setSchedulerService
```
public void setSchedulerService(SchedulerService schedulerService)
```
    Set the scheduler service.
    
    Parameters:
    
    schedulerService -
  - getAlertService
```
public AlertService getAlertService()
```
    Returns:
    
    alert service
  - setAlertService
```
public void setAlertService(AlertService alertService)
```
    Parameters:
    
    alertService -
  - setProgramWorkflowService
```
public void setProgramWorkflowService(ProgramWorkflowService programWorkflowService)
```
    Parameters:
    
    programWorkflowService -
  - setLogicService
```
public void setLogicService(LogicService logicService)
```
    Parameters:
    
    logicService -
  - getMessageService
```
public MessageService getMessageService()
```
    Returns:
    
    message service
  - setMessageService
```
public void setMessageService(MessageService messageService)
```
    Sets the message service.
    
    Parameters:
    
    messageService -
  - getHL7Service
```
public HL7Service getHL7Service()
```
    Returns:
    
    the hl7Service
  - setHl7Service
```
public void setHl7Service(HL7Service hl7Service)
```
    Parameters:
    
    hl7Service - the hl7Service to set
  - setAdministrationService
```
public void setAdministrationService(AdministrationService administrationService)
```
    Parameters:
    
    administrationService - the administrationService to set
  - setEncounterService
```
public void setEncounterService(EncounterService encounterService)
```
    Parameters:
    
    encounterService - the encounterService to set
  - setLocationService
```
public void setLocationService(LocationService locationService)
```
    Parameters:
    
    locationService - the LocationService to set
  - setFormService
```
public void setFormService(FormService formService)
```
    Parameters:
    
    formService - the formService to set
  - setObsService
```
public void setObsService(ObsService obsService)
```
    Parameters:
    
    obsService - the obsService to set
  - setOrderService
```
public void setOrderService(OrderService orderService)
```
    Parameters:
    
    orderService - the orderService to set
  - setOrderSetService
```
public void setOrderSetService(OrderSetService orderSetService)
```
    Parameters:
    
    orderSetService - the orderSetService to set
  - setSerializationService
```
public void setSerializationService(SerializationService serializationService)
```
    Parameters:
    
    serializationService -
  - getPatientService
```
public PatientService getPatientService()
```
    Returns:
    
    patient related services
  - setPatientService
```
public void setPatientService(PatientService patientService)
```
    Parameters:
    
    patientService - the patientService to set
  - getPersonService
```
public PersonService getPersonService()
```
    Returns:
    
    person related services
  - setPersonService
```
public void setPersonService(PersonService personService)
```
    Parameters:
    
    personService - the personService to set
  - getConceptService
```
public ConceptService getConceptService()
```
    Returns:
    
    concept related services
  - setConceptService
```
public void setConceptService(ConceptService conceptService)
```
    Parameters:
    
    conceptService - the conceptService to set
  - getUserService
```
public UserService getUserService()
```
    Returns:
    
    user-related services
  - setUserService
```
public void setUserService(UserService userService)
```
    Parameters:
    
    userService - the userService to set
  - getMessageSourceService
```
public MessageSourceService getMessageSourceService()
```
    Gets the MessageSourceService used in the context.
    
    Returns:
    
    MessageSourceService
  - setMessageSourceService
```
public void setMessageSourceService(MessageSourceService messageSourceService)
```
    Sets the MessageSourceService used in the context.
    
    Parameters:
    
    messageSourceService - the MessageSourceService to use
  - addAdvisor
```
public void addAdvisor(Class cls,
                       org.springframework.aop.Advisor advisor)
```
    Parameters:
    
    cls -
    
    advisor -
  - addAdvice
```
public void addAdvice(Class cls,
                      org.aopalliance.aop.Advice advice)
```
    Parameters:
    
    cls -
    
    advice -
  - removeAdvisor
```
public void removeAdvisor(Class cls,
                          org.springframework.aop.Advisor advisor)
```
    Parameters:
    
    cls -
    
    advisor -
  - removeAdvice
```
public void removeAdvice(Class cls,
                         org.aopalliance.aop.Advice advice)
```
    Parameters:
    
    cls -
    
    advice -
  - getService
```
public <T> T getService(Class<? extends T> cls)
```
    Returns the current proxy that is stored for the Class cls
    
    Parameters:
    
    cls -
    
    Returns:
    
    Object that is a proxy for the cls class
  - setService
```
public void setService(Class cls,
                       Object classInstance)
```
    Allow other services to be added to our service layer
    
    Parameters:
    
    cls - Interface to proxy
    
    classInstance - the actual instance of the cls interface
  - setModuleService
```
public void setModuleService(List<Object> params)
```
    Allow other services to be added to our service layer
    
    Classes will be found/loaded with the ModuleClassLoader
    
    params[0] = string representing the service interface
    params[1] = service instance
    
    Parameters:
    
    params - list of parameters
  - setUseSystemClassLoader
```
public void setUseSystemClassLoader(boolean useSystemClassLoader)
```
    Set this service context to use the system class loader if the useSystemClassLoader is set to true. If false, the openmrs class loader is used to load module services
    
    Parameters:
    
    useSystemClassLoader - true/false whether to use the system class loader
  - isUseSystemClassLoader
```
public boolean isUseSystemClassLoader()
```
    Checks if we are using the system class loader.
    
    Returns:
    
    true if using the system class loader, else false.
  - setRefreshingContext
```
public static void setRefreshingContext(boolean refreshingContext)
```
  - startRefreshingContext
```
public void startRefreshingContext()
```
    Should be called right before any spring context refresh This forces all calls to getService to wait until doneRefreshingContext is called
  - doneRefreshingContext
```
public void doneRefreshingContext()
```
    Should be called right after any spring context refresh This wakes up all calls to getService that were waiting because startRefreshingContext was called
  - isRefreshingContext
```
public boolean isRefreshingContext()
```
    Returns true/false whether startRefreshingContext() has been called without a subsequent call to doneRefreshingContext() yet. All methods involved in starting/stopping a module should call this if a service method is needed -- otherwise a deadlock will occur.
    
    Returns:
    
    true/false whether the services are currently blocking waiting for a call to doneRefreshingContext()
  - getRegisteredComponents
```
public <T> List<T> getRegisteredComponents(Class<T> type)
```
    Retrieves all Beans which have been registered in the Spring ApplicationContext that match the given object type (including subclasses).
    NOTE: This method introspects top-level beans only. It does not check nested beans which might match the specified type as well.
    
    Parameters:
    
    type - the type of Bean to retrieve from the Spring ApplicationContext
    
    Returns:
    
    a List of all registered Beans that are valid instances of the passed type
    
    Since:
    
    1.5 Should return a list of all registered beans of the passed type Should return beans registered in a module Should return an empty list if no beans have been registered of the passed type
    
    See Also:
    
    ListableBeanFactory.getBeansOfType(Class)
  - getRegisteredComponent
```
public <T> T getRegisteredComponent(String beanName,
                                    Class<T> type)
                             throws APIException
```
    Retrieves a bean that match the given type (including subclasses) and name.
    
    Parameters:
    
    beanName - the name of registered bean to retrieve
    
    type - the type of bean to retrieve
    
    Returns:
    
    bean of passed type
    
    Throws:
    
    APIException
    
    Since:
    
    1.9.4
  - setApplicationContext
```
public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
```
    Specified by:
    
    setApplicationContext in interface org.springframework.context.ApplicationContextAware
    
    Parameters:
    
    applicationContext - the applicationContext to set
  - getApplicationContext
```
public org.springframework.context.ApplicationContext getApplicationContext()
```
  - getModuleOpenmrsServices
```
public List<OpenmrsService> getModuleOpenmrsServices(String modulePackage)
```
    Gets a list of services implementing the OpenmrsService interface, for a given module.
    
    Parameters:
    
    modulePackage - the module's package name.
    
    Returns:
    
    the list of service instances.
    
    Since:
    
    1.9
  - getVisitService
```
public VisitService getVisitService()
```
    Gets the visit service.
    
    Returns:
    
    visit service.
    
    Since:
    
    1.9
  - setVisitService
```
public void setVisitService(VisitService visitService)
```
    Sets the visit service.
    
    Parameters:
    
    visitService - the visitService to set
    
    Since:
    
    1.9
  - getProviderService
```
public ProviderService getProviderService()
```
    Gets the provider service.
    
    Returns:
    
    provider service.
    
    Since:
    
    1.9
  - setProviderService
```
public void setProviderService(ProviderService providerService)
```
    Sets the provider service.
    
    Parameters:
    
    providerService - the providerService to set
    
    Since:
    
    1.9
  - getDatatypeService
```
public DatatypeService getDatatypeService()
```
    Gets the datatype service
    
    Returns:
    
    custom datatype service
    
    Since:
    
    1.9
  - setDatatypeService
```
public void setDatatypeService(DatatypeService datatypeService)
```
    Sets the datatype service
    
    Parameters:
    
    datatypeService - the datatypeService to set
    
    Since:
    
    1.9

Class ServiceContext

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getInstance

destroyInstance

getEncounterService

getLocationService

getObsService

getConditionService

setConditionService

getDiagnosisService

setDiagnosisService

getMedicationDispenseService

setMedicationDispenseService

getCohortService

setCohortService

getOrderSetService

getOrderService

getFormService

getSerializationService

getAdministrationService

getProgramWorkflowService

getLogicService

getSchedulerService

setSchedulerService

getAlertService

setAlertService

setProgramWorkflowService

setLogicService

getMessageService

setMessageService

getHL7Service

setHl7Service

setAdministrationService

setEncounterService

setLocationService

setFormService

setObsService

setOrderService

setOrderSetService

setSerializationService

getPatientService

setPatientService

getPersonService

setPersonService

getConceptService

setConceptService

getUserService

setUserService

getMessageSourceService

setMessageSourceService

addAdvisor

addAdvice

removeAdvisor

removeAdvice

getService

setService

setModuleService

setUseSystemClassLoader

isUseSystemClassLoader

setRefreshingContext

startRefreshingContext

doneRefreshingContext

isRefreshingContext

getRegisteredComponents

getRegisteredComponent

setApplicationContext

getApplicationContext

getModuleOpenmrsServices

getVisitService

setVisitService

getProviderService

setProviderService

getDatatypeService

setDatatypeService