- 客户端创建WEB服务代理类的一个新实例,该对象驻留在客户端所在的同一台计算机上.
- 客户端调用代理类上的方法.
- 客户端计算机上的ASP.NET框架的基础结构将WEB服务方法的参数序列化为SOAP消息,并通过网络将它发送给WEB服务.
- ASP.NET框架基础结构结收SOAP消息并反序列化该XML.他创建了WEB服务类的实例并调用WEB服务方法,同时将返序列化的XML作为参数传入.
- WEB服务方法执行其代码,最终会设置返回值和任何输出参数.
- WEB服务器上的ASP.NET框架基础结构将返回值和输出参数序列化为SOAP消息,并通过网络发送回客户端.
- 客户端计算机上的ASP.NET框架基础结构接收该SOAP消息,将XML反序列化为返回值和任何输出参数.并将它们传给代理类的实例.
- 客户端接收返回值和任何输出参数.
SOAP扩展可能检查或修改SOAP的阶段
- AfterDeserialize: 发生在将SOAP消息反序列化到对象之后的阶段.
- AfterSerialize: 发生在序列化之后,但在通过网络发送SOAP消息之前.
- BeforeDeserialize: 发生在反序列批这前,但在网络发送之后.
- BeforeSeralize: 发生在序列化之前.
SOAP扩展的步骤:
- 从SoapExtension派生一个类.
- 保存对表示将来SOAP消息的Stream的引用.
- 初始化SOAP扩展.
- 在相关的SoapMessageStage或多个阶段中处理SOAP消息.
- 配置SOAP扩展使其可用.
注:SoapExtension派生类重要的重载方法
- ChainStream: 当在派生类中被重载时,允许SOAP扩展访问包含SOAP请求或响应的内存缓冲区
- GetInitializer: 当在派生类中被重载时,允许SOAP扩展以一次执行的成本初始化特定的WEB服务方法的数据
- Initialize: 当在派生类中被重载时,允许SOAP扩展使用缓存于GetInitializer方法中的数据初始化其自身.
- ProcessMessage:当在派生类中被重载时,允许SOAP扩展接收要在每个SoapMessageStage中处理的SoapMessage.
//处理SOAP消息
//每当切换到一种新的阶段时,该方法都会被调用
public override void ProcessMessage(SoapMessage message)
{
switch(message.Stage)
{
case SoapMessageStage.BeforeSerialize:
break;
case SoapMessageStage.AfterSerialize:
WriteOutput(message);
break;
case SoapMessageStage.BeforeDeserialize:
WriterInput(message);
break;
case SoapMessageStage.AfterDeserialize:
break;
default:
throw new Exception(“Invalid stage“);
}
}:
调用SOAP扩展方法的顺序:
客户端:
1. 客户端对代理类调用方法.
2. 在客户端创建SOAP扩展新实例.
3. 如果是第一次在客户端调用该WEB服务执行该SOAP扩展,则对运行于客户端的SOAP扩展调用GetInitilalizer方法.
4. 调用Initialize方法.
5. 调用ChainStream方法.
6. 调用ProcessMessage方法.调用时将SoapMessageStage设置为BeforeSerialize.
7. 客户端计算机上的ASP.NET将WEB服务方法的参数序列化为XML.
8. 调用ProcessMessage方法.调用时将SoapMessageStage设置为AfterSerialize.
9. 客户端计算机上的ASP.NET通过网络将SOAP消息发送到承载该WEB服务的WEB服务器.
服务器端:
1. WEB服务器上的ASP.NET接收该SOAP消息.
2. 在WEB服务器上创建SOAP扩展的新实例.
3. 在WEB服务器上,如果这是第一次在服务器端使用该WEB服务执行该SOAP扩展,则对运行于服务器端的SOAP扩展调用GetInitializer方法.
4. 调用Initialize方法.
5. 调用ChainStream方法.
6. 调用ProcessMessage方法.调用时将SoapMessageStage设置为BeforeDeserialize.
7. ASP.NET反序列化XML中的参数.
8.调用ProcessMessage方法.调用时将SoapMessageStage设置为AfterDeserialize.
9. ASP.NET创建实现WEB服务的类的新实例并调用WEB服务的方法.同时传入反序列化的参数.该对象驻留在与WEB服务器相同的计算机上.
10.WEB服务执行其代码.最终会设置返回值和任何输出参数.
11. 调用ProcessMessage方法.调用时将SoapMessageStage设置为BeforeSerialize.
12. WEB服务器上的ASP.NET将返回值与输出参数序列化为XML.
13. 调用ProcessMessage方法.调用时将SoapMessageStage设置为AfterSerialize.
14. ASP.NET通过网络将SOAP响应消息发送回WEB服务客户端.
客户端:
1. 从服务器接收SOAP消息.
2. 调用ProcessMessage方法.调用时将SoapMessageStage设置为BeforeDeserialize.
3. ASP.NET将XML反序列化为返回值与输出参数.
4. 调用ProcessMessage方法.调用时将SoapMessageStage设置为AfterDeserialize.
5. ASP.NET将返回值与任何输出参数传递到代理类的实例.
6. 客户端接收返回值与任何输出参数.