服务操作的默认行为是请求-答复模式。 在请求-答复模式中,即使服务操作以代码形式表示为 void 方法,客户端也会等待答复消息。 使用单向操作时,只能传输一个消息。 接收方不发送答复消息,发送方也不需要获得答复消息。
可以在以下情况下使用单向设计模式:
-
客户端必须调用操作且在操作级别不受操作结果的影响。
-
使用 xref:System.ServiceModel.NetMsmqBinding 或 xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding 类。 (有关此方案的详细信息,请参阅WCF 中的队列。)
如果是单向操作,则不会向客户端返回承载错误信息的响应消息。 可以通过使用基础绑定的功能(如可靠会话)或通过设计一个可使用两个单向操作的双工服务协定(一个单向协定从客户端到服务,用于调用服务操作;另一个单向协定在服务和客户端之间,以使服务可以使用客户端实现的回调将错误发回到客户端)来检测错误条件。
若要创建单向服务协定,请定义服务协定,将 xref:System.ServiceModel.OperationContractAttribute 类应用到每个操作,并将 xref:System.ServiceModel.OperationContractAttribute.IsOneWay* 属性设置为 true,如下面的代码示例所示。
[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface IOneWayCalculator
{
[OperationContract(IsOneWay=true)]
void Add(double n1, double n2);
[OperationContract(IsOneWay = true)]
void Subtract(double n1, double n2);
[OperationContract(IsOneWay = true)]
void Multiply(double n1, double n2);
[OperationContract(IsOneWay = true)]
void Divide(double n1, double n2);
}
有关完整示例,请参阅单向示例。
单向操作的客户端阻止
请务必认识到,虽然一些单向应用程序后立即返回出站数据写入到的网络连接,在多种方案中实现的绑定或服务可能会导致 WCF 客户端以阻止使用单向操作。 在 WCF 客户端应用程序,WCF 客户端对象不返回直到出站数据写入网络连接。 所有消息交换模式都是如此,包括单向操作;这意味着在将数据写入传输时发生的任何问题都会阻止客户端返回。 结果可能是在将消息发送到服务的过程中出现异常或延迟,具体取决于所发生的问题。
例如,如果传输找不到终结点,则会在短时间内引发 xref:System.ServiceModel.EndpointNotFoundException?displayProperty=nameWithType 异常。 但是,由于某种原因,服务也可能无法读取网络上的数据,这将阻止客户端传输发送操作返回。 在这些情况下,如果超出了客户端传输绑定上的 xref:System.ServiceModel.Channels.Binding.SendTimeout*?displayProperty=nameWithType 期限,则会引发 xref:System.TimeoutException?displayProperty=nameWithType,但会在超出超时期限后引发。 也有可能向某一服务发送了过多的消息,而当超过某一特定点后,该服务无法处理这些消息。 在这种情况下,单向客户端也会发生阻止,直到服务可以处理这些消息或直到引发异常。
另一种不同的情况是服务的 xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode*?displayProperty=nameWithType 属性设置为 xref:System.ServiceModel.ConcurrencyMode.Single 且绑定使用会话。 在这种情况下,调度程序会对传入消息强制执行排序(会话的需求),这会阻止从网络上读取后续的消息,直到服务处理完该会话的前一个消息为止。 同样,客户端会发生阻止,但是否发生异常取决于客户端的超时设置结束前,服务是否能处理等待的数据。
通过在客户端对象和客户端传输发送操作之间插入一个缓冲器可以使此问题得到一些缓解。 例如,使用异步调用或使用内存中的消息队列可以使客户端对象迅速返回。 这两种方法都可以增强功能,但线程池和消息队列的大小仍具有限制。
建议改为检查服务以及客户端上的各个控制机制,然后测试应用程序方案来确定任一端最佳配置。 例如,如果使用会话会在服务上阻止消息的处理,则可以将 xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode*?displayProperty=nameWithType 属性设置为 xref:System.ServiceModel.InstanceContextMode.PerCall,使每个消息都可以通过不同的服务实例来处理,并将 xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode* 设置为 xref:System.ServiceModel.ConcurrencyMode.Multiple,以便允许多个线程一次调度多个消息。 另一个方法是提高服务和客户端绑定的读取配额。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
