化零为整WCF(2) - 契约Contract - 星辰.Net技术社区论坛

化零为整WCF(2) - 契约Contract

时间: 2008-03-21 10:24

[源码下载]

化零为整WCF(2) - 契约Contract(ServiceContract、OperationContract、DataContract、ServiceKnownType和DataMember)

作者：webabcd

介绍
WCF(Windows Communication Foundation)，服务契约(ServiceContract)，操作契约(OperationContract)，数据契约(DataContract)，服务已知类型(ServiceKnownType)，数据成员(DataMember)

示例
1、服务
IPersonManager.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.ServiceModel;

using System.Runtime.Serialization;

namespace WCF.ServiceLib.Contract

{

/**////
<summary>

/// 人员管理接口

///
</summary>

// Namespace - 服务契约的命名空间

// Name - 服务契约的名称（会对应到相关的wsdl，默认情况下本例为接口名“IPersonManager”）

// ConfigurationName - 服务契约在宿主中所配置的服务名称（默认情况下本例为类的全名“WCF.ServiceLib.Contract.IPersonManager”）

[ServiceContract(Namespace =
"http://webabcd.cnblogs.com", Name =
"IPersonManager", ConfigurationName =
"ConfigurationNameTest")]

// 服务已知类型 - Student（数据契约）继承自Person（数据契约），要指定Student为已知类型，其才会被序列化

[ServiceKnownType(typeof(Student))]

public
interface IPersonManager

{

/**////
<summary>

/// 获取某人的姓名

///
</summary>

///
<param name="p">Person对象</param>

///
<returns></returns>

// Name - 操作契约的名称（会对应到相关的wsdl，默认情况下本例为方法名“GetName”）

[OperationContract(Name="GetPersonName")]

string GetName([MessageParameter(Name =
"person")] Person p);

}

}

PersonManager.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.ServiceModel;

using System.Runtime.Serialization;

namespace WCF.ServiceLib.Contract

{

/**////
<summary>

/// 人员管理类

///
</summary>

public
class PersonManager : IPersonManager

{

/**////
<summary>

/// 获取某人的姓名

///
</summary>

///
<param name="p">Person对象</param>

///
<returns></returns>

public
string GetName(Person p)

{

return
"Name: "
+ p.Name;

}

}

Person.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.ServiceModel;

using System.Runtime.Serialization;

namespace WCF.ServiceLib.Contract

{

/**////
<summary>

/// Person的实体类

///
</summary>

// Name - 数据契约的名称（会对应到相关的wsdl，默认情况下本例为类名“Person”）

[DataContract(Name =
"PersonModel")]

public
class Person

{

/**////
<summary>

/// Person的实体类的Age属性

///
</summary>

// Name - 数据成员的名称（会对应到相关的wsdl，默认情况下本例为属性名“Age”）

// IsRequired - 数据成员序列化前是否必须被赋值

// Order - 数据成员在相关的wsdl中的顺序

[DataMember(Name =
"PersonAge", IsRequired =
false, Order =
1)]

public
int Age

{ get; set; }

/**////
<summary>

/// Person的实体类的Name属性

///
</summary>

// Name - 数据成员的名称（会对应到相关的wsdl，默认情况下本例为属性名“Name”）

// IsRequired - 数据成员序列化前是否必须被赋值

// Order - 数据成员在相关的wsdl中的顺序

[DataMember(Name =
"PersonName", IsRequired =
false, Order =
0)]

public
string Name

{ get; set; }

}

}

Student.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.ServiceModel;

using System.Runtime.Serialization;

namespace WCF.ServiceLib.Contract

{

/**////
<summary>

/// Student的实体类

///
</summary>

// Name - 数据契约的名称（会对应到相关的wsdl，默认情况下本例为类名“Student”）

[DataContract(Name =
"StudentModel")]

public
class Student : Person

{

/**////
<summary>

/// Student的实体类的School属性

///
</summary>

// Name - 数据成员的名称（会对应到相关的wsdl，默认情况下本例为属性名“School”）

// IsRequired - 数据成员序列化前是否必须被赋值

// Order - 数据成员在相关的wsdl中的顺序

[DataMember(Name =
"School", IsRequired =
false, Order =
0)]

public
string School

{ get; set; }

}

}

2、宿主
PersonManager.svc

@ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.Contract.PersonManager"
%>

Web.config

<?xml version="1.0"?>

<system.serviceModel>

</behavior>

</serviceBehaviors>

</behaviors>

</service>

</services>

</system.serviceModel>

</configuration>

3、客户端
PersonManager.aspx

@ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="PersonManager.aspx.cs"

Inherits="Contract_PersonManager" Title="契约(ServiceContract、OperationContract、DataContract、ServiceKnownType和DataMember)"
%>

<asp:Content ID="Content1" ContentPlaceHolderID="head" runat="Server">

</asp:Content>

<asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">

<asp

extBox ID="txtName" runat="server" Text="webabcd"
/>

<asp:Button ID="btnGetName" runat="server" Text="GetName"

onclick="btnGetName_Click"
/>

</asp:Content>

PersonManager.aspx.cs

using System;

using System.Collections;

using System.Configuration;

using System.Data;

using System.Linq;

using System.Web;

using System.Web.Security;

using System.Web.UI;

using System.Web.UI.HtmlControls;

using System.Web.UI.WebControls;

using System.Web.UI.WebControls.WebParts;

using System.Xml.Linq;

public
partial
class Contract_PersonManager : System.Web.UI.Page

{

protected
void Page_Load(object sender, EventArgs e)

{

}

protected
void btnGetName_Click(object sender, EventArgs e)

{

// Contract.IPersonManager pm = new Contract.PersonManagerClient();

Contract.PersonManagerClient proxy =
new Contract.PersonManagerClient();

Contract.StudentModel sm =
new Contract.StudentModel()

{ PersonName = txtName.Text };

Page.ClientScript.RegisterStartupScript(

this.GetType(),

"js",

string.Format("alert('{0}')", proxy.GetPersonName(sm)),

true);

proxy.Close();

}

Web.config

<?xml version="1.0"?>

<system.serviceModel>

</client>

</system.serviceModel>

</configuration>

运行结果：
单击"btnGetName"后弹出提示框，显示"Name: webabcd"

OK
[源码下载]

1 / 1 页

跳转页

作者
star65225692

添加至收藏夹

该系列其他文章:

化零为整WCF(6) - 消息处理(异步调用OneWay, 双向通讯Duplex) 介绍

化零为整WCF(7) - 消息处理(使用消息传输优化机制 - MTOM)

化零为整WCF(8) - 消息处理(使用流数据传输文件)

化零为整WCF(9) - 序列化

化零为整WCF(10) - 实例模型(InstanceContextMode)

化零为整WCF(11) - 会话状态(Session)

化零为整WCF(12) - 并发和限流(Concurrent和Throttle)

化零为整WCF(13) - 并发控制(锁)

化零为整WCF(1) - 不能免俗，我也从Hello开始

化零为整WCF(3) - 绑定Binding(basicHttpBinding和netTcpBinding)

化零为整WCF(4) - 异常处理

化零为整WCF(5) - 宿主Hosting

化零为整WCF(14) - 事务(Transaction)

化零为整WCF(15) - 可靠性消息(ReliableMessaging)

WCF中的Binding模型学习(二): 信道与信道栈

WCF中的Binding模型学习(三): 信道监听器（Channel Listener）

WCF中的Binding模型学习(四): 信道工厂（Channel Factory）

WCF中的Binding模型学习(五): 绑定元素（Binding Element）

WCF中的Binding模型学习(六): 从绑定元素认识系统预定义绑定

化零为整WCF(16) - 消息队列(MSMQ - MicroSoft Message Queue)