Симон Робинсон - C# для профессионалов. Том II

Следующая диаграмма последовательностей показывает взаимодействие SCM — класса QuoteServiceи классов из пространства имен System.ServiceProcess. На диаграмме последовательностей просматриваются вертикальные линии жизни объектов и коммуникация, проходящая в горизонтальном направлении. Коммуникация упорядочена по времени сверху вниз:

SCM запускает процесс службы. Вначале вызывается метод Main(). В методе Main()нашей службы вызывается метод Run()базового класса ServiceBase. Run()регистрирует метод ServiceMainCallback()с помощью NativeMethods.StartServiceCtrlDispatcher()в SCM и записывает вход в журнал событий.

Следующий шаг — SCM вызывает зарегистрированный метод ServiceMainCallback()в нашей программе службы. ServiceMainCallbackсам регистрирует обработчик с помощью NativeMethods.RegisterServiceCtrlHandler[Ex]()и задает статус службы в SCM. Затем вызывается метод OnStart(), в котором мы должны реализовать код запуска. Если OnStart()выполнился успешно, то значение ресурса для StartSuccessfulзаписывается в журнал событий.

Обработчик реализуется в методе ServiceCommandCallback(). SCM вызывает этот метод, когда служба запрашивает изменения. Метод ServiceCommandCallback()направляет запросы далее в OnPause(), OnContinue(), OnStop(), OnCustomCommand()и OnPowerEvent().

Рассмотрим сгенерированную основную функцию служебного процесса. В ней объявляются массив ServiceToRunклассов ServiceBase. Один экземпляр класса QuoteServiceсоздается и передается как первый элемент массива ServiceToRun. Если должно выполняться более одной службы внутри этого служебного процесса, то необходимо добавить в массив больше экземпляров специальных служебных классов. Этот массив передается затем в статический метод Run()класса ServiceBase. С помощью метода Run()из ServiceBaseмы задаем ссылки SCM для точек входа служб. Основной поток выполнения служебного процесса теперь заблокирован и ожидает завершения службы.

Вот автоматически сгенерированный код:

// Основная точка входа для процесса

static void Main() {

System.ServiceProcess.ServiceBase[] ServicesToRun;

// Более одной службы пользователя может выполняться в одном процессе.

// Чтобы добавить другую службу в этот процесс, измените следующую

// строку для создания второго служебного объекта. Например:

// ServiceToRun = New System.ServiceProcess.ServiceBase[]

// {

// new WinService1(), new MySecondUserService()

// };

ServiceToRun = new System.ServiceProcess.ServiceBase[] {

new QuoteService()

};

System.ServiceProcess.ServiceBase.Run(ServiceToRun);

}

При наличии только одной службы можно удалить в процессе массив. Метод Run()получает один объект, производный из класса ServiceBase, поэтому функцию Main можно сократить до приведенного здесь кода:

System,ServiceProcess.ServiceBase.Run(new QuoteService());

Если существует более одной службы и для них требуется некоторая общая инициализация, то эта общая инициализация должна делаться до метода Run(), так как основной поток выполнения блокируется, пока служебный процесс не будет остановлен. Последующие инструкции остаются недоступными до конца службы.

Инициализация не может продолжаться слишком долго, время выполнения не должно превышать 30 с. Если код инициализации будет более длительным, то служебный управляющий менеджер предположит, что запуск службы отказал. Но необходимо принимать в расчет самые медленные машины, где эта служба также должна выполняться с учетом ограничения в 30 с. Если процесс продолжается дольше, можно запустить инициализацию в другом потоке выполнения, чтобы основной поток выполнения вызывал Run()вовремя. Объект события может затем использоваться для сигнализации того, что поток выполнения закончил свою работу.

При запуске службы вызывается метод OnStart(). Здесь может начать работу сервер сокета. Чтобы использовать QuoteServer, должна быть указана сборка Quote.Server.dll. Поток выполнения, вызывающий OnStart(), не может быть блокирован, этот метод возвращает управление вызывающей стороне, которая является методом ServiceMainCallback()класса ServiceBase. Класс ServiceBaseрегистрирует обработчик и информирует SCM после вызова OnStart(), что служба успешно запущена:

///

/// Задает вещи по ходу, чтобы служба могла делать свою работу.