二、WebOperationContext与条件更新

服务端进行条件更新检测，以及客户端对If-Match请求报头的设置都可以通过当前的WebOperationContext来完成。如下面的代码片断所示，表示入栈请求上下文的IncomingWebRequestContext类型具有如下四个CheckConditionalUpdate方法重载用于进行添加更新检测。

 1: public class IncomingWebRequestContext

 2: {

 3: //其他成员

 4: public void CheckConditionalUpdate(Guid entityTag);

 5: public void CheckConditionalUpdate(int entityTag);

 6: public void CheckConditionalUpdate(long entityTag);

 7: public void CheckConditionalUpdate(string entityTag);

 8: }

实现在CheckConditionalUpdate方法中的条件更新检测具有这样的逻辑：对于HTTP方法为PUT的请求，如果If-Match报头值不为“*”，则直接抛出HTTP状态为PreconditionFailed的WebFaultException异常；对于HTTP方法为POST和DELETE的请求来说，如果If-Match报头值为“*”或者包含指定的entityTag则验证通过，否则同样则直接抛出HTTP状态为PreconditionFailed的WebFaultException异常。

表示出栈请求上下文的OutgoingWebRequestContext类型具有如下一个IfMatch属性，客户端可以通过该属性对请求消息的If-Match报头进行设置。

 1: public class OutgoingWebRequestContext

 2: {

 3: //其他成员

 4: public string IfMatch { get; set; }

 5: }

三、实例演示：通过条件更新解决对相同资源的并发修改

我们同样通过对EmployeesService进行相应的改造来模拟如何通过添加更新实现对相同资源的并发操作问题，这次我们修改的是用于获取指定ID员工信息的Get操作和用于修改员工信息的Update操作。Get操作在返回与指定员工ID匹配的Employee对象之前我们将该对象的哈希码作为了回复消息的ETag报头（Employee类型重写了GetHashCode方法）。

 1: public class EmployeesService : IEmployees

 2: {

 3: //其他成员

 4: public Employee Get(string id)

 5: {

 6: Employee employee = employees.FirstOrDefault(e => e.Id == id);

 7: if (null == employee)

 8: {

 9: throw new WebFaultException(HttpStatusCode.NotFound);

10: }

11: WebOperationContext.Current.OutgoingResponse.SetETag(employee.GetHashCode());

12: return employee;

13: }

14: public void Update(Employee employee)

15: {

16: var existing = employees.FirstOrDefault(e => e.Id == employee.Id);

17: if (null == existing)

18: {

19: throw new WebFaultException(HttpStatusCode.NotFound);

20: }

21: //模拟并发修改

22: existing.Name += Guid.NewGuid().ToString();

23:

24: WebOperationContext.Current.IncomingRequest.CheckConditionalUpdate(existing.GetHashCode());

25: employees.Remove(existing);

26: employees.Add(employee);

27: WebOperationContext.Current.OutgoingResponse.SetETag(employee.GetHashCode());

28:

29: }

30: }

Update方法中我们通过手工修改相应员工的Name属性的方式来模拟针对相同员工信息的并发修改。在真正实施修改之前调用当前IncomingWebRequestContext的CheckConditionalUpdate方法进行条件更新检测，而作为参数传入的ETag值为代表目前员工的Employee对象的哈希码。方法的最后我们对回复消息的ETag报头作了更新。

我们通过手工创建HTTP请求的方式对上述的两个服务操作进行调用。如下面的代码片断所示，我们首先通过创建的HttpWebRequest对象调用Get操作获得ID为001的员工信息并将其打印出来。然后创建调用Update操作的HttpWebRequest，并对HTTP方法（POST）和内容类型（application/xml）进行了相应的设置。我们之前针对员工获取请求得到ETag报头和员工数据作为本次请求的If-Match报头和主体。如果调用GetResponse方法抛出WebException异常，并且其回复状态为PreconditionFailed，则表明试图修改的员工信息已被另一个用户修改过了，所以我么打印“服务端数据已发生变化”字样。

 1: Uri address = new Uri("http://127.0.0.1:3721/employees/001");

 2: var request = (HttpWebRequest)HttpWebRequest.Create(address);

 3: request.Method = "GET";

 4: var response = (HttpWebResponse)request.GetResponse();

 5: string employee;

 6: using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))

 7: {

 8: employee = reader.ReadToEnd();

 9: Console.WriteLine("获取员工信息：");

10: Console.WriteLine(employee + "\n");

11: }

12: try

13: {

14: address = new Uri("http://127.0.0.1:3721/employees/");

15: request = (HttpWebRequest)HttpWebRequest.Create(address);

16: request.Method = "POST";

17: request.ContentType = "application/xml";

18: byte[] buffer = Encoding.UTF8.GetBytes(employee);

19: request.GetRequestStream().Write(Encoding.UTF8.GetBytes(employee), 0, buffer.Length);

20: request.Headers.Add(HttpRequestHeader.IfMatch, response.Headers[HttpResponseHeader.ETag]);

21: Console.WriteLine("修改员工信息:");

22: request.GetResponse();

23: }

24: catch (WebException ex)

25: {

26: response = ex.Response as HttpWebResponse;

27: if (null == response)

28: {

29: throw;

30: }

31: if (response.StatusCode == HttpStatusCode.PreconditionFailed)

32: {

33: Console.WriteLine("服务端数据已发生变化");

34: }

35: else

36: {

37: throw;

38: }

39: }

在服务成功寄宿的情况下调用这段程序会在控制台上输出如下的结果。由于并发错误的发生，员工信息其实并没有被真正修改。

 1: 获取员工信息：

 2: <Employee xmlns="http://www.artech.com/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><Department>开发部</Department><Grade>G7</Grade><Id>001</Id><Name>张三</Name></Employee>