web api (.NET 4.5)

迈不过友情╰ 2021-12-20 23:57 164阅读 0赞

摘自http://blog.csdn.net/fangxing80/article/details/7318289

在刚刚发布的 ASP.NET MVC 4 中，有一个值得注意的新特性——Web Api，微软官方的介绍是：  
  
ASP.NET MVC 4 中包含了Web API 它能够构建HTTP服务以支撑更广泛的客户端，包括浏览器，手机和平板电脑的框架。  
ASP.NET Web API是非常棒的构建服务的框架，遵循REST架构风格，而且它支持的RPC模式。

从 .NET 3.5 开始 WCF 已经支持用 WebHttpBinding 构建 RESTful Web 服务，基于 WCF 框架的 Web Api 还是建立在 WCF Message 栈上，因为 REST 的工作原理有所不同，它不需要依赖 SOAP 协议，因此 WCF 消息管道对于它经过了特殊的消息优化。但 REST 集成在 WCF 消息管道上还是不理想，所以微软提出在 ASP.NET 平台上构建REST服务，也就有了现在 ASP.NET MVC 4 中的 Web Api。  
  
引用 WCF 在 Codeplex 上的声明：  
Announcement: [WCF Web API is now ASP.NET Web API][]! [ASP.NET Web API][] released with ASP.NET MVC 4 Beta.  
The WCF Web API and WCF support for jQuery content on this site wll removed by the end of 2012.  
  
如果对 REST WCF 框架熟悉的童鞋，可以参看下面的 WCF Web Api 到 ASP.NET Web Api 的映射表：

<table> 
 <tbody> 
  <tr> 
   <td><strong>WCF Web API</strong></td> 
   <td><strong>ASP.NET Web API</strong></td> 
  </tr> 
  <tr> 
   <td>Service</td> 
   <td>Web API controller</td> 
  </tr> 
  <tr> 
   <td>Operation</td> 
   <td>Action</td> 
  </tr> 
  <tr> 
   <td>Service contract</td> 
   <td>Not applicable</td> 
  </tr> 
  <tr> 
   <td>Endpoint</td> 
   <td>Not applicable</td> 
  </tr> 
  <tr> 
   <td>URI templates</td> 
   <td>ASP.NET Routing</td> 
  </tr> 
  <tr> 
   <td>Message handlers</td> 
   <td>Same</td> 
  </tr> 
  <tr> 
   <td>Formatters</td> 
   <td>Same</td> 
  </tr> 
  <tr> 
   <td>Operation handlers</td> 
   <td>Filters, model binders</td> 
  </tr> 
 </tbody> 
</table>

下面来看看如何使用 ASP.NET Web Api （使用的是 VS11 Beta 版）  
(1) 创建 ASP.NET MVC 4 工程时选择 Web Api  
![0_1330866316j1h7.gif][]

创建出的工程中，Controllers 目录下会有一个 ValuesController.cs 注意它继承于 ApiController

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Net.Http; 
5.  using System.Web.Http; 
6.  
7.  namespace MvcApplication1.Controllers 
8.  \{
9.  public class ValuesController : ApiController 
10. \{
11. // GET /api/values 
12. public IEnumerable<string> Get() 
13. \{
14. return new string\[\] \{ "value1", "value2" \}; 
15. \}
16. 
17. // GET /api/values/5 
18. public string Get(int id) 
19. \{
20. return "value"; 
21. \}
22. 
23. // POST /api/values 
24. public void Post(string value) 
25. \{
26. \}
27. 
28. // PUT /api/values/5 
29. 
30. public void Put(int id, string value) 
31. \{
32. \}
33. 
34. // DELETE /api/values/5 
35. public void Delete(int id) 
36. \{
37. \}
38. \}
39. \}

在 Global.cs 中，注册了 Api 的 Url Map： api/\{controller\}/\{id\} 每个"Action"是通过 Http谓词(GET/POST/PUT/DELETE)映射的。

**\[csharp\]** [view plain][] [copy][view plain]

1.  public static void RegisterRoutes(RouteCollection routes) 
2.  \{
3.  routes.IgnoreRoute("\{resource\}.axd/\{\*pathInfo\}"); 
4.  
5.  routes.MapHttpRoute(
6.  name: "DefaultApi", 
7.  routeTemplate: "api/\{controller\}/\{id\}", 
8.  defaults: new \{ id = RouteParameter.Optional \} 
9.  );
10. 
11. routes.MapRoute(
12. name: "Default", 
13. url: "\{controller\}/\{action\}/\{id\}", 
14. defaults: new \{ controller = "Home", action = "Index", id = UrlParameter.Optional \} 
15. );
16. \}

(2) 增加一个自定义 Model

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Web; 
5.  
6.  namespace MvcApplication1.Models 
7.  \{
8.  public class Task 
9.  \{
10. public string Id \{ get; set; \} 
11. public string Title \{ get; set; \} 
12. public string Content \{ get; set; \} 
13. public int Status \{ get; set; \} 
14. \}
15. \}

(3) 增加一个自定义 Repository

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Web; 
5.  using MvcApplication1.Models; 
6.  
7.  namespace MvcApplication1.Repositories 
8.  \{
9.  public class TaskRepository 
10. \{
11. private List<Task> \_tasks; 
12. 
13. public TaskRepository() 
14. \{
15. \_tasks = new List<Task> \{ 
16. new Task \{ Id="T001", Title="title1", Content="content1" \}, 
17. new Task \{ Id="T002", Title="title2", Content="content2" \}, 
18. new Task \{ Id="T003", Title="title3", Content="content3" \}, 
19. new Task \{ Id="T004", Title="title4", Content="content4" \}, 
20. \};
21. \}
22. 
23. public IEnumerable<Task> GetAll() 
24. \{
25. return \_tasks; 
26. \}
27. 
28. public Task FindById(string id) 
29. \{
30. return \_tasks.FirstOrDefault(t => t.Id == id); 
31. \}
32. 
33. public void Add(Task task) 
34. \{
35. \_tasks.Add(task);
36. \}
37. 
38. public void RemoveById(string id) 
39. \{
40. var task = \_tasks.FirstOrDefault(t => t.Id == id);
41. if (task != null) 
42. \_tasks.Remove(task);
43. \}
44. \}
45. \}

(4) 增加 TaskController

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Net.Http; 
5.  using System.Web.Http; 
6.  using MvcApplication1.Models; 
7.  
8.  namespace MvcApplication1.Controllers 
9.  \{
10. public class TasksController : ApiController 
11. \{
12. private Repositories.TaskRepository \_taskRepository = new Repositories.TaskRepository(); 
13. 
14. // GET /api/tasks 
15. public IQueryable<Task> Get() 
16. \{
17. return \_taskRepository.GetAll().AsQueryable(); 
18. \}
19. 
20. // GET /api/tasks/5 
21. public Task Get(string id) 
22. \{
23. return \_taskRepository.FindById(id); 
24. \}
25. 
26. // POST /api/tasks 
27. public void Post(Task task) 
28. \{
29. \_taskRepository.Add(task);
30. \}
31. 
32. // DELETE /api/tasks/5 
33. public void Delete(string id) 
34. \{
35. \_taskRepository.RemoveById(id);
36. \}
37. \}
38. \}

运行：  
![0_133086865911lp.gif][]  
  
同样，客户端可以通过 Http Header 的 Accept 指定返回数据的格式。默认是支持：appliction/xml 和 application/json  
当想返回比如 image/jpeg 这样的图片格式时，需要添加 MediaTypeFormatter  
  
比如：当指定某个 Task 时，通过指定 Accept : image/jpeg 获取该 Task 的图片信息。

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Net.Http.Formatting; 
5.  using System.Web; 
6.  using MvcApplication1.Models; 
7.  
8.  namespace MvcApplication1.Repositories 
9.  \{
10. public class TaskPictureFormatter : MediaTypeFormatter 
11. \{
12. protected override bool CanWriteType(Type type) 
13. \{
14. return (type == typeof(Task)); 
15. \}
16. 
17. public TaskPictureFormatter() 
18. \{
19. SupportedMediaTypes.Add(new System.Net.Http.Headers.MediaTypeHeaderValue("image/jpeg")); 
20. \}
21. 
22. protected override System.Threading.Tasks.Task OnWriteToStreamAsync(Type type, object value, 
23. System.IO.Stream stream, System.Net.Http.Headers.HttpContentHeaders contentHeaders,
24. FormatterContext formatterContext, System.Net.TransportContext transportContext)
25. \{
26. var task = value as Task; 
27. if (task != null) 
28. \{
29. var data = System.IO.File.ReadAllBytes(HttpContext.Current.Server.MapPath("~/TaskImages/" + task.Id + ".png")); 
30. return stream.WriteAsync(data, 0, data.Length); 
31. \}
32. else 
33. \{
34. throw new HttpException((int)System.Net.HttpStatusCode.NotFound, "task is not found", null); 
35. \}
36. \}
37. \}
38. \}

注意：当找不到对应的图片时，抛出 HttpException 这样可以给客户端更加友好的错误提示。  
![0_1330872698n4H1.gif][]  
  
当输入一个错误的Id:  
![0_133087292196t2.gif][]

另外一个强大的功能是 Web Api 的 SelfHost，通过 HttpSelfHostServer 就可以非常方便的将 Web Api 寄宿到 IIS 以外的应用中去了。  
作为简单数据交换的应用场景十分有用。  
  
注意工程需要添加以下引用：

*  System.Net.Http
 *  System.Web.Extensions
 *  System.Web.Http
 *  System.Web.Http.Common
 *  System.Web.Http.SelfHost

**\[csharp\]** [view plain][] [copy][view plain]

1.  using System; 
2.  using System.Collections.Generic; 
3.  using System.Linq; 
4.  using System.Text; 
5.  using System.Threading.Tasks; 
6.  using System.Web.Http; 
7.  using System.Web.Http.SelfHost; 
8.  
9.  namespace WebApiSelfHostTest 
10. \{
11. class Program 
12. \{
13. static void Main(string\[\] args) 
14. \{
15. var config = new HttpSelfHostConfiguration("http://localhost:8080"); 
16. 
17. config.Routes.MapHttpRoute(
18. "API Default", "api/\{controller\}/\{id\}", 
19. new \{ id = RouteParameter.Optional \}); 
20. 
21. using (HttpSelfHostServer server = new HttpSelfHostServer(config)) 
22. \{
23. server.OpenAsync().Wait();
24. 
25. Console.WriteLine("HttpServer is opening, Press Enter to quit."); 
26. Console.ReadLine();
27. \}
28. \}
29. \}
30. 
31. public class Product 
32. \{
33. public int Id \{ get; set; \} 
34. public string Name \{ get; set; \} 
35. public decimal Price \{ get; set; \} 
36. \}
37. 
38. public class ProductsController : ApiController 
39. \{
40. public IEnumerable<Product> GetAllProducts() 
41. \{
42. return new List<Product> 
43. \{
44. new Product() \{ Id = 1, Name = "Gizmo 1", Price = 1.99M \}, 
45. new Product() \{ Id = 2, Name = "Gizmo 2", Price = 2.99M \}, 
46. new Product() \{ Id = 3, Name = "Gizmo 3", Price = 3.99M \} 
47. \};
48. \}
49. \}
50. \}

![0_1330874772hSS2.gif][]  
![0_13308750813277.gif][]

转载于:https://www.cnblogs.com/panpeng666/p/4403050.html

[WCF Web API is now ASP.NET Web API]: http://wcf.codeplex.com/discussions/319671
[ASP.NET Web API]: http://www.asp.net/web-api
[0_1330866316j1h7.gif]: /images/20211220/377937b219ed4a81a0ab1922dcb0cbeb.png
[view plain]: http://blog.csdn.net/fangxing80/article/details/7318289
[0_133086865911lp.gif]: /images/20211220/624be85dfe704e688ecea9b8fefd7c94.png
[0_1330872698n4H1.gif]: /images/20211220/eb03cf7f9fc649619bfd0edd89159ea1.png
[0_133087292196t2.gif]: /images/20211220/4288fe4a5afc484fb3444e8a010d76f6.png
[0_1330874772hSS2.gif]: /images/20211220/d84eace64789418582ab6b3bdfe76b46.png
[0_13308750813277.gif]: /images/20211220/98f0d0c729c740419c21f0eac848f558.png