HttpCookieSession

發行項
02/28/2011

這個範例會示範如何建置自訂通訊協定通道，以便在工作階段管理使用 HTTP Cookie。這個通道可以啟用 Windows Communication Foundation (WCF) 服務和 ASMX 用戶端之間的通訊，或是 WCF 用戶端和 ASMX 服務之間的通訊。

當用戶端在工作階段架構 ASMX Web 服務中呼叫 Web 方法時，ASP.NET 引擎會執行下列動作：

產生唯一 ID (工作階段 ID)。
產生工作階段物件，並使該物件與唯一 ID 產生關聯。
將唯一 ID 新增至 Set-Cookie HTTP 回應標頭，並傳送至用戶端。
根據傳送至用戶端的工作階段 ID，識別後續呼叫上的用戶端。

用戶端會在傳送至伺服器的後續要求中，加入這個工作階段 ID。伺服器則會使用來自用戶端的工作階段 ID，為目前的 HTTP 內容載入適當的工作階段物件。

注意：
這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄，然後再繼續。 `<InstallDrive>:\WF_WCF_Samples` 如果此目錄不存在，請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文)，以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。 `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\HttpCookieSession`

注意：

這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄，然後再繼續。

<InstallDrive>:\WF_WCF_Samples

如果此目錄不存在，請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文)，以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。

<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\HttpCookieSession

HttpCookieSession 通道訊息交換模式

這個範例會對類似 ASMX 的案例啟用工作階段。在通道堆疊的底部，將會提供支援 IRequestChannel 和 IReplyChannel 的 HTTP 傳輸。通道的工作就是要對通道堆疊的較高層級提供工作階段。這個範例會實作兩個支援工作階段的通道 (IRequestSessionChannel 和 IReplySessionChannel)。

服務通道

範例會在 HttpCookieReplySessionChannelListener 類別中提供服務通道。這個類別會實作 IChannelListener 介面，並將通道堆疊中較低的 IReplyChannel 通道轉換為 IReplySessionChannel。這個處理序可以分成下列幾個部分：

通道接聽程式開啟時，會接受來自內部接聽程式的內部通道。因為內部接聽程式為資料包 (Datagram) 接聽程式，而且所接受通道的時間範圍會少於接聽程式的時間範圍，因此我們可以關閉內部接聽程式而只保留內部通道。

            this.innerChannelListener.Open(timeoutHelper.RemainingTime());
this.innerChannel = this.innerChannelListener.AcceptChannel(timeoutHelper.RemainingTime());
this.innerChannel.Open(timeoutHelper.RemainingTime());
this.innerChannelListener.Close(timeoutHelper.RemainingTime());

完成開啟的處理序時，我們會設定訊息迴圈以接收來自內部通道的訊息。

IAsyncResult result = BeginInnerReceiveRequest();
if (result != null && result.CompletedSynchronously)
{
   // do not block the user thread
   if (this.completeReceiveCallback == null)
   {
      this.completeReceiveCallback = new WaitCallback(CompleteReceiveCallback);
   }
   ThreadPool.QueueUserWorkItem(this.completeReceiveCallback, result);
}

訊息抵達時，服務通道會檢查工作階段識別碼，並將信號分離至適當的工作階段通道。通道接聽程式所維護的字典，會將工作階段識別碼對應至工作階段通道執行個體。
```
Dictionary<string, IReplySessionChannel> channelMapping;
```

HttpCookieReplySessionChannel 類別會實作 IReplySessionChannel。通道堆疊的較高層級會呼叫 ReceiveRequest 方法，以讀取此工作階段的要求。每個工作階段通道都有由服務通道所填入 (Populate) 的私用訊息佇列。

InputQueue<RequestContext> requestQueue;

在某人呼叫 ReceiveRequest 方法而且訊息佇列中沒有任何訊息的情況下，通道會先等待指定的時間量，然後才自行關機。這樣做會清除針對非 WCF 用戶端所建立的工作階段通道。

我們會使用 channelMapping 來追蹤 ReplySessionChannels，而在所有已接受的通道關閉之前，不會關閉基礎 innerChannel。使用這個方法時，HttpCookieReplySessionChannel 存在的時間會超過 HttpCookieReplySessionChannelListener 的存留期。我們也不用擔心接聽程式會在執行時進行記憶體回收，因為接受的通道會透過 OnClosed 回呼參考其接聽程式。

用戶端通道

對應的用戶端通道位於 HttpCookieSessionChannelFactory 類別中。在通道建立期間，通道處理站會使用 HttpCookieRequestSessionChannel 包裝內部要求。 HttpCookieRequestSessionChannel 類別則會將呼叫轉寄至基礎要求通道。當用戶端關閉 Proxy 時，HttpCookieRequestSessionChannel 會將訊息傳送至服務，指出通道正在關閉。因此，服務通道堆疊可順利關閉使用中的工作階段通道。

繫結和繫結項目

建立服務和用戶端通道之後，下一個步驟就是將它們整合至 WCF 執行階段。通道可透過繫結和繫結項目公開至 WCF。繫結是由一或多個繫結項目所組成。而 WCF 則提供了數個系統定義的繫結，例如 BasicHttpBinding 或 WSHttpBinding。 HttpCookieSessionBindingElement 類別含有繫結項目的實作。該類別會覆寫通道接聽程式和通道處理站的建立方法，以執行必要的通道接聽程式或通道處理站執行個體化 (Instantiation)。

範例會在服務描述中使用原則判斷提示。這可讓範例將其通道需求發行至使用服務的其他用戶端。例如，這個繫結項目會發行原則判斷提示，讓可能的用戶端清楚繫結項目可支援工作階段。由於範例會啟用繫結項目組態中的 ExchangeTerminateMessage 屬性，因此會新增必要的判斷提示，表示該服務支援額外的訊息交換動作以終止工作階段對話。接著，用戶端就可以使用此動作。下列 WSDL 程式碼會顯示從 HttpCookieSessionBindingElement 建立的原則判斷提示。

<wsp:Policy wsu:Id="HttpCookieSessionBinding_IWcfCookieSessionService_policy" xmlns:wsp="https://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsp:ExactlyOne>
<wsp:All>
<wspe:Utf816FFFECharacterEncoding xmlns:wspe="https://schemas.xmlsoap.org/ws/2004/09/policy/encoding"/>
<mhsc:httpSessionCookie xmlns:mhsc="http://samples.microsoft.com/wcf/mhsc/policy"/>
</wsp:All>
</wsp:ExactlyOne>
</wsp:Policy>

HttpCookieSessionBinding 類別是系統提供的繫結，會使用先前描述的繫結項目。

將通道新增至組態系統

此範例提供了兩個類別，這兩個類別會透過組態來公開範例通道。第一個類別為 HttpCookieSessionBindingElement 的 BindingElementExtensionElement。大量實作會委派至衍生自 StandardBindingElement 的 HttpCookieSessionBindingConfigurationElement。 HttpCookieSessionBindingConfigurationElement 的屬性會對應至 HttpCookieSessionBindingElement 上的屬性。

繫結項目延伸區段

區段 HttpCookieSessionBindingElementSection 是 BindingElementExtensionElement，會將 HttpCookieSessionBindingElement 公開至組態系統。透過一些覆寫，會定義組態區段名稱、繫結項目的型別，以及如何建立繫結項目。然後您可以在組態檔中登錄延伸區段，如同下列所示：

<configuration>      
    <system.serviceModel>      
      <extensions>        
        <bindingElementExtensions>          
          <add name="httpCookieSession" 
               type=
"Microsoft.ServiceModel.Samples.HttpCookieSessionBindingElementElement, 
                    HttpCookieSessionExtension, Version=1.0.0.0, 
                    Culture=neutral, PublicKeyToken=null"/>
        </bindingElementExtensions >
      </extensions>

      <bindings>
      <customBinding>
        <binding name="allowCookiesBinding">
          <textMessageEncoding messageVersion="Soap11WSAddressing10" />
          <httpCookieSession sessionTimeout="10" exchangeTerminateMessage="true" />
          <httpTransport allowCookies="true" />
        </binding>
      </customBinding>
      </bindings>      
    </system.serviceModel>  
</configuration>

測試程式碼

您可以在用戶端和服務目錄中，找到使用此範例傳輸的測試程式碼。其中包含了兩個測試：第一個測試會使用其 allowCookies 在用戶端上已設為 true 的繫結。第二個測試則會在繫結上啟用明確關閉 (使用終止訊息交換)。

當您執行範例時，您應該會看到下列輸出：

Simple binding:
AddItem(10000,2): ItemCount=2
AddItem(10550,5): ItemCount=7
RemoveItem(10550,2): ItemCount=5
Items
10000, 2
10550, 3
Smart binding:
AddItem(10000,2): ItemCount=2
AddItem(10550,5): ItemCount=7
RemoveItem(10550,2): ItemCount=5
Items
10000, 2
10550, 3

Press <ENTER> to terminate client.

若要安裝、建立及執行範例

使用下列命令安裝 ASP.NET 4.0。

%windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable

請確定您已執行 Windows Communication Foundation 範例的單次安裝程序。
若要建置方案，請遵循建置 Windows Communication Foundation 範例中的指示。
若要在單一或跨電腦的組態中執行本範例，請遵循Running the Windows Communication Foundation Samples中的指示。

共用方式為