52 lines
3.2 KiB
Markdown
52 lines
3.2 KiB
Markdown
---
|
|
source_files:
|
|
- Common/DTS.Common.Service/ProjectInstaller.cs
|
|
- Common/DTS.Common.Service/Program.cs
|
|
- Common/DTS.Common.Service/DTSService.Designer.cs
|
|
- Common/DTS.Common.Service/DTSService.cs
|
|
- Common/DTS.Common.Service/ProjectInstaller.Designer.cs
|
|
generated_at: "2026-04-17T16:02:06.149898+00:00"
|
|
model: "zai-org/GLM-5-FP8"
|
|
schema_version: 1
|
|
sha256: "c917bed8fd5b39aa"
|
|
---
|
|
|
|
# DTS.Common.Service
|
|
|
|
### Purpose
|
|
This module implements a generic Windows Service application template for DTS (Diversified Technical Systems) common services. It provides a reusable service infrastructure with event logging, configurable monitoring via timers, and support for custom commands. The service is configured to run under the LocalSystem account with automatic startup.
|
|
|
|
### Public Interface
|
|
|
|
**ProjectInstaller** (class)
|
|
- `ProjectInstaller()` - Constructor that initializes the service installer components. Marked with `[RunInstaller(true)]` for InstallUtil.exe deployment.
|
|
|
|
**Program** (static class)
|
|
- `static void Main()` - Application entry point that creates and runs a `DTSService` instance via `ServiceBase.Run()`.
|
|
|
|
**DTSService** (class, inherits `ServiceBase`)
|
|
- `DTSService()` - Constructor that initializes the event log source, configures logging, and optionally starts a monitoring timer if `Settings.Default.Monitoring` is enabled with interval from `Settings.Default.Interval`.
|
|
- `void OnTimer(object sender, ElapsedEventArgs args)` - Timer callback that writes "Monitoring the System" to the event log. Contains a TODO comment for monitoring activities.
|
|
- `protected override void OnStart(string[] args)` - Writes a service started entry to the event log.
|
|
- `protected override void OnStop()` - Writes a service stopped entry to the event log.
|
|
- `protected override void OnCustomCommand(int command)` - Handles custom service commands. Supports `Command1` (128), `Command2` (129), and `Command3` (130) via the `CustomCommands` enum.
|
|
- `CustomCommands` (enum) - Defines custom command values: `Command1 = 128`, `Command2 = 129`, `Command3 = 130`.
|
|
- `eventLog` (public field, `System.Diagnostics.EventLog`) - Event log instance for writing service entries.
|
|
|
|
### Invariants
|
|
- The event log source must exist before being used; the constructor creates it if it doesn't exist.
|
|
- The timer is only created and started if `Settings.Default.Monitoring` is `true`.
|
|
- Custom commands use values starting at 128.
|
|
- The service is installed with `ServiceAccount.LocalSystem`, `ServiceStartMode.Automatic`, and `ServiceName = "DTSService"`.
|
|
|
|
### Dependencies
|
|
- **Depends on**: `System.Configuration.Install`, `System.ServiceProcess`, `System.Diagnostics`, `System.Timers`, `DTS.Common.Service.Properties` (Settings).
|
|
- **Depended on by**: Not evident from source alone; this is a top-level executable service application.
|
|
|
|
### Gotchas
|
|
- The `OnTimer` method contains only a TODO comment and event log write; actual monitoring logic is not implemented.
|
|
- The `OnCustomCommand` switch cases are empty—no actual command handling logic exists.
|
|
- The timer variable in the constructor is a local variable, not a class field, which could lead to garbage collection issues.
|
|
- The designer file comment references "CPUService" but the actual class is `DTSService`, suggesting copy-paste history.
|
|
|
|
--- |