打开APP
userphoto
未登录

开通VIP,畅享免费电子书等14项超值服

开通VIP
条款22:使用事件定义外发接口
事件为类型定义了外发接口(outgoinginterface)。C#的事件建立在委托之上,委托为事件处理器(event handler)提供了类型安全的函数签名。由于绝大多数使用委托的例子都是事件,一些开发人员便开始认为事件和委托是同一种东西。在条款21中,我向大家展示了“可以使用委托,但却没有定义事件”的例子。当我们的类型必须和多个客户通信,并为它们提供系统中的行为通知时,我们才应该触发事件。
考虑一个简单的例子。我们正在创建一个日志类,来派发应用程序中的所有消息。它会从应用程序中的消息源接受所有消息,然后将它们派发给感兴趣的侦听者。这些侦听者可能会被连接到控制台、数据库、系统日志或者其他一些机制上。我们可以像下面这样定义这个类,当有消息到达时便触发一个事件:
public class LoggerEventArgs : EventArgs
{
  public readonly string Message;
  public readonly int Priority;
  public LoggerEventArgs ( int p, string m )
  {
    Priority = p;
    Message = m;
  }
}
// 定义事件处理器的签名:
public delegate void AddMessageEventHandler( objectsender,  LoggerEventArgs msg );
public class Logger
{
  private staticLogger _theOnly = null;
  private Logger( )
  {
  }
 static Logger( )
  {
    _theOnly = new Logger( );
  }
  public Logger Singleton
  {
    get
    {
      return _theOnly;
    }
  }
  // 定义事件:
  public event AddMessageEventHandler Log;
  // 添加一个消息,并做日志记录。
  public void AddMsg ( int priority, string msg )
  {
    // 下面将讨论这个惯常做法。
    AddMessageEventHandlerl = Log;
    if ( l != null )
      l ( null, new LoggerEventArgs(priority, msg ) );
  }
}
AddMsg ()方法展示了触发事件的正确方法。其中,引用Log事件处理器的临时变量是一个重要的安全措施,它可以应对多线程环境中的竞争条件。如果没有这个引用的副本,客户代码可能会在if判断语句和事件处理器执行之间删除事件处理器。通过对引用的副本,这种事情就不会发生了。
LoggerEventArgs 类中定义了事件的优先级和消息内容。AddMessageEventHandler委托则为事件处理器定义了签名。在Logger类内部,事件字段Log 定义了事件处理器。编译器看到这个公有的事件字段定义后,会为我们创建对应的Add和Remove操作符。编译器产生的代码就好像我们编写了如下的代码一 样:
public class Logger
{
  private AddMessageEventHandler _Log;
  public event AddMessageEventHandler Log
  {
    add
    {
      _Log = _Log + value;
    }
    remove
    {
      _Log = _Log - value;
    }
  }
    public void AddMsg (int priority,string msg)
    {
      AddMessageEventHandlerl = _Log;
      if (l != null)
        l (null,new LoggerEventArgs (priority, msg));
    }
  }
}
C#编译器会为我们定义的事件创建add和 remove访问器。我认为公有的事件声明更简练,更易于阅读和维护,也更正确。当我们在自己的类中创建事件时,应该声明公有事件,然后让编译器为我们创建add和remove属性。只有在需要添加额外的规则时,我们才应该自己编写这些处理代码。
事件并不需要知道潜在的侦听者。下面的类会自动将所有消息发送给标准错误控制台:
class ConsoleLogger
{
  static ConsoleLogger()
  {
    Logger.Log += newAddMessageEventHandler( Logger_Log );
  }
  private static void Logger_Log( object sender,LoggerEventArgs msg )
  {
    Console.Error.WriteLine("{0}:\t{1}", msg.Priority.ToString(), msg.Message );
  }
}
下面的类则可以将消息输出到系统事件日志中:
class EventLogger
{
  private static string eventSource;
  private static System. Diagnostics. EventLoglogDest;
  static EventLogger()
  {
    logger.Log +=newAddMessageEventHandler( Event_Log );
  }
  public static string EventSource
  {
    get
    {
      return eventSource;
    }
    set
    {
      eventSource = value;
      if ( !EventLog.SourceExists( eventSource ) )
       EventLog.CreateEventSource( eventSource, "ApplicationEventLogger" );
      if ( logDest != null )
       logDest.Dispose( );
      logDest = new EventLog();
      logDest.Source =eventSource;
    }
  }
  private static void Event_Log( object sender, LoggerEventArgsmsg )
  {
    if ( logDest != null )
      logDest.WriteEntry(msg.Message, EventLogEntryType.Information, msg.Priority );
  }
}
事件发生时,它会通知所有感兴趣的客户对象。因此,Logger类不需要预先知道哪些对象对日志事件感兴趣。
Logger 类只包含了一个事件。但也有一些类(绝大多数是Windows控件)包含的事件数量非常多。这时候,为每个事件都定义一个字段的做法是不可接受的。在某些情况下,只有很少的事件会在程序中真正发挥作用。当遇到这种情况时,我们可以改变设计,根据运行时的需要动态创建事件对象。
.NET框架内核在Windows控件子系统中包含有这方面的做法示例。为了演示其中的做法,这里会向Logger类添加一些子系统。我们可以为每个子系统创建一个事件。客户则会登记和它们的子系统相关的事件。
扩展后的Logger类包含一个 System.ComponentModel.EventHandlerList容器,该容器中存储着所有的事件对象,这些事件将会针对具体的子系统来被触发。更新后的AddMsg()方法现在接受一个字符串参数,用于指定产生日志消息的子系统。如果子系统有侦听者,那么事件就会被触发。另外,如果一个事件侦听者登记了所有的消息,它的事件也会被触发:
public class Logger
{
  private staticSystem.ComponentModel.EventHandlerList
    Handlers = newSystem.ComponentModel.EventHandlerList();
  static public void AddLogger(string system,AddMessageEventHandler ev )
  {
    Handlers[ system ] = ev;
  }
  static public void RemoveLogger( string system)
  {
    Handlers[ system ] = null;
  }
  static public void AddMsg ( string system, intpriority,  string msg )
  {
    if (system != null  &&  system.Length > 0)
    {
      AddMessageEventHandler l = Handlers[ system] as AddMessageEventHandler;
      LoggerEventArgs args = newLoggerEventArgs(priority, msg );
      if ( l != null )
        l ( null,args );
      // 空字符串意味着接受所有消息:
      l = Handlers["" ] as AddMessageEventHandler;
      if ( l != null )
        l( null,args );
    }
  }
}
class ConsoleLogger  //事件的监听者、具体处理者
{
  static ConsoleLogger()
  {
    Logger. AddLogger(“Consoler”, new AddMessageEventHandler(Logger_Log ));
  }
  private static void Logger_Log( object sender,LoggerEventArgs msg )
  {
    Console.Error.WriteLine("{0}:\t{1}", msg.Priority.ToString(), msg.Message );
  }
}
class EventLogger  //事件的监听者、具体处理者
{
  private static string eventSource;
  private static System. Diagnostics. EventLoglogDest;
  static EventLogger()
  {
    logger.AddLoger(“EventLogger”,new AddMessageEventHandler(Event_Log ));
  }
  public static string EventSource
  {
    get
    {
      return eventSource;
    }
    set
    {
      eventSource = value;
      if ( !EventLog.SourceExists( eventSource ) )
       EventLog.CreateEventSource( eventSource, "MyLogType" );
//第一个参数对应左边目录树节点中的'来源'名称,第二个参数表示控制面板中的'事件查看器'左边的目录树节点
      if ( logDest != null )
       logDest.Dispose( );
      logDest = new EventLog();
      logDest.Source =eventSource;
    }
  }
  private static void Event_Log( object sender, LoggerEventArgsmsg )
  {
    if ( logDest != null )
      logDest.WriteEntry(msg.Message, EventLogEntryType.Information, msg.Priority );
  }
}
private void button1_Click(objectsender, EventArgs e)
{         
    ConsoleLogger l = new ConsoleLogger(); //注册事件
    Logger.AddMsg("Console",1, "Console Output"); //触发事件
      //下面一行代码说明事件也不必非要有订阅者才能正常工作
      EventLogger.EventSource= "RogerLog";//对应事件查看器左边目录树节点中的'来源'名称         
      Logger.AddMsg("EventLogger",1, "Event Output"); //触发事件
  }
上面的代码会在EventHandlerList集合中存储各个事件处理器。当客户代码关联到一个特定的子系统上时(只要一使用这个定义的对象,如EventLogger),新的事件对象就会被创建, 事件就会被注册。对同一个子系统的后续请求会获取相同的事件对象。如果我们的类在其接口中包含有大量的事件,我们就应该考虑使用这样的事件处理器集合。当客户代码真正关联有事件处理器时(如调用EventLogger.EventSource时候,会注册事件成员,即创建事件成员),我们才会创建事件成员。在.NET框架内部,System.Windows.Forms.Control类使用了一种更复杂的实现,来隐藏所有事件字段操作的复杂性。每一个事件字段在内部会通过访问一个对象集合,来添加和删除特定的处理器。大家可以在C#语言规范(参见条款49)中找到有关这种常见做法的更多信息。
综上所述,我们使用事件来定义类型中的外发接口, 任意数量的客户对象都可以将自己的处理器登记到事件上,然后处理它们。这些客户对象不需要在编译时存在。事件也不必非要有订阅者才能正常工作。在C#中使用事件可以对发送者和可能的通知接受者进行解耦。发送者可以完全独立于接收者进行开发。事件是一种广播类型行为信息的标准方式。
本站仅提供存储服务,所有内容均由用户发布,如发现有害或侵权内容,请点击举报
打开APP,阅读全文并永久保存 查看更多类似文章
猜你喜欢
类似文章
【热】打开小程序,算一算2024你的财运
自己实现数据库连接池-数据库连接池的设计思路及java实现
Android应用程序框架层和系统运行库层日志系统源代码分析
log4j2 扩展日志级别,支持将系统日志与业务处理日志拆分
从零实现一个日志框架(带源码)
事件驱动 _2
IBM MQ JAVA引MQ小例子
更多类似文章 >>
生活服务
热点新闻
分享 收藏 导长图 关注 下载文章
绑定账号成功
后续可登录账号畅享VIP特权!
如果VIP功能使用有故障,
可点击这里联系客服!

联系客服