Daemon Service
IDaemonService
in assembly SanteDB.Core.Api version 2.1.151.0
Summary
Defines a service which follows the daemon service pattern ()
Description
In SanteDB (and OpenIZ) a daemon service is an actively executed service which is started on application host start and torn down/stopped on application context shutdown (or when initiated by a user).
The Start method is invoked on startup. It is expected that implementer of this class will raise the Starting event to signal to other services in the application context that this particular service is starting. Once the initialization process is complete, the implementation should call the Started event to signal this service has completed its necessary start, before returning true from the start method. This behavior allows chaining of dependent services together (i.e. don't start until after start of another service)
On service teardown the Stop method is called, again it is expected that implementers will raise Stopping and then Stopped
If the daemon also implements the .NET IDisposable interface, then the Dispose method is called after service shutdown.
Events
Event | Type | Description |
---|---|---|
Starting | EventHandler | Fired when the daemon service has commenced start but has not yet finished |
Started | EventHandler | Fired when the daemon service has completed it start procedure. |
Stopping | EventHandler | Fired when the daemon service has commenced stop but has not yet been fully shut down. |
Stopped | EventHandler | Fired when the daemon has completed its stop procedure |
Properties
Property | Type | Access | Description |
---|---|---|---|
IsRunning | Boolean | R | Indicates whether the daemon service is running |
Operations
Operation | Response/Return | Input/Parameter | Description |
---|---|---|---|
Start | Boolean | none | TODO |
Stop | Boolean | none | TODO |
Implementations
OAuth 2.0 Messaging Service - (SanteDB.Authentication.OAuth2)
Represents a IApiEndpointProvider which serves OpenID Connect and OAUTH requests
Description
This service is responsible for starting and maintaining the OAuthTokenBehavior REST service which is responsible for supporting SanteDB's OpenID Connect interface
Service Registration
Memory Cache Service - (SanteDB.Caching.Memory)
Implementation of the IDataCachingService which uses the in-process memory to cache objects
Description
The memory cache service uses the MemoryCache class as a backing cache for the SanteDB host instance. This caching provider provides benefits over a common, shared cache like REDIS in that:
It does not require the setup of a third-party service to operate
The cache objects are directly accessed and not serialized
The cache objects are protected within the host process memory
The access is very fast - there is no interconnection with another process
This cache service should only be used in cases when there is a single SanteDB server and there is no need for sharing cache objects between application services.
This class uses the TTL setting from the MemoryCacheConfigurationSection to determine the length of time that cache entries are valid
Service Registration
RedisAdhocCache - (SanteDB.Caching.Redis)
An implementation of the IAdhocCacheService which uses REDIS as the cache provider
Description
This implementation of the REDIS ad-hoc cache provider serializes any data passed via TimeSpan})) to a JSON representation, then compresses (optional) the data and stores it in REDIS as a simple string
The data is stored in database 3 of the REDIS server
Service Registration
REDIS Data Caching Service - (SanteDB.Caching.Redis)
An implementation of the IDataCachingService which uses REDIS
Description
This implementation of the caching service uses the XMLSerializer in .NET to serialize any object passed in via the IdentifiedData)) method. The data is then compressed (if configured) and sent to the configured REDIS server.
The use of the .NET XML serializer over the Newtonsoft JSON serializer for caching was chosen since the serializer operates on streams (saves string conversions) and pre-compiles the serialization classes on .NET Framework implementations (Mono implementations use relfection)
The caching data is stored in database 1 of the REDIS server.
Service Registration
REDIS Query Persistence Service - (SanteDB.Caching.Redis)
An implementation of the IQueryPersistenceService which usees REDIS for its stateful result set
Description
This persistence service uses REDIS list values to store the UUIDs representing the query executed on the SanteDB server. The data is stored in database 2 of the REDIS server.
Service Registration
Security Audit Service - (SanteDB.Core.Api)
An implementation of IDaemonService which monitors instances of IIdentityProviderService and ISessionIdentityProviderService to audit login and logout events in the audit repository
Service Registration
PubSubBroker - (SanteDB.Core.Api)
An implementation of the IDaemonService which is responsible for monitoring the IPubSubManagerService for new subscription events
Description
The Pub/Sub broker is the central daemon which is responsible for coordinating outbound notifications based on filters established by subscribers. The broker:
Listens to the
Subscribe
event on the IPubSubManagerService and creates a callback for the data eventEnqueues any new data to the IDispatcherQueueManagerService for sending to outbound recipients
When a IDispatcherQueueManagerService message is enqueued, loads the appropriate IPubSubDispatcherFactory and publishes the notification
Service Registration
DependencyServiceManager - (SanteDB.Core.Api)
The core implementation of IServiceProvider and IServiceManager that supports SanteDB's dependency injection technology.
Description
The dependency injection service manager is responsible for:
Maintaining singleton or per-call instances registered in the ApplicationServiceContextConfigurationSection
Determining the dependencies of each service via
CreateInjected()
and ensuring they exist and are constructed for injectionValidating the digital signatures on assembly files which are used by the SanteDB system (see: Digital Signing Requirements)
Calling any IServiceFactory instance to attempt to construct missing services
Coordinating the lifecycle of IDaemonService instances
Note: You must have an IConfigurationManager instance registered in the application service context prior to calling the Start()
method on this class
Service Registration
Default Job Manager - (SanteDB.Core.Api)
SanteDB's default implementation of the IJobManagerService
Description
Service Registration
SimDataManagementService - (SanteDB.Core.Api)
Represents a IDataManagementPattern which uses destructive merge and matching in order to contain a single instance.
Description
The SIM data management service implements the Single Instance Mode of storage pattern. The single instance mode:
Maintains a single copy of a record in the CDR
Attempts to perform duplicate detection between these single instances
When a merge occurs, the subsumed record is obsoleted (and later purged)
Unmerge is not possible
Service Registration
DataQualityService - (SanteDB.Core.Api)
A IDaemonService which registers DataQualityBusinessRule`1 against configured targets
Service Registration
AppletSubscriptionRepository - (SanteDB.Core.Applets)
An implementation of the ISubscriptionRepository that loads definitions from applets
Service Registration
AgsService - (SanteDB.DisconnectedClient.Ags)
The Applet Gateway Service
Description
The AGS service is responsible for starting the REST based services for the dCDR instance and is responsible for maintaining and managing these services through the life cycle including:
Service Registration
BluetoothPeerToPeerShareService - (SanteDB.DisconnectedClient.UI)
An implementation of the IPeerToPeerShareService which sends and receives data over bluetooth
Description
The bluetooth peer to peer sharing service allows SanteDB plug-ins to request and receive ad-hoc data between peers using bluetooth file sharing
Service Registration
Administrative Management Interface - (SanteDB.Messaging.AMI)
An implementation of the IApiEndpointProvider which hosts and manages the Administrative Management Interface REST services.
Description
This service is responsible for starting up and shutting down the REST services for the AMI, as well as
Service Registration
FhirDataInitializationService - (SanteDB.Messaging.FHIR)
Scans the configured directory on application startup to import or seed data into SanteDB from FHIR
Description
This service, like the DataInitializationService reads FHIR resource files in the configured directory and imports the data from those files (on system startup) into the CDR instance. FHIR resource files can be either .xml
or .json
instances.
After data is processed the import process will rename the input file as .complete
and will emit an equivalent file suffixed with -response
to indicate any information returned by the FHIR handler for the contained resources.
Service Registration
HL7 FHIR R4 API Endpoint - (SanteDB.Messaging.FHIR)
Implementation of an IApiEndpointProvider for HL7 Fast Health Interoperability Resources (FHIR) REST Interface
Description
The FHIR based message handler is responsible for starting the IFhirServiceContract REST service and enables SanteDB's FHIR REST services. Consult the org/developers/service-apis/hl7-fhir/enabling-fhir-interfaces documentation for more information on enabling these services in SanteDB.
Service Registration
GS1 Stock Event Subscriber - (SanteDB.Messaging.GS1)
Represents a notification service that listens to stock events and then prepares them for broadcast
Description
This service is obsolete and will be replaced using the PubSubBroker implementation and IPubSubDispatcherFactory implementation instead.
Service Registration
GS1 BMS XML3.3 API Endpoint - (SanteDB.Messaging.GS1)
GS1 Business Messaging Standard (BMS) HTTP / REST implementation of IApiEndpointProvider
Description
This service is responsible for maintaining the lifecycle of the IStockService REST contract which implements SanteDB's GS1 BMS API.
Service Registration
GS1 AS2(ish) Integration Service - (SanteDB.Messaging.GS1)
GS1 AS.2 stock event notification service
Description
This class is obsolete and will be migrated to the IPubSubDispatcherFactory implementations in future versions of SanteDB.
Service Registration
Health Data Services Interface - (SanteDB.Messaging.HDSI)
Implementation of IApiEndpointProvider for the Health Data Services Interface REST service
Description
The HDSI message handler is responsible for the maintenance and lifecycle of SanteDB's Health Data Service Interface. The service starts the necessary REST and query services on start and tears them down on system shutdown.
Service Registration
HL7v2 API Endpoint - (SanteDB.Messaging.HL7)
Implementation of the IApiEndpointProvider providing support for Health Level 7 Version 2.x messaging
Description
This service is responsible for starting up and tearing down the various IHL7MessageHandler interfaces configured for SanteDB's implementation of HL7v2 support. This service starts up the necessary ITransportProtocol interfaces and initializes the message handlers for receiving and handling inbound messages on LLP, SLLP, or TCP.
Service Registration
OpenAPI Metadata Exchange - (SanteDB.Messaging.Metadata)
Represents the daemon service that starts/stops the OpenApi information file
Service Registration
ADO.NET Data Persistence Service - (SanteDB.Persistence.Data.ADO)
Registers and configures the necessary sub-services and IDataPersistenceService implementations to allow SanteDB iCDR to persist, query, and read messages from available ADO.NET data providers
Description
This service is responsible for registering the necessary IDataPersistenceService providers which are responsible for interfacing the SanteDB Physical Model with the SanteDB Business / Object Model. Each persistence implementation is derived from the ModelMap configuration, and is uses the ADO.NET classes to via the IDbProvider configured.
Additionally, on start of the SanteDB iCDR or dCDR, this service is responsible for applying any Data Patches which have been provided (compiled via an embedded resource) by any of the validated SanteDB plugins.
Service Registration
MDM Data Repository - (SanteDB.Persistence.MDM)
An implementation of the IDataManagementPattern which keeps multiple copies of source records and maintains linkages with a single master record.
Description
The MDM data management service provides the Master Data Storage pattern for SanteDB. This service is responsible for creating subscribers to listen to events from the IRepositoryService layer in SanteDB and take appropriate actions to seggregate source information form record of truth information. Additionally, this service registers implementations of IFreetextSearchService, IRecordMatchingService, IRecordMergingService and ISubscriptionExecutor functionality to ensure the freetext and subscription requests are properly handled and synthesized.
Service Registration
Business Intelligence Service - (SanteDB.Rest.BIS)
Represents a message handler for the BIS
Service Registration
Local (database) repository service - (SanteDB.Server.Core)
Registers the IRepositoryService instances with the core application context and provides a IServiceFactory implementation to construct repository services.
Description
The instances of IRepositoryService which this service constructs contact directly with the equivalent IDataPersistenceService for each object. The repository layers add business process logic for calling IBusinessRulesService, IPrivacyEnforcementService, and others as necessary to ensure secure and safe access to the underlying data repositories. All requests to any IRepositoryService constructed by this service use the AuthenticationContext to establish "who" is performing the action.
Service Registration
Local Applet Repository/Manager - (SanteDB.Server.Core)
Represents an applet manager service that uses the local file system
Service Registration
Applet JavaScript BRE - (SanteDB.Server.Core)
A daemon which loads business rules from the applet manager
Service Registration
Dataset Installation Service - (SanteDB.Server.Core)
Data initialization service
Description
This service reads data from the configured directory (usually the data/
directory) with extension .dataset
and imports the data into the SanteDB iCDR instance. Each Dataset file is then renamed to .completed
to indicate that the import of the provided data was successful. This service allows SanteDB instances to share information between deployments easily.
For more information consult the Distributing Data files
Service Registration
Debugger: Data Sandbox UI - (SanteDB.Tools.Debug)
TODO: Document this
Service Registration
File Based BI Repository - (SanteDB.Tools.Debug)
TODO: Document this
Service Registration
Example Implementation
References
Last updated