Microsoft Robotics Studio-声明一个通用服务(Generic Service Declaration)
这篇文章演示怎样定义一个通用服务协议(generic service contract),通用服务协议类似面向对象编程中的接口,它只提供规范,而不提供具体实现,服务开发者将会为这些规范提供具体的实现,服务使用者不用去关心不同的服务的具体的实现,因为这些服务有相同的状态和操作,也就是通用服务协议所定义的状态和操作。
虽然上面的这个通用协议类似于接口,但是和接口又有很大的不同,这个在Service Tutorial 9 (C#) - Implementing and Extending Service Contracts,会看到。
这个实例由C#写的,你可以在下面的目录中找到它
Samples"ServiceTutorials"Tutorial8"CSharp
第一步:创建项目
通DssNewService工具或安装了msrs的vs2008创建一个服务项目,在这个项目中我们只需要ServiceTutorial8Types.cs文件,而不需要Servicetutorial8.cs文件,这里只有服务状态和操作的定义,即所说的协议(Contract),如果想用这些定义,可以实现一个新的服务,在另外一个服务中使用这里定义协议。
第二步:设置服务声明属性
在AssemblyInfo.cs文件中,使用ServiceDeclaration 属性向DSS基础架构指示这个程序集包含一个通用服务的协议而没有实现。
很有可能在一个程序集中既有通用协议的声明又有这个服务的实现,前提是他们定义在不同的clr命名空间中,你可以用下面的方式向DSS指示。
“这里命名空间的限制有些不可思议,一个DSS项目中如果有多个服务,DSS要求这些服务必须在不同的命名空间中。”
关于ServiceDeclaration的枚举类型的详细信息见下表:
Member name |
Description |
NonDssService |
Not a Dss Service :程序集中没有DSS服务 |
ServiceBehavior |
Assembly contains service behavior declarations including the port types used to describe message patterns and types Replaces [ServiceBehaviorDeclaration] 程序集包含服务的实现包括端口允许的操作,包括对消息体和消息类型的描述。 |
DataContract |
Assembly contains data contract declarations. Replaces [ServiceDataDeclaration] 程序集包括数据协议(通信时的消息体)的描述。 |
Proxy |
Assembly is a generated Dss Proxy |
Transform |
Assembly is a generated Dss Transform |
第三步:定义通用服务协议(Contract)
这个服务的协议和其他的服务的协议没有什么不同,这里的定义域如下:
1 /// <summary>
2 /// Generic Service without service implementation
3 /// </summary>
4 [DisplayName("Service Tutorial 8: Generic Service Contract")]
5 [Description("This is a generic contract without an actual service implementation. See Service Tutorial 9 for various ways to use this contract.")]
6 [DssServiceDescription("http://msdn.microsoft.com/library/bb727256.aspx")]
7 public sealed class Contract
8 {
9 /// <summary>
10 /// The Dss Service contract
11 /// </summary>
12 [DataMember()]
13 public const String Identifier = "http://schemas.tempuri.org/2007/08/servicetutorial8.html";
14 }
15
第四步:定义通用服务的状态(State)
同样,服务的状态和其他的服务业没什么区别,记得用DataContract, DataMember 和 DataMemberConstructor去标记这个类。
1 /// <summary>
2 /// State for the generic service
3 /// </summary>
4 [DataContract]
5 [DisplayName("Generic Service State")]
6 [Description("Specifies the state of the generic service.")]
7 public class GenericState
8 {
9 string _firstName;
10 string _lastName;
11
12 [DataMember]
13 [Description("Specifies the first name of a person.")]
14 [DisplayName("First Name")]
15 public string FirstName
16 {
17 get { return _firstName; }
18 set { _firstName = value; }
19 }
20
21 [DataMember]
22 [DisplayName("Last Name")]
23 [Description("Specifies the last name of a person.")]
24 public string LastName
25 {
26 get { return _lastName; }
27 set { _lastName = value; }
28 }
29 }
30
31
第五步:定义通用服务的端口操作(Operations)
呵呵,和前面一样,不多说,如下所示,我们定义了Get和Replace操作。
1 /// <summary>
2 /// Generic Service Main Operations Port
3 /// </summary>
4 [ServicePort]
5 public class GenericServiceOperations :
6 PortSet<DsspDefaultLookup, DsspDefaultDrop, Get, Replace>
7 {
8 }
9
10 /// <summary>
11 /// Get Operation
12 /// </summary>
13 [Description("Gets the current state.")]
14 public class Get : Get<GetRequestType, PortSet<GenericState, Fault>>
15 {
16 }
17
18 /// <summary>
19 /// Replace Operation
20 /// </summary>
21 [Description("Replaces the current state.")]
22 public class Replace : Replace<GenericState, PortSet<DefaultReplaceResponseType, Fault>>
23 {
24 }
25
第六步:编译
和其他服务的编译一样,编译这个项目会得到一个dll文件,因为没有服务的实现,所有不会生成一个服务,在Service Tutorial 9 (C#) - Implementing and Extending Service Contracts中我们会看到使用不同的方法去实现和扩展这个通用的服务协议。
这个是Service Tutorial 9 (C#) 中提到的Service Tutorial 8 (C#) 还好,文章很短,不过有几个值得注意的地方,比如关于命名空间的限制.......
转自:http://www.elooog.cn/post/64.html