项目名称叫Workflow, 是为一家在荷兰的呼叫中心客户化定制开发一款帮助他们管理工作流的系统。这个系统采用Domain Driven Design作为整个项目的总体设计方案。商业逻辑(business logic)在Domain model实现,Domain model用POCO(plain old c# object)实现,Domain model凭借fluent nhibernate map到数据库。Web部分采用ASP.NET MVC 2.0,StructureMap做为IoC container, 所以在controller里面就可以方便的使用接口I*whatever*Service来inject服务层。 当然了,项目中用到Messaging的部分是借用NserviceBus实现的。
因为整个系统中频繁用到给用户发邮件的功能,所以下面我就给大家介绍一下如果用NServiceBus实现Email messaging.
0. 在MVC project Web.config文件中,添加下面的配置, 主要目的是设置发送出去的message到达的终点站。
1 < UnicastBusConfig > 2 < MessageEndpointMappings > 3 < add Messages = " Workflow.Messages.Email.EmailMessage, Workflow.Messages " Endpoint = " EmailQueue " /> 4 </ MessageEndpointMappings > 5 </ UnicastBusConfig > 6
1. 在Controller constructor 里面inject IEmailService
1 public AdministratorsController( IUserMailer userMailer) 2 { 3 this .userMailer = userMailer; 4 }
2. 大家注意第10行,当新添加一个administrator之后,调用userMailer服务,来给这个新添加的管理员发送密码。
1 public Url Post(AddAdministratorViewModel model) 2 { 3 if ( ! ModelState.IsValid) 4 { 5 return model; 6 } 7 8 var administrator = administratorFactory.Create(model.UserName, model.Email); 9 adminRepository.Add(administrator); 10 userMailer.SendPasswordNotification(administrator); 11 12 return new AdministratorUrl { Administrator = administrator }; 13 }
3. 接下来在ApplicationService层里,UserMailer类继承IUserMailer, 同样在UserMailer constructor里面 inject IBus. IBus是NServiceBus的接口。
1 public UserMailer(IBus bus) 2 { 3 this .bus = bus; 4 }
4. 第8行创建一个新的EmailMessage对象, 第9行用bus 发送这个对象。
1 public void SendPasswordNotification(User user) 2 { 3 if (user == null ) 4 { 5 throw new ArgumentNullException( " user " ); 6 } 7 8 var email = new EmailMessage("from", "to", "title" , "body"); 9 bus.Send(email); 10 }
5. EmailMessage 类需要继承IMessage, IMessage是NServiceBus的一个接口,表明这个类符合NServiceBus对Message的定义,同时可以被NServiceBus处理。
1 public class EmailMessage : IMessage 2 { 3 // EmailMessage implementation goes here; 4 }
6. 最后一个环节就是在Solution中创建一个新的class library, 可以作为background service来实际发送邮件。在实现这个class library的时候,有基本上有3个方面需要注意:
1). App.config, 第4, 5, 7三行是特别用来配置NServiceBus. 在MsmqTransportConfig这一行,确保InputQueue是你在第0步骤中设定的Message要达到终点站的名字
1 <? xml version = " 1.0 " ?> 2 < configuration > 3 < configSections > 4 < section name = " MsmqTransportConfig " type = " NServiceBus.Config.MsmqTransportConfig, NServiceBus.Core " /> 5 < section name = " Logging " type = " NServiceBus.Config.Logging, NServiceBus.Core " /> 6 </ configSections > 7 < MsmqTransportConfig ErrorQueue = " error " InputQueue = " EmailQueue " MaxRetries = " 5 " NumberOfWorkerThreads = " 1 " /> 8 < startup > 9 < supportedRuntime sku = " .NETFramework,Version=v4.0 " version = " v4.0 " /> 10 </ startup > 11 </ configuration >
2). MessageEndPoint.cs, 这个类继承了NServiceBus的几个接口, IConfiureThisEndpoint (表明这个类是终点站的配置类), AsA_Server(表明这个终点站是个服务器), IWantCustomerInitialization(表明我们需要自己的container 和 serializer)
1 public class MessageEndpoint : IConfigureThisEndpoint, AsA_Server, IWantCustomInitialization 2 { 3 public void Init() 4 { 5 Configure.With() 6 .StructureMapBuilder(ObjectFactory.Container) 7 .XmlSerializer(); 8 } 9 }
3). EmailHandler.cs: 当EmailMessage 这个类型的message到达中间站的时候,我们要对这个message的操作在此类中实现。在本例中,我们首先获得一个SmtpClient的实例,然后用我们的EmailMessage来创建一个System.Net.Mail.MailMessage的实例mail,最后用smtpclient将这个mail发送。搞定!
1 public class EmailHandler : IHandleMessages < EmailMessage > 2 { 3 public void Handle(EmailMessage message) 4 { 5 try 6 { 7 var client = new SmtpClient(); 8 var htmlBody = " blah " ; 9 var mail = new MailMessage(message.From, message.To); 10 11 client.Send(mail); 12 } 13 catch (SmtpFailedRecipientsException) 14 { 15 // mail cannot be sent due to recipient specific error 16 } 17 } 18 }