WCF学习笔记----服务契约（Service Contracts）

更新时间：2009-01-06

源代码

服务契约（Service Contracts）

ServiceContract– 定义服务操作

应用于接口或者类中,并使用接口（或类）上的 ServiceContractAttribute 属性定义服务协定。
• 建议应用于接口中
– 消除服务实现的耦合性
– 服务可能会实现多于1个契约，也就是说方便一个类的实现可以继承于多个服务契约的接口。如果将契约置于具体类上，那就不能实现继承多个契约，受制于c#类的单继承

MSDN备注：使用 ServiceContractAttribute 修饰的接口或类还必须至少拥有一个用 OperationContractAttribute 属性标记的方法以公开任意功能。

• Name，指定 WSDL <portType> 元素中的协定名称。

• Namespace，指定 WSDL <portType> 元素中的命名空间。

• SessionMode，指定协定是否需要支持会话的绑定。

• ConfigurationName，指定要使用的配置文件中的服务元素的名称。

• CallbackContract，指定双向（双工）对话中的返回协定。

• HasProtectionLevel 和ProtectionLevel，指示是否所有支持协定的消息都具有一个显式 ProtectionLevel 值，如果有，处于什么级别。

 

-------------------------------------解决方案------------------------------------------------------

 

-------------------------------------服务契约------------------------------------------------------

   /// <summary>
/// 人员管理接口
/// </summary>
// Namespace - 服务契约的命名空间，在WSDL中体现。
// Name - 服务契约的名称，在WSDL中体现。
// ConfigurationName - 服务契约在宿主中所配置的服务名称（默认情况下本例为类的全名“TZOT.WCF.Contract.IPersonManagerService”）
[ServiceContract(Namespace="http://www.cnblogs.com/netlife",
Name="PersonManager",
ConfigurationName="PersonManagerConfig")]
public interface IPersonManagerService
{
/// <summary>
/// 获取某人的姓名
/// </summary>
/// <param name="person">Person对象</param>
/// <returns>对应的名字</returns>
// Name - 操作契约的名称（会对应到相关的wsdl，默认情况下本例为方法名“GetName”）
[OperationContract(Name = "GetPersonName")]
string GetName(Person person);
}

-------------------------------------数据契约------------------------------------------------------

   /// <summary>
/// Person的实体类
/// </summary>
// Name - 数据契约的名称（会对应到相关的wsdl，默认情况下本例为类名“Person”）
[DataContract(Name = "PersonModel")]
public class Person
{
/// <summary>
/// Person的实体类的Age属性
/// </summary>
// Name - 数据成员的名称（会对应到相关的wsdl，默认情况下本例为属性名“Age”）
// IsRequired - 该值指示序列化引擎该成员在读取或反序列化时必须存在
// Order - 数据成员在相关的wsdl中的顺序
// EmitDefaultValue - 如果应该在序列化流中生成成员的默认值，则为 true，否则为 false，默认值为 true
[DataMember(Name = "PersonAge", IsRequired = false, Order = 1)]
public int Age { get; set; }
/// <summary>
/// Person的实体类的Name属性
/// </summary>
// Name - 数据成员的名称（会对应到相关的wsdl，默认情况下本例为属性名“Name”）
// IsRequired - 该值指示序列化引擎该成员在读取或反序列化时必须存在
// Order - 数据成员在相关的wsdl中的顺序
// EmitDefaultValue - 如果应该在序列化流中生成成员的默认值，则为 true，否则为 false，默认值为 true
[DataMember(Name = "PersonName", IsRequired = false, Order = 0)]
public string Name { get; set; }
}

-------------------------------------Hosting App.Config------------------------------------------------------

<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior name="serviceBehavior">
<serviceMetadata httpGetEnabled="true" httpGetUrl=""/>
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service name="TZOT.WCF.BusinessServices.PersonManagerService" behaviorConfiguration="serviceBehavior">
<endpoint address="" contract="PersonManagerConfig" binding="basicHttpBinding"/>
<!--contract= 是服务契约中配置的ConfigurationName “PersonManagerConfig”，为我们在服务契约中配置的代码。-->
<endpoint contract="IMetadataExchange" binding="mexHttpBinding" address="mex" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:8000/PersonManagerService/" />
</baseAddresses>
</host>
</service>
</services>
</system.serviceModel>

-------------------------------------启动服务------------------------------------------------------

    class Program
{
static void Main(string[] args)
{
//提供服务的主机
ServiceHost personManagerServiceHosting = null;
try
{
personManagerServiceHosting = new ServiceHost(typeof(PersonManagerService));
personManagerServiceHosting.Open();
Console.WriteLine();
Console.WriteLine("Press <ENTER> to terminate Host");
Console.ReadLine();
}
finally
{
personManagerServiceHosting.Close();
}
}
}

-------------------------------------客户端App.Config------------------------------------------------------

<client>
<endpoint address="http://localhost:8000/PersonManagerService/"
binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_PersonManager"
contract="PersonManagerSerivceRefrence.PersonManager" name="BasicHttpBinding_PersonManager" />
</client>

-------------------------------------客户端添加服务自动生成的部分代码------------------------------------------------------

可以发现自动生成的接口名字为“PersonManager ”，即在服务契约中Name="PersonManager"的体现。

可以发现自动生成的命名空间为Namespace=http://www.cnblogs.com/netlife。

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(Namespace="http://www.cnblogs.com/netlife", ConfigurationName="PersonManagerSerivceRefrence.PersonManager")]
public interface PersonManager {
[System.ServiceModel.OperationContractAttribute(Action="http://www.cnblogs.com/netlife/PersonManager/GetPersonName", ReplyAction="http://www.cnblogs.com/netlife/PersonManager/GetPersonNameResponse")]
string GetPersonName(TZOT.WCF.Client.PersonManagerSerivceRefrence.PersonModel person);
}