教你如何构建简单Web API

开发 后端
这个入门文章主要演示在ASP.NET MVC3网站宿主,让各位.NET程序员知道如何构建简单Web API。

  WCF Web API支持多个宿主环境:自宿主(windows服务或者控制台)和IIS宿主(ASP.NET webform/mvc)。这个入门文章主要演示在ASP.NET MVC3网站宿主:

  如何使用NuGet向项目中添加Web Api引用

  如何创建一个通过HTTP GET访问的Web Api

  如何通过ASP.NET routes宿主一个Web Api

  如何通过浏览器或者Fiddler访问Web Api

  如何在Api上启用OData uri查询

  1、创建一个基本的解决方案:使用VS2010新建一个空的ASP.NET MVC 3 Web Application

设置站点的端口号为9000

2、向解决方案中加入Web Api的引用

  通过NuGet来添加Web api的程序集引用,右击项目属性,选择“Manage NuGet Packages”

在NuGet管理扩展器上查询Online的”webapi.all“

选择安装,NuGet就会下载所有所需的软件包,现在可以开始开发Web Api。

  3、创建一个Contacts Api类

  右击项目ContactManager选择添加一个文件夹,取名”APIs“,然后在APIs文件夹上右击添加类,类名叫做ContactsApi:

  1.   usingSystem.ServiceModel;  
  2.   namespaceContactManager.APIs  
  3.   {  
  4.   [ServiceContract]  
  5.   publicclassContactsApi  
  6.   {  
  7.   }  
  8.   } 

  ContractsApi 加了ServiceContractAttribute表示这是一个WCF 服务,将通过HTTP方式暴露出来。

  4、通过ASP.NET routing注册ContractsApi

  Api需要通过ASP.NET mvc宿主,使用ASP.net Route的MapServiceRoute扩展方法把它注册进去。切换到global.asax.cs文件,添加以下引用

  usingContactManager.APIs;

  usingMicrosoft.ApplicationServer.Http.Activation;

  在RegisterRoutes方法里加入下述代码

  routes.MapServiceRoute<ContactsApi>("api/contacts");

  下面的黄色部分很重要,MVC的默认路由是映射到controller + action

  1.   publicstaticvoidRegisterRoutes(RouteCollection routes)  
  2.   {  
  3.   routes.IgnoreRoute("{resource}.axd/{*pathInfo}");  
  4.   routes.MapServiceRoute<ContactsApi>("api/contacts");routes.MapRoute(  
  5.   "Default"// Route name  
  6.   "{controller}/{action}/{id}"// URL with parameters  
  7.   new{ controller = "Home", action = "Index", id = UrlParameter.Optional } // Parameter defaults  
  8.   );  
  9.   } 

  MapServiceRoute需要一个泛型参数指定服务(API),以及一个将被追加到IIS base url的路径。在这里,我们指定的“contacts”,也就是宿主为“http://localhost:9000/api/contacts”。

  5. 通过一个HTTP Get 方法暴露contacts:首先创建一个poco(Plain Old C#)Contract类,代表我们在api上传递的联系人,本质上就是一个DTO(数据传输对象),在HTTP上我们把它作为资源,然后创建一个HTTP Get方法暴露资源。

  右击项目ContactManager项目选择添加新的文件夹“Resources”,在Resources文件下创建一个新的类Contact。

  1.   namespaceContactManager.Resources  
  2.   {  
  3.   publicclassContact  
  4.   {  
  5.   publicintContactId { getset; }  
  6.   publicstringName { getset; }  
  7.   }  
  8.   } 

  返回到ContactApi类,添加下述引用:

  1.   usingSystem.ServiceModel.Web;  
  2.   usingContactManager.Resources; 

  添加一个Get方法返回所有的contracts

  1.   [WebGet(UriTemplate = "")]  
  2.   publicIQueryable<Contact> Get()  
  3.   {  
  4.   var contacts = newList<Contact>()  
  5.   {  
  6.   newContact {ContactId = 1, Name = "Phil Haack"},  
  7.   newContact {ContactId = 2, Name = "HongMei Ge"},  
  8.   newContact {ContactId = 3, Name = "Glenn Block"},  
  9.   newContact {ContactId = 4, Name = "Howard Dierking"},  
  10.   newContact {ContactId = 5, Name = "Jeff Handley"},  
  11.   newContact {ContactId = 6, Name = "Yavor Georgiev"}  
  12.   };  
  13.   returncontacts.AsQueryable();  
  14.  } 

  Get方法上加了WebGet Attribute表示这是一个HTTP Get。注意这里的UriTemplate被设置为“”,默认情况下,操作的Uri是方法名Get,在这种情况下,我们是在Route中设置的Uri。

  6、通过浏览器查询Contracts.按F5运行项目,然后再浏览器地址栏中输入http://localhost:9000/api/contacts

  7、查询返回Json格式的Contracts。HTTP提供了一些“内容协商”机制 — 当有多个可得的表现形式的时候,对特定的响应选择最好的表现形式的处理过程。

  服务器驱动协商(Server-driven Negotiation)

  如果响应的最好的表现形式的选择是通过服务器上的算法来实现,那么这种方式的协商称做服务器驱动协商。选择是基于响应可得的表现形式(根据不同的维度,响应会不同;例如,语言,内容编码,等等)和请求消息里特定的头域或关于请求的其他信息(如:网络客户端的地址)。

  服务器驱动协商是有优点的,当从可行的表现形式里进行选择的算法对用户代理进行描述是比较困难的时候,或者当服务器期望发送“最好的猜测”给客户端而只通过一个响应(以避免后续请求的回路(一个请求会返回一个响应)延迟如果此“最好的猜测“对用户适合的时候)的时候。为了改善服务器的猜测,用户代理应该包含请求头域(Accept,Accept-Language,Accept-Encoding,等等),这些头域能描述它对响应的喜好。

  Web api返回的响应很容易添加一种媒体类型(media types )。

  打开Fiddler,在“Request builder”栏输入地址“http://localhost:9000/api/contacts”,然后移动到“Request Headers”在“User-Agent” 项下方添加 “Accept: application/json”

  按下 Exectue按钮,双击左边的Panel查看HTTP的response,切换到“Raw”Tab,你可以看到下面的json格式的数据:

8、启用OData 查询支持

  Web API支持OData协议,接受OData的URI格式查询,当OData 查询到达Web Api, 在返回客户端之前在服务端会进行必要的过滤和排序。查询使用IQueryable 接口,服务端并没有去查询所有的数据,发送过滤和排序到服务端。

  returncontacts.AsQueryable();

  运行程序,在浏览器里输入 http://localhost:9000/api/contacts?$Top=4&$OrderBy=Name,看到浏览器之返回了按名字排序的top 4个contract

也可以通过Fidder去查询,具体可参照第7步。

  总结

  通过这个Quick start,我们学习到了以下内容

  如何使用NuGet向项目中添加Web Api引用

  如何创建一个通过HTTP GET访问的Web Api

  如何通过ASP.NET routes宿主一个Web Api

  如何通过浏览器或者Fiddler访问Web Api

  如何在Api上启用OData uri查询

  出处:http://shanyou.cnblogs.com/

【编辑推荐】

  1. 浅析.NET中的Server push技术
  2. .NET动静结合编程 接口和委托的约束强度
  3. 使用.NET Array类的Sort方法分类数值
  4. WCF特点具体优势总结
  5. WCF事件通知具体实现方法详解

 

责任编辑:彭凡 来源: 博客园
相关推荐

2021-11-07 14:29:13

ChromeAPI 蓝牙

2012-06-20 14:34:03

jQuery

2021-11-22 09:00:00

后端开发CMS

2020-07-28 15:20:43

PythonUI代码

2019-12-23 10:00:52

PythonFlaskPython Web

2021-05-07 09:06:55

GraphQLAPI 以太坊

2020-07-07 07:00:00

Spring WebFREST APIReactive AP

2009-05-12 09:54:09

JavaRestCoC

2009-09-23 10:14:22

Hibernate

2024-01-09 09:09:45

RESTGraphQL

2021-12-07 06:02:15

Redis Docker运维

2019-12-30 09:00:00

Web 开发代码

2019-05-08 14:37:49

Web服务器HTTP

2022-03-15 12:43:44

Web APIAPI

2023-04-19 07:39:55

RustHTTP服务器

2014-02-19 15:38:42

2016-09-21 12:54:10

CAAS系统镜像

2022-10-08 00:53:12

HTTP物联网应用程序

2020-01-16 11:42:45

PyramidCornicePython Web

2022-05-31 07:40:41

ArctypeFeather.jsSQLite
点赞
收藏

51CTO技术栈公众号