消息契约(Message Contract)在流(Stream )传输大文件中的应用

刚做完一个binding为netTcpBinding,transferMode为"Streamed"传输大文件的例子。

现实验用消息契约(Message Contract)来传输文件名等信息。

服务契约(Service Contract)和消息契约(Message Contract)如下:

 1     [ServiceContract(Namespace = "http://Microsoft.Samples.Stream",ConfigurationName="StreamingConfigurationName")]
2 public interface IStreamingSample
3 {
5 [OperationContract]
6 bool UploadStream(FileUploadData request);
7 }
8
10 [MessageContract]
11 public class FileUploadData
12 {
13 [MessageHeader]
14 public String FileName { get; set; }
15 [MessageBodyMember]
16 public System.IO.Stream FileData { get; set; }
17 }

运行程序错误,异常提示信息如下:

InvalidOperationException:无法加载操作“UploadStream”,因为它具有类型为 System.ServiceModel.Channels.Message 的参数或返回类型,或具有一个带有 MessageContractAttribute 及其他不同类型参数的类型。当使用 System.ServiceModel.Channels.Message 或具有 MessageContractAttribute 的类型时,方法不应使用任何其他参数类型

后查看http://msdn.microsoft.com/zh-cn/library/ms730255.aspx

找到问题缘由:

A messaging-style operation has at most one parameter and one return value where both types are message types; that is, they serialize directly into a specified SOAP message structure. This may be any type marked with the MessageContractAttribute or the Message type.

即:如果一个服务契约(Service Contract)的某个服务操作(operation)是基于消息类型(messaging-style)的,则这个服务操作(operation)必须:

  • 最多有一个输入参数
  • 最多有一个返回类型
  • 输入参数和返回类型必须是消息类型(message type,如消息契约或者Message类型的参数)的。当然可以不返回,为void。

另外,在定义应用于流(stream)传输的消息契约(Message Contract)时:

  • SOAP主体(即,[MessageBodyMember]应用的属性)只能有一个,即  public System.IO.Stream FileData { get; set; }
  • SOAP报头(即,[MessageHeader]应用的属性)可以有多个,传输文件名,大小,时间等。
  • 为了提高性能,可以将多个报头合成一个报头,那就必须利用数据契约(Data Contract)来合成多个数据。

在上面的例子中将方法:

[OperationContract]
bool UploadStream(FileUploadData request);

改为:

[OperationContract]
void
UploadStream(FileUploadData request);

或者将返回类型设为某个定义的消息契约(Message Contract)。

问题解决。

DEMO 源码:wcf流传输-TCP-2添加messagecontract


posted @ 2011-07-19 10:54  黎明即起  阅读(933)  评论(5编辑  收藏  举报