编写 Window 服务程序

编写  Window  服务程序
 
 

1、直观认识Windows服务。

       打开Windows“控制面板/管理工具/服务”,系统显示Windows服务列表。
       
 
 
       双击服务,能够显示和更改服务属性。在这个对话框中,能够控制服务的启动、暂停和中止。在这里还能够配置服务的启动类型,令服务在系统启动时自行启动。所以,Windows服务常常做为服务器程序运行。
       
 
       在故障恢复这个属性页,能够配置该服务失败后系统的相应。一些病毒程序就是在这里作文章,将病毒程序激活的。
       
 
 

2、Windows服务的开发要点

        Visual Studio的随机文档里,详细介绍了Windows服务程序的开发步骤,而且带有实例,笔者再也不赘述。读者只需注意几个要点:
        一、建立一个派生自ServiceBase的入口类。这个入口类管理这个Windows服务的生存期。
 
     public class MyService : System.ServiceProcess.ServiceBase
     {
         ……
     }
 
        二、在入口类的main方法里将服务向Windows的服务控制器(Service Control Manager, SCM)注册,代码:
 
       ……
         System.ServiceProcess.ServiceBase[] ServicesToRun;
         ServicesToRun = new System.ServiceProcess.ServiceBase[] { new MyService() };
         System.ServiceProcess.ServiceBase.Run(ServicesToRun);
         ……
 
        三、重写  OnStart 、 OnStop ,或 OnPause 和  OnContinue 方法来响应服务状态的更改。一般须要重写 OnStart 方法,结束服务时在 OnStop 方法中释放资源,酌情重写 OnPause 和  OnContinue方法。
        四、Windows服务一般启动一个定时器来定时或轮询进行业务处理。
        五、Windows服务须要安装后才能使用。一般经过两个办法安装Windows服务:
  • 在命令行运行InstallUtil.exe;
  • 在Windows服务程序的代码中添加ProjectInstraller类的实例,里面包含ServiceProcessInstaller类和ServiceInstaller类的实例。
        上述两个办法在Framework的随机文档中均有描述,在此再也不赘述。
        六、Windows服务在Windows的服务控制器(Service Control Manager, SCM)中运行,所以调试起来不像其余Visual Studio应用程序那样简单。关于Windows服务的调试,在Visual Studio的随机文档里面有介绍,在此再也不赘述。

3、Windows服务的异常处理

        Windows服务没有用户界面,在运行过程当中难以将异常通知给用户。一般状况下,Windows服务在运行过程当中发生了异常,可能致使服务运行挂起,但没有任何提醒。
        推荐的一个作法是在Windows服务中捕获异常,并把异常信息写在Windows的事件日志中。打开Windows的“控制面板/管理工具/事件查看器”,系统显示Windows事件日志。
        
 
        在一个实际的应用中,笔者除了把异常和提示记录在事件日志中,还把严重错误自动经过邮件发送给相关人员。同时,全部记录在事件日志中的信息,还重定向到一个自行开发的控制台程序中,用以随时监控服务。
        
 

3、Windows事件日志的开发要点和技巧

        Visual Studio的随机文档里,在介绍Windows服务程序的开发步骤的同时,也介绍了如何向Windows服务中加入事件日志,笔者再也不赘述。开发要点以下:
        一、在须要写入日志的类中建立EventLog的实例eventLog,在构造函数里加入代码:
     if (!System.Diagnostics.EventLog.SourceExists("mySource"))
     {        
     System.Diagnostics.EventLog.CreateEventSource("mySource","myEventLog");
     }
     eventLog.Source = " mySource ";
     eventLog.Log = " myEventLog ";
    二、在须要写事件日志的地方写日志,例如:
     protected override void OnStop()
     {
         eventLog.WriteEntry("In onStop.");
     }
 
         读者能够在实际应用中尝试使用下面的技巧。
         一、把写Windows事件日志的代码封装成独立的class,这样不只在Windows服务中,并且在其余的业务代码中均可以使用Windows事件日志。代码见附件。
        二、为方便调试和跟踪,Visual Sdudio提供了Trace类。在应用程序的debug编译版本中,用Trace类能够把调试和跟踪信息写到控制台。有一个技巧,能够同时把写入Trace的内容写入Windows事件日志。要点以下:
        首先声明一个事件监听类EventLogTraceListener的实例,
          static private  EventLogTraceListener cTraceListener = new EventLogTraceListener( m_eventLog );
        将EventLogTraceListener的实例加入Trace的监听列表:
          Trace.Listeners.Add( cTraceListener );
        此后,凡是写入Trace的调试信息,均写入Windows事件日志中。若是不但愿将Trace继续写入事件日志,运行下面代码便可:
          Trace.Listeners.Remove( cTraceListener );
   
        三、写入事件日志的信息,还能够同时写入其余应用程序窗体中的显示控件。
        首先打开窗体的设计视图,从工具箱/组件中选择EventLog并加入窗体,配置EventLog的EnableRaisingEvents属性为True。
        加入EventLog的EntryWritten事件处理方法,该事件的第二个参数类行为System.Diagnostics.EntryWrittenEventArgs,其中包含了Windows事件日志条目中的必要内容,将该内容显示在窗体中的某个显示控件中便可。示例代码以下:
/// <summary>
/// 监听事件日志
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void eventLog_EntryWritten(object sender,
     System.Diagnostics.EntryWrittenEventArgs e)
{
     try
     {
         // 把日志内容写到名为listEventLog的List控件中
         listEventLog.Items.Insert( 0,
              e.Entry.TimeWritten + " " +
              e.Entry.Message );
 
         // List控件保存不超过500行的日志
         while( listEventLog.Items.Count > 500 )
         {
              listEventLog.Items.RemoveAt( listEventLog.Items.Count-1 );
         }
     }
     catch( Exception ex )
     {
         MessageBox.Show( ex.Message );
     }
}

4、与Windows服务的通信

       在应用程序或其余服务中,能够与Windows服务通信,包括:
  •          管理Windows服务的生命期,即开启、中止、暂停和重启服务;
  •          得到Windows服务的属性和状态;
  •          得到特定计算机上的服务列表;
  •          向特定的服务发送命令。
        这些操做是经过ServiceController 类完成的。ServiceController是一个可视化控件,能够在工具箱中找到。
        比较有意思的是ServiceController 中ExecuteCommand这个方法,调用这个方法,能够向Windows服务发送命令,指挥Windows服务的一些操做。例如,在Windows服务的入口类中有一个复写OnCustomCommand()的方法:
         /// <summary>
         /// 执行用户自定义消息
         /// </summary>
         /// <param name="command">消息编号</param>
         protected override void OnCustomCommand( int command )
         {
              try
              {
                   switch( command )
                   {
                       case 1: // 业务操做
                            doBusiness1();
                            break;
                       case 2: //业务操做
                            doBusiness2();
                            break;
                       default:
                            ……
                            break;
                   }
              }
              catch( Exception ex )
              {
                   // 错误信息
                   string strErrorMsg = string.Format("异常:{0}/n", ex.Message );
                   // 写日志
                   TLineEventLog.DoWriteEventLog( strErrorMsg, EventType.Error );
                   // 给管理员发邮件
                   CMail.SendMail(
PropertyManager.strMailFromAddress, PropertyManager.strMailAdminAddress, "",
                       "异常信息提示",
strErrorMsg );
                   // 写Trace
                   Trace.WriteLine( strErrorMsg );
              }
         }
        在另一个应用程序中经过ServiceController的ExecuteCommand()方法向这个Windows服务发送命令:
            myController.ExecuteCommand(2);
        Windows服务将执行业务方法:doBusiness2();
        应该认可,利用ServiceController与Windows服务通信的功能目前还十分薄弱。经过ExecuteCommand只能与Windows服务进行简单而有限的通信。
        笔者在实际的应用中,分别用一个命令行程序、一个控制台程序和一个Webservice和Windows服务进行通信,启动、中止服务,或经过ExecuteCommand控制服务的行为。
        
 

附件:操纵Windows事件日志的通用类

using System;
using System.Diagnostics;
using System.Configuration;
 
namespace MYCOMMON.EVENTLOG
{
     public enum EventType { Error,Information,Warning }
     /// <summary>
     ///
     /// </summary>
     public class TLineEventLog
     {
         // 任务日志
         static private EventLog m_eventLog = new EventLog();
         // 源名称,从配置文件中读取
         static private string m_strEventSource =
              ConfigurationSettings.AppSettings["f_eventLog.Source"].ToString().Trim();
         // 日志名称,从配置文件中读取
         static private string m_strEventLog =
              ConfigurationSettings.AppSettings["f_eventLog.Log"].ToString().Trim();
 
         // 调试信息写入日志
         static private EventLogTraceListener cTraceListener =
              new EventLogTraceListener( m_eventLog );
 
         // 缺省构造函数。配置文件读取失败时,提供默认的源名称和日志名称
         public TLineEventLog()
         {
              if( m_strEventSource.Length == 0 )
                   m_strEventSource = "mySource";
 
              if( m_strEventLog.Length == 0 )
                   m_strEventLog    = "myLog";
 
              m_eventLog.Source = m_strEventSource;
              m_eventLog.Log    = m_strEventLog;
         }
 
         // 构造函数。提供源名称和日志名称。
         public TLineEventLog( string strEventSource, string strEventLog )
         {
              m_strEventSource = strEventSource;
              m_strEventLog    = strEventLog;
              m_eventLog.Source = m_strEventSource;
              m_eventLog.Log    = m_strEventLog;
     }
 
         /// <summary>
         /// 写事件日志
         /// </summary>
         /// <param name="strMessage">事件内容</param>
         /// <param name="eventType">事件类别,错误、警告或者消息</param>
         static public void DoWriteEventLog( string strMessage, EventType eventType )
         {
              if (!System.Diagnostics.EventLog.SourceExists( m_strEventSource ))
              {         
                   System.Diagnostics.EventLog.CreateEventSource(
                       m_strEventSource,m_strEventLog );
              }
 
              EventLogEntryType entryType = new EventLogEntryType();
              switch(eventType)
              {
                   case EventType.Error:      
                       entryType = EventLogEntryType.Error;
                       break;
                   case EventType.Information:
                       entryType = EventLogEntryType.Information;
                       break;
                   case EventType.Warning:    
                       entryType = EventLogEntryType.Warning;
                       break;
                   default:                   
                       entryType = EventLogEntryType.Information;
                       break;
              }
              m_eventLog.WriteEntry( strMessage, entryType );
         }
 
         /// <summary>
         /// 写事件日志,默认为消息
         /// </summary>
         /// <param name="strMessage">事件内容</param>
         static public void DoWriteEventLog( string strMessage )
         {
              if (!System.Diagnostics.EventLog.SourceExists( m_strEventSource ))
              {        
                   System.Diagnostics.EventLog.CreateEventSource(
                       m_strEventSource,m_strEventLog );
              }
              m_eventLog.WriteEntry( strMessage );
         }
 
         /// <summary>
         /// 调试信息写入日志
         /// </summary>
         public static void OpenTrace()
         {
              if( cTraceListener != null )
              {
                   if( !Trace.Listeners.Contains( cTraceListener ) )
                   {
                       Trace.Listeners.Add( cTraceListener );
                   }
              }
         }
 
         /// <summary>
         /// 调试信息不写入日志
         /// </summary>
         public static void CloseTrace()
         {
              if( Trace.Listeners.IndexOf(cTraceListener) >= 0 )
              {
                   Trace.Listeners.Remove( cTraceListener );
              }
         }
     }
}
 
做者简介:张昱,联想利泰软件公司(原联想软件设计中心) e-zhangyu@vip.sina.com
相关文章
相关标签/搜索