NServiceBus官方文档翻译(二)NServiceBus 入门

 

在这篇教程中我们将学习如何创建一个非常简单的由客户端向服务端发送消息的订单系统。该系统包括三个项目:Client、Server 和 Messages,我们将按照以下步骤来完成这个任务。

  1. 创建 Client 项目
  2. 创建 Messages 项目
  3. 创建 Server 项目
  4. 发送订单
  5. 运行解决方案

完整的解决方案代码可以在这里下载。

创建 Client 项目

让我们开始创建 Client 项目,它将负责发送订单请求到一个 NServiceBus 终结点(Endpoint)。

以管理员权限运行 Visual Studio,添加一个名叫“Ordering.Client”的类库项目,并且将解决方案命名为“Ordering”。

我们现在需要引用 NServiceBus 的程序集,最快的方式是使用 NuGet 包管理控制台。

打开 NuGet 包管理控制台:

输入以下命令:

1
PM> Install-Package NServiceBus.Host

注:需要重新加载项目

包安装程序将引用 NServiceBus 程序集并在 Client 项目中创建几个模板文件。

例如,“EndpointConfig.cs” 被用来配置项目的终结点,并且自动应用了服务端配置。

为了将配置修改为客户端配置,我们需要打开“EndpointConfig.cs”文件并修改以下代码:

1
2
3
4
5
6
namespace Ordering.Client
{
    public class EndpointConfig : IConfigureThisEndpoint, AsA_Server
    {
    }
}

修改后的代码如下:

1
2
3
4
5
6
namespace Ordering.Client
{
    public class EndpointConfig : IConfigureThisEndpoint, AsA_Client
    {
    }
}

注:仅继承的基类由 AsA_Server 修改为 AsA_Client。

稍后我们将在 Client 项目中添加更多代码,现在让我们先把焦点放在如何处理订单请求上面。

创建 Messages 项目

首先添加一个名叫“Ordering.Messages”的类库项目。

该项目将包含消息定义,并且将由客户端和服务端共享,这样两边都将获得强类型的消息描述。

在该项目中安装“NServiceBusInterfaces”NuGet包,在包管理控制台,输入以下命令:

1
PM> Install-Package NServiceBus.Interfaces -ProjectName Ordering.Messages

添加一个“PlaceOrder.cs”文件,在其中添加以下代码:

1
2
3
4
5
6
7
8
9
10
namespace Ordering.Messages
{
 
    public class PlaceOrder : ICommand
    {
        public Guid Id { get; set; }
 
        public string Product { get; set; }
    }
}

创建 Server 项目

现在我们可以开始创建处理订单的服务端,首先添加一个名为“Ordering.Server”的类库项目。

为该项目安装“NServiceBusHost”NuGet包,在包管理控制台,输入以下命令:

1
PM> Install-Package NServiceBus.Host -ProjectName Ordering.Server

注:需要重新加载项目

添加对 Messages 项目的引用,以便服务端解释消息内容。

添加一个“PlaceOrderHandler.cs”文件,向其中写入以下代码:

1
2
3
4
5
6
7
8
9
10
11
12
namespace Ordering.Server
{
    public class PlaceOrderHandler : IHandleMessages<PlaceOrder>
    {
        public IBus Bus { get; set; }
 
        public void Handle(PlaceOrder message)
        {
            Console.WriteLine(@"Order for Product:{0} placed with id: {1}", message.Product, message.Id);
        }
    }
}

发送订单

我们差不多快做好了,现在唯一剩下的就是回到 Client 项目中,添加对 Messages 项目的引用,并添加一个“SendOrder.cs”文件,向其中写入以下代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
namespace Ordering.Client
{
    public class SendOrder : IWantToRunWhenBusStartsAndStops
    {
        public IBus Bus { get; set; }
 
        public void Start()
        {
            Console.WriteLine("Press 'Enter' to send a message.To exit, Ctrl + C");
 
            while (Console.ReadLine() != null)
            {
                var id = Guid.NewGuid();
 
                Bus.Send("Ordering.Server", new PlaceOrder() { Product = "New shoes", Id = id});
 
                Console.WriteLine("==========================================================================");
                Console.WriteLine("Send a new PlaceOrder message with id: {0}", id.ToString("N"));
            }
        }
        public void Stop()
        {
        }
    }
}

注:以上代码基于 4.x 版本,若使用 3.x 版本需要使用 “IWantToRunAtStartup”接口。

运行解决方案

已经完成编码了,现在是时候运行解决方案了。

在解决方案中设置启动项目,将 Client 和 Server 项目设置为同时运行。

最后点击 F5 按钮运行解决方案,即可看到整个系统。

将会有两个控制台应用程序启动,在客户端控制台中按下回车,将在服务端窗口中看到“Order for Product: New shoes placed”。

恭喜 - 你刚完成了你的第一个 NServiceBus 程序。

简单吧。

如果你在控制台中看到警告,不用担心,这些警告只是 NServiceBus 告诉你它无法找到需要的队列,它将自动为你创建。

接下来学些什么

  • NServiceBus 入门之容错处理
  • NServiceBus 和 SOA 的架构原则

敬请期待。

 
 
分类: NServiceBus
标签: C#NServiceBus

NServiceBus 入门2的更多相关文章

  1. NServiceBus官方文档翻译(二)NServiceBus 入门

    在这篇教程中我们将学习如何创建一个非常简单的由客户端向服务端发送消息的订单系统.该系统包括三个项目:Client.Server 和 Messages,我们将按照以下步骤来完成这个任务. 创建 Clie ...

  2. NServiceBus入门:多个endpoint(Introduction to NServiceBus: Multiple endpoints)

    原文地址:https://docs.particular.net/tutorials/intro-to-nservicebus/3-multiple-endpoints/ 侵删. 目前为止,我们只是在 ...

  3. NServiceBus入门:发布事件(Introduction to NServiceBus: Publishing events)

    原文地址:https://docs.particular.net/tutorials/intro-to-nservicebus/4-publishing-events/ 侵删. 这个教程到目前为止,我 ...

  4. NServiceBus入门:启程(Introduction to NServiceBus: Getting started)

    原文地址:https://docs.particular.net/tutorials/intro-to-nservicebus/1-getting-started/ 侵删. 最好的学习NService ...

  5. NServiceBus入门:发送一个命令(Introduction to NServiceBus: Sending a command)

    原文地址:https://docs.particular.net/tutorials/intro-to-nservicebus/2-sending-a-command/ 侵删. 能够发送和接收mess ...

  6. NServiceBus 入门到精通(一)

    什么是NServiceBus?NServiceBus 是一个用于构建企业级 .NET系统的开源通讯框架.它在消息发布/订阅支持.工作流集成和高度可扩展性等方面表现优异,因此是很多分布式系统基础平台的理 ...

  7. SOA、ESB、NServiceBus、云计算 总结

    SOA SOA 是通过功能组件化.服务化,来实现系统集成.解决信息孤岛,这是其主要目标.而更进一步则是实现更快响应业务的变化.更快推出新的应用系统.与此同时,SOA 还实现了整合资源,资源复用. SO ...

  8. SOA、ESB、NServiceBus、云计算

    SOA.ESB.NServiceBus.云计算 总结 SOA SOA 是通过功能组件化.服务化,来实现系统集成.解决信息孤岛,这是其主要目标.而更进一步则是实现更快响应业务的变化.更快推出新的应用系统 ...

  9. Angular2入门系列教程7-HTTP(一)-使用Angular2自带的http进行网络请求

    上一篇:Angular2入门系列教程6-路由(二)-使用多层级路由并在在路由中传递复杂参数 感觉这篇不是很好写,因为涉及到网络请求,如果采用真实的网络请求,这个例子大家拿到手估计还要自己写一个web ...

随机推荐

  1. NFS文件系统配置 和 GLIBC更新

    为了配置集群环境,把过程记录一下,方便后续使用 NFS 文件系统  是 network file system 配置好ssh无密码访问 ,各节点为centos6.5 主节点 在文件/etc/expor ...

  2. 注解配置的Spring MVC

    基于注解配置的Spring MVC 简单的HelloWorld实例应用   2.1 问题 使用注解的方式重构helloworld应用案例. 2.2 方案 1. @RequestMapping注解应用 ...

  3. zoj2977Strange Billboard (国家压缩+罗列)

    Strange Billboard Time Limit: 2 Seconds Memory Limit: 65536 KB The marketing and public-relations de ...

  4. ES6 扫盲

    原文地址:ECMAScript 6 扫盲--小胡子 1. let.const 和 block 作用域 let 允许创建块级作用域,ES6 推荐在函数中使用 let 定义变量,而非 var: var a ...

  5. 网络编程easy错误点-手知道

    通常的网络编程socket编程.实际上.socket编程并不仅仅是满足网络间不同主机之间的通信,它也能实现同一台主机上不同进程间的通信需求. 其体如今创建socket时的參数的不同: int sock ...

  6. openstack 网络简史

    openstack 网络简史 研究openstack有2个月的时间,这段时间从网上获取N多宝贵资料,对我的学习有非常大帮助,在加上我自己的研究,最终对openstack整个网络体系有了个浅显的认识,写 ...

  7. android开源系列:CircleImageView采用圆形控制它们的定义

    1.定义自己的圆形控制github住址:https://github.com/hdodenhof/CircleImageView 基本的类: package de.hdodenhof.circleim ...

  8. windows下系统移植到linux下出现的问题

    今天遇到了一个之前没有遇到的问题,记录一下. 我们是在windows下进行开发的,最终系统是部署在linux服务器上. 在windows一切正常,但是部署到linux下时,有些功能不能用了.通过log ...

  9. struts2 模型分配问题和延迟加载问题

    傅型号值问题: 首先须要说明的是:Action在请求到达ActionProxy时已经创建出来了,而且对应的创建了一个值栈. 在拦截器到达之前这个图片已经OK了.Action已经创建.并且压入了值栈vs ...

  10. 聊聊单元測试(一)——EasyMock

    一.单元測试是保证软件质量的重要方法. 单元測试是对系统中某个模块功能的验证,但我们总会遇到这样那样的问题,导致測试代码非常难编写.最直接的一个原因便是强耦合关系,被測试者依赖一些不easy构造,比較 ...