Composite UI Application Block学习笔记之Even

     Composite UI Application Block着重于将应用逻辑和界面分开，让应用系统具备更清晰的结构，更强的扩展性、可移植性。在曹严明先生的讲座中，提及到了关于应用CAB开发的几个指导性原则：

• 将 views （SmartPart）设计为独立于 controllers 的单元
• 共享模块状态
• 共享基础服务
• 封装用例 － 重用
• 降低模块间的依赖性
• 尽量使用 events, services, and interfaces

     我在学习的过程中也理解到以上原则的重要性和指导性，在我学习模块状态和Event Broker的过程中，也将上述部分原则做了特意的应用。那么我们还是通过一个实例来学习Event Broker和这些原则。

一、文中有关术语

    下面这些术语是CAB中常用到的，以下的解释仅是我个人的理解，不敢保证完全准确，园子里的朋友请指教。

    Event Broker：事件代理，通过事件源和订阅事件源来达成对象之间的协作。

    Event Publisher: 事件发布者，在CAB里是一个用属性EventPublication修饰的事件对象，提供特定的URL给Event Subscriber订阅。

    Event Subscriber: 事件订阅者，在CAB里是一个用属性EventSubscription修饰的方法，根据修饰提供的URL自动寻找事件发布者。Publisher和Subscriber之间由主题（由URL决定），消息（特定的 EventArgs），事件域（来确定是全局事件还是局部事件）来达成一致。其实这也是观察者模式的具体实现。

    WorkItem:代表一个用例，也可以看成是某个业务完成的过程，它包含在WorkSpace中，服务于Service Agents(服务代理)，并且加载其状态。创建其他组件或者视图，CAB来创建controller.组件共享WorkItem的状态，并且可以通过状态来控制用例的生命周期。

    WorkItem State：状态，实际上是把业务对象或者业务对象的属性，通过WorkItem State共享出来，方便其他业务对象或者视图访问。

二、体验Event Broker应用

    讲了这么多有关Event Broker的理论和概念了，我们还是通过一个简单的例子来体验Event Broker这种实现模式的优越性吧。

1.应用场景

     平时我们在开发过程中碰到最多的例子大概就是，一个业务对象数据集要通过dataGrip，ListBox甚至Chart控件等将其表现出来了。今天，我在学习笔记里也以这个例子来阐述Event Broker，在开发中带来的好处。

    场景是这样的：某人事信息管理软件要求输入人员的性别和姓名，并且能将输入的人员在通过表格和列表框的形式表现出来，同时录入人员的男女比例要能适时的通过饼图显示。

2.分析场景，确定开发模式

a.需求中涉及到的唯一业务对象是人员，具有性别和姓名两个属性。为了简单起见我们可以建立数据集来代替该对象。

b.需求要求能输入姓名、性别，我们可以用文本框和下拉框来完成信息采集。

c.需求要求人员信息，通过表格，ListBox和饼图来显示，我们可以在VS2005中用DataGrid、ListBox、ReportView来实现此项需求。

d.由于业务对象单一，而信息表现却又多个，适合用观察者模式进行开发。我们便采用CAB中的Event Broker作为重要的实现手段。

3.建立应用程序

第一步：新建项目

     启动VS2005，新建Windows Application，添加以下引用：

Microsoft.Practices.CompositeUI

Microsoft.Practices.CompositeUI.WinForms

Microsoft.Practices.ObjectBuiler

Microsoft.Practices.CompositeUI.Utility

Microsoft.Practices.CompositeUI.WinForms

第二步：建立数据集

    右击项目文件夹，添加新项，选择数据集，建立用户信息数据集（没有通过代码创建，主要是为了设计报表方便）。为数据集添加DataTable1的表，为DataTable1添加列Sex和Name。

第三步：绘制界面

     在VS2005默认生成的Form1上建立饼图、DataGrid、ListBox和相关相关控件，具体操作我在此略过，最终效果如下图：

第四步：修改入口程序

    为了让程序能使用CAB，我们必须修改程序的入口类Program.cs。最终修改结果如下：
   

using  System;
using  System.Collections.Generic;
using  System.Windows.Forms;
using  System.Data;
using  Microsoft.Practices.CompositeUI;
using  Microsoft.Practices.CompositeUI.WinForms;

namespace  TestReport
{
   class  Program : FormShellApplication < WorkItem, Form1 >
{
/**/ ///   <summary>
///  The main entry point for the application.
///   </summary>
[STAThread]
static   void  Main()
{
   new  Program().Run();
}

protected   override   void  BeforeShellCreated()
{
   base .BeforeShellCreated();
// 共享状态，通过"dataset"关键字访问
  RootWorkItem.State[ " dataset " ]  =   new  DataSet1();
}
}
}

   需要注意的是：为了能使用WorkItem的State，在Shell创建之前必须给共享的状态赋初值，否则在访问该状态时将出现状态没有创建实例的运行时错误。本例中就是加入以下代码：

protected   override   void  BeforeShellCreated()
{
   base .BeforeShellCreated();
  RootWorkItem.State[ " dataset " ]  =   new  DataSet1();
}

第五步：建立controller

建立controller负责用户信息添加，建立事件源。添加类文件，命名为Form1Controller,将该类从controller继承。如下代码所示:

using  System;
using  System.Collections.Generic;
using  System.Text;
using  Microsoft.Practices.CompositeUI;
using  Microsoft.Practices.CompositeUI.EventBroker;
using  Microsoft.Practices.CompositeUI.Utility;
using  System.Data;
namespace  TestReport
{
  public   class  Form1Controller: Controller
  {
  }

}

在controller中公布一个事件发布者，通过"topic://TestReport/DataRowAdded"来标识Publisher，默认的事件域为全局。也可以通过PublicationScope枚举来设置事件的作用域。事件作用域有以下三种：

PublicationScope.WorkItem :仅作用于引发当前发布的WorkItem实例

PublicationScope.Global:作用于引发当前发布的WorkItem所有实例

PublicationScope.Descendants：仅作用于引发当前发布的WorkItem实例，以及该WorkItem的任何级别的子WorkItem实例。

本例通过以下代码发布事件：

[EventPublication("topic://TestReport/DataRowAdded")]
public event EventHandler<DictionaryEventArgs> DataRowAdded;

controller中主要来实现业务逻辑，于是我们需要添加一个方法AddNewRow(int sex, string name),用来实现人员信息的添加，代码如下：

private  DataSet1 ctldataset;
  // controller的AddNewRow方法，引发事件DataRowAdded
public   void  AddNewRow( int  sex,  string  name)
{
if  (DataRowAdded  !=   null )
{
  DataRow myRow  =  ctldataset.DataTable1.NewRow();
  myRow[ 0 ]  =  sex;
  myRow[ 1 ]  =  name;
  ctldataset.DataTable1.Rows.Add(myRow);
  ctldataset.AcceptChanges();

  DictionaryEventArgs args  =   new  DictionaryEventArgs();
  args.Data[ " dataRow " ]  =  myRow;
  DataRowAdded( this , args);

  State.RaiseStateChanged( " dataset " , myRow);
}
}

   大家请注意下面代码，其实是定义了一个DictionaryEventArgs参数，并且将当前添加的行对象作为该参数的值。当DataTable1中行添加后，我们引发事件DataRowAdded(this, args)。  此时，事件源被触发了，订阅者就可以接收到该事件广播了。

DictionaryEventArgs args = new DictionaryEventArgs();
args.Data["dataRow"] = myRow;
DataRowAdded(this, args);

   到此，我们已经完成了事件源的创建和发布，为了达到演示的效果，我们还需要实现共享WorkItem State来广播事件。如以下代码：

[State( " dataset " )]
public  DataSet1 CtlDataSet 
{
set  
{
  ctldataset  =  value;
}
}
public   new  State State
{
   get   {  return   base .State; }
}

// 定义该窗体相关的Controller
private  Form1Controller controller;

// 将该窗体相关的Controller标记为自动创建实例
[CreateNew]
public  Form1Controller Controller
{
   set   { controller  =  value; }
}

   为添加按钮加入代码，实现添加一个人员信息：

private   void  btn_AddToTable_Click( object  sender, EventArgs e)
{
if (( this .textBox1.Text.Trim().Length  > 0 ))
{
  this .controller.AddNewRow( this .cmbSex.SelectedIndex,  this .textBox1.Text.Trim());

}
}

   还有为了让Grid和report view能够同步显示人员信息，我们需要订阅由topic://TestReport/DataRowAdded标示的事件：

[EventSubscription( " topic://TestReport/DataRowAdded " )]
public   void  OnCustomerAdded( object  sender, DictionaryEventArgs e)
{
this .dataGridView1.DataSource  =  ((DataSet1) this .controller.State[ " dataset " ]).DataTable1.DefaultView;
this .DataTable1BindingSource.DataSource  =  ((DataSet1) this .controller.State[ " dataset " ]).DataTable1.DefaultView;
this .reportViewer1.RefreshReport();
}

   这样每添加一个人员，Grid和Reoport View就能适时更新自身表现了，这就是Event Broker的实现方式，简单并且简洁。前面我们还提到了通过共享状态来实现视图和业务对象的关联，在本例中也提供实现。

首先，在FormLoad事件中订阅StateChanged事件：

private   void  Form1_Load( object  sender, EventArgs e)
{
this .controller.State.StateChanged  +=   new  EventHandler < StateChangedEventArgs > (State_Changed);
}

然后，通过代码更新List状态：

void  State_Changed( object  sender, StateChangedEventArgs e)
{
this .listBox1.DataSource  =  ((DataSet1) this .controller.State[ " dataset " ]).DataTable1.DefaultView;
this .listBox1.DisplayMember  =   " Name " ;
this .listBox1.ValueMember  =   " Name " ;
}

好了，到此我们的例程已经大功告成，最终的运行效果如下图：


本文相关代码通过此连接下载： /Files/hyphappy/TestReport.rar