WCF服務編程設計規範(5):事務與併發管理設計

今天整理的內容是WCF事務和併發管理相關的設計規範。WCF服務編程設計規範(5):事務與併發管理設計。中英文對照，How to design Transactions and Concurrency Management in WCF Service.

下面一節是隊列服務與安全。

本系列相關文章：

1. WCF服務編程設計規範(1)：最新版WCF Coding Standard 介紹和下載

2. WCF服務編程設計規範(2):序言、通用設計規範和要點

3. WCF服務編程設計規範(3):服務契約、數據契約和實例管理設計規範

4. WCF服務編程設計規範(4):操做與錯誤設計

Transactions

事務

1. Never manage transactions directly.

         不要直接管理事務

2. Apply the TransactionFlow attribute on the contract, not the service class.

         在契約而不是服務類上標註 TransactionFlow 屬性，

3. Do not perform transactional work in the service constructor.

         不要在服務的構造函數裏執行事務操做

4. Using this book’s terminology, configure services for either Client or Client/Service transactions. Avoid None or Service transactions.

         使用本書中的術語，爲客戶端或客戶端 / 服務端事務模式配置服務。避免使用 None 或服務事務模式。

5. Using this book’s terminology, configure callbacks for either Service or Service/Callback transactions. Avoid None or Callback transactions.

         使用本書中的術語，爲服務或服務 / 回調事務模式配置回調。避免使用 None 或回調事務模式。

6. When using the Client/Service or Service/Callback mode, constrain the binding to flow transactions using the BindingRequirement attribute.

         當使用客戶端 / 服務或服務 / 回調模式，經過 BindingRequirement 屬性約束綁定傳播事務

7. On the client, always catch all exceptions thrown by a service configured for None or Service transactions.

         在客戶端，始終捕獲 None 或服務事務裏拋出的全部異常。

8. Enable reliability and ordered delivery even when using transactions.

         即便使用事務的時候，也要啓用可靠性和順序傳遞

9. In a service operation, never catch an exception and manually abort the transaction:

         在服務操做裏，不要捕獲異常並手動終止事務

　　//Avoid: 避免

　　[OperationBehavior(TransactionScopeRequired = true)]

　　public void MyMethod()

　　{

　　try

　　{

　　...

　　}

　　catch

　　{

　　Transaction.Current. Rollback ();

　　}

　　}

10. If you catch an exception in a transactional operation, always rethrow it or another exception.

         若是你在一個事務性操做裏捕獲了異常，始終直接從新拋出這個異常或者拋出另一個異常

11. Keep transactions short.

         保持事務簡潔

12. Always use the default isolation level of IsolationLevel.Serializable .

         使用 IsolationLevel.Serializable 默認的事物隔離級別

13. Do not call one-way operations from within a transaction.

         不要在事務內部調用一個單向操做

14. Do not call nontransactional services from within a transaction.

         不要在一個事務內部調用一個非事務服務

15. Do not access nontransactional resources (such as the filesystem) from within a transaction.

         不要在一個事務內訪問非事務性資源（好比文件系統）

16. With a sessionful service, avoid equating the session boundary with the transaction boundary by relying on auto-complete on session close.

         對於會話服務，避免由於會話關閉時的 auto-complete 就把會話邊界和事務邊界等價。

17. Strive to use the TransactionalBehavior attribute to manage transactions on sessionful services:

         儘可能使用 TransactionalBehavior 屬性去管理會話服務上的事務

[Serializable]

[TransactionalBehavior]

class MyService : IMyContract

{

public void MyMethod()

{...}

}

18. When using a sessionful or transactional singleton, use volatile resource managers to manage state and avoid explicitly state-aware programming or relying on WCF’s

instance deactivation on completion.

         當使用會話或事務性的單例服務時，使用易失資源管理器去管理狀態，而且避免顯示地使用狀態編程或者在完整時依賴 WCF 實例鈍化機制，

19. With transactional durable services, always propagate the transaction to the store by setting SaveStateInOperationTransaction to true .

在持久性事務服務裏，始終經過設置 SaveStateInOperationTransaction 爲 true 來把事務和傳播到存儲系統中。

Concurrency Management

併發管理

1. Always provide thread-safe access to:

         對如下資源始終提供線程安全的訪問

a) Service in-memory state with sessionful or singleton services

         會話或者單例服務在內存中的狀態

b) Client in-memory state during callbacks

         回調期間客戶端在內存中的狀態

c) Shared resources

         共享資源

d) Static variables

         靜態變量

2. Prefer ConcurrencyMode.Single (the default). It enables transactional access and provides thread safety without any effort.

         默認狀況推薦使用 ConcurrencyMode.Single 模式。它會啓用事務性訪問並提供線程安全，而不會帶來任何開銷。

3. Keep operations on single-mode sessionful and singleton services short in order to avoid blocking other clients for long.

         當操做在是單個會話模式或者單例模式時，請保證操做簡短，以長時間免阻塞客戶端。

4. When using ConcurrencyMode.Multiple , you must use transaction autocompletion.

         當使用 ConcurrencyMode.Multiple 時，你必須啓用事務 autocompletion 自動提交機制。

5. Consider using ConcurrencyMode.Multiple on per-call services to allow concurrent calls.

         在單調服務上使用 ConcurrencyMode.Multiple 屬性，容許併發調用，

6. Transactional singleton service with ConcurrencyMode.Multiple must have ReleaseServiceInstanceOnTransactionComplete set to false :

         使用 ConcurrencyMode.Multiple 的 事務性單例服務必須把 ReleaseServiceInstanceOnTransactionComplete 設置爲 false

　　[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single,

　　ConcurrencyMode = ConcurrencyMode. Multiple ,

　　ReleaseServiceInstanceOnTransactionComplete = false)]

　　class MySingleton : IMyContract

　　{...}

7. Never self-host on a UI thread, and have the UI application call the service.

         不要在 UI 線程上託管服務，讓 UI 程序只調用服務。

8. Never allow callbacks to the UI application that called the service unless the callback posts the call using SynchronizationContext.Post() .

         從不容許服務回調 UI 程序，除非回調使用了 SynchronizationContext.Post() .

9. When supplying the proxy with both synchronous and asynchronous methods, apply the FaultContract attribute only to synchronous methods.

         當代理提供了異步和同步方法的時候，在同步方法上使用 FaultContract

10. Keep asynchronous operations short. Do not equate asynchronous calls with lengthy operations.

         保持異步調用操做簡短。不要把異步調用和冗長的操做混淆。

11. Do not mix transactions with asynchronous calls.

         不要把事務和異步調用混用