HOW TO：建立交易式服務

發行項
09/12/2008

這個範例示範建立交易式服務的各層面，以及使用用戶端初始化的交易以協調服務作業。

建立交易式服務

建立服務合約並使用 TransactionFlowOption 列舉的所需設定來標註作業，以指定傳入交易的需求。請注意，您也可以將 TransactionFlowAttribute 置於已實作的服務類別上。這可以讓介面的單一實作 (而不是每個實作) 使用這些交易設定。

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    // Use this to require an incoming transaction
    [TransactionFlow(TransactionFlowOption.Mandatory)]
    double Add(double n1, double n2);
    [OperationContract]
    // Use this to permit an incoming transaction
    [TransactionFlow(TransactionFlowOption.Allowed)]
    double Subtract(double n1, double n2);
}

建立實作類別，然後使用 ServiceBehaviorAttribute 選擇性地指定 TransactionIsolationLevel 和 TransactionTimeout。您應該注意到在許多案例中，TransactionTimeout 預設 60 秒以及 TransactionIsolationLevel 預設 Unspecified 是適當的。針對每個作業，您可以使用 OperationBehaviorAttribute 屬性指定在方法內執行的工作，是否應該發生在根據 TransactionScopeRequired 屬性值定義的交易範圍內。在此例中，Add 方法使用的交易與從用戶端流入的強制傳入交易相同，而且 Subtract 方法使用的交易會與傳入交易相同 (如果交易從用戶端流入)，或是與本機建立的新隱含交易相同。

[ServiceBehavior(
    TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable,
    TransactionTimeout = "00:00:45")]
public class CalculatorService : ICalculator
{
    [OperationBehavior(TransactionScopeRequired = true)]
    public double Add(double n1, double n2)
    {
        // Perform transactional operation
        RecordToLog(String.Format("Adding {0} to {1}", n1, n2));
        return n1 + n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Subtract(double n1, double n2)
    {
        // Perform transactional operation
        RecordToLog(String.Format("Subtracting {0} from {1}", n2, n1));
        return n1 - n2;
    }

    private static void RecordToLog(string recordText)
    {
        // Database operations omitted for brevity
        // This is where the transaction provides specific benefit
        // - changes to the database will be committed only when
        // the transaction completes.
    }
}

在組態檔中設定繫結、指定應該流動的交易內容，以及要用來執行這些動作的通訊協定。如需詳細資訊，請參閱 ServiceModel 交易組態。明確地說，在端點項目的 binding 屬性中會指定繫結類型。<endpoint> 項目包含參考名為 transactionalOleTransactionsTcpBinding 之繫結組態的 bindingConfiguration 屬性，如同下列範例組態所示。
```
<service name="CalculatorService">
  <endpoint address="net.tcp://localhost:8008/CalcService"
    binding="netTcpBinding"
    bindingConfiguration="transactionalOleTransactionsTcpBinding"
    contract="ICalculator"
    name="OleTransactions_endpoint" />
</service>
```
藉由使用 transactionFlow 屬性能夠在組態層級啟用交易流程，而使用 transactionProtocol 屬性可以指定交易通訊協定，如同下列組態所示。
```
<bindings>
  <netTcpBinding>
    <binding name="transactionalOleTransactionsTcpBinding"
      transactionFlow="true"
      transactionProtocol="OleTransactions"/>
  </netTcpBinding>
</bindings>
```

支援多個交易通訊協定

如需最佳效能，對於與使用 Windows Communication Foundation (WCF) 撰寫用戶端與服務有關的案例，您應該使用 OleTransactions 通訊協定。但是，WS-AtomicTransaction (WS-AT) 通訊協定在需要協力廠商堆疊之互通性的案例中很有用。您可以使用適當的通訊協定特定繫結提供多重端點，以設定 WCF 服務同時接受兩種通訊協定，如同下列範例組態所示。

<service name="CalculatorService">
  <endpoint address="https://localhost:8000/CalcService"
    binding="wsHttpBinding"
    bindingConfiguration="transactionalWsatHttpBinding"
    contract="ICalculator"
    name="WSAtomicTransaction_endpoint" />
  <endpoint address="net.tcp://localhost:8008/CalcService"
    binding="netTcpBinding"
    bindingConfiguration="transactionalOleTransactionsTcpBinding"
    contract="ICalculator"
    name="OleTransactions_endpoint" />
</service>

使用 transactionProtocol 屬性可以指定交易通訊協定。但是，系統提供的 wsHttpBinding 並沒有這個屬性，因為這個繫結只能夠使用 WS-AT 通訊協定。

<bindings>
  <wsHttpBinding>
    <binding name="transactionalWsatHttpBinding"
      transactionFlow="true" />
  </wsHttpBinding>
  <netTcpBinding>
    <binding name="transactionalOleTransactionsTcpBinding"
      transactionFlow="true"
      transactionProtocol="OleTransactions"/>
  </netTcpBinding>
</bindings>

控制交易完成

根據預設，如果並未發生未處理的例外狀況，WCF 作業會自動完成交易。您可以藉由使用 TransactionAutoComplete 屬性和 SetTransactionComplete 方法修改這個行為。當作業需要發生在與其他作業相同的交易中 (例如，借貸作業) 時，您可以將 TransactionAutoComplete 屬性設定為 false 以停用自動完成行為，如同下列 Debit 作業範例所示。在呼叫 TransactionAutoComplete 屬性設定為 true 的方法 (如同作業 Credit1 中所示)，或是呼叫 SetTransactionComplete 方法以明確標記交易完成 (如同作業 Credit2 中所示) 後，Debit 作業使用的交易才完成。請注意，這兩個貸款作業是為了示範目的，而單一貸款作業會更單純。
```
[ServiceBehavior]
public class CalculatorService : IAccount
{
    [OperationBehavior(
        TransactionScopeRequired = true, TransactionAutoComplete = false)]
    public void Debit(double n)
    {
        // Perform debit operation

        return;
    }

    [OperationBehavior(
        TransactionScopeRequired = true, TransactionAutoComplete = true)]
    public void Credit1(double n)
    {
        // Perform credit operation

        return;
    }

    [OperationBehavior(
        TransactionScopeRequired = true, TransactionAutoComplete = false)]
    public void Credit2(double n)
    {
        // Perform alternate credit operation

        OperationContext.Current.SetTransactionComplete();
        return;
    }
}
```

為了交易相互關聯目的，將 TransactionAutoComplete 屬性設定為 false 需要使用工作階段繫結。ServiceContractAttribute 的 SessionMode 屬性會指定這項需求。

[ServiceContract(SessionMode = SessionMode.Required)]
public interface IAccount
{
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Allowed)]
    void Debit(double n);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Allowed)]
    void Credit1(double n);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Allowed)]
    void Credit2(double n);
}

控制交易式服務執行個體的存留時間

WCF 會使用 ReleaseServiceInstanceOnTransactionComplete 屬性指定當交易完成時是否要釋放基礎服務執行個體。因為這個預設值為 true，除非另外設定，不然 WCF 會顯示有效率與可預測的 "just-in-time" 啟動行為。呼叫後續交易的服務，可以確保新服務執行個體不會有之前交易狀態的殘餘資料。雖然這方法通常很有用，但是有時候您可能會想要在交易完成之外維護服務執行個體中的狀態。這種情況的範例是，當必要的狀態或資源控制代碼很難擷取或重組時。藉由將 ReleaseServiceInstanceOnTransactionComplete 屬性設定為 false，您可以達到這個目的。使用這項設定時，後續呼叫就可以使用執行個體與任何關聯的狀態。當使用這項功能時，請特別考量清除與完成狀態及交易的時機與方式。下列範例示範如何使用 runningTotal 變數來維護執行個體以進行這項作業。

[ServiceBehavior(TransactionIsolationLevel = [ServiceBehavior(
    ReleaseServiceInstanceOnTransactionComplete = false)]
public class CalculatorService : ICalculator
{
    double runningTotal = 0;

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Add(double n)
    {
        // Perform transactional operation
        RecordToLog(String.Format("Adding {0} to {1}", n, runningTotal));
        runningTotal = runningTotal + n;
        return runningTotal;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Subtract(double n)
    {
        // Perform transactional operation
        RecordToLog(String.Format("Subtracting {0} from {1}", n, runningTotal));
        runningTotal = runningTotal - n;
        return runningTotal;
    }

    private static void RecordToLog(string recordText)
    {
        // Database operations omitted for brevity
    }
}

注意：
因為執行個體的存留時間是服務的內部行為，並且透過 ServiceBehaviorAttribute 屬性控制，所以不需要修改服務組態或服務合約來設定執行個體行為。此外，網路中不會包含任何表示法。

共用方式為

HOW TO：建立交易式服務

建立交易式服務

支援多個交易通訊協定

控制交易完成

控制交易式服務執行個體的存留時間

其他資源