Web服务生存周期内发生的事件/Soap扩展的阶段/Soap扩展的步骤

1. 客户端创建WEB服务代理类的一个新实例,该对象驻留在客户端所在的同一台计算机上.
2. 客户端调用代理类上的方法.
3. 客户端计算机上的ASP.NET框架的基础结构将WEB服务方法的参数序列化为SOAP消息,并通过网络将它发送给WEB服务.
4. ASP.NET框架基础结构结收SOAP消息并反序列化该XML.他创建了WEB服务类的实例并调用WEB服务方法,同时将返序列化的XML作为参数传入.
5. WEB服务方法执行其代码,最终会设置返回值和任何输出参数.
6. WEB服务器上的ASP.NET框架基础结构将返回值和输出参数序列化为SOAP消息,并通过网络发送回客户端.
7. 客户端计算机上的ASP.NET框架基础结构接收该SOAP消息,将XML反序列化为返回值和任何输出参数.并将它们传给代理类的实例.
8. 客户端接收返回值和任何输出参数.

SOAP扩展可能检查或修改SOAP的阶段

• AfterDeserialize:    发生在将SOAP消息反序列化到对象之后的阶段.    
• AfterSerialize:        发生在序列化之后,但在通过网络发送SOAP消息之前.
• BeforeDeserialize:  发生在反序列批这前,但在网络发送之后.
• BeforeSeralize:       发生在序列化之前.

SOAP扩展的步骤:

1. 从SoapExtension派生一个类.
2. 保存对表示将来SOAP消息的Stream的引用.
3. 初始化SOAP扩展.
4. 在相关的SoapMessageStage或多个阶段中处理SOAP消息.
5. 配置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. 客户端接收返回值与任何输出参数.