ASP.NET Web API具有与ASP.NET MVC类似的编程方式，相关内容较少，如下通过一个实例讲解WebApi的集中寄宿方式。

目录
构建解决方案
定义Web API
以Web Host方式寄宿Web API
以Self Host方式寄宿Web API
利用HttpClient调用Web API
创建一个“联系人管理器”应用

一、构建解决方案

Visual Studio为我们提供了专门用于创建ASP.NET Web API应用的项目模板，借助于此项目模板提供的向导，我们可以“一键式”创建一个完整的ASP.NET Web API项目。在项目创建过程中，Visual Studio会自动为我们添加必要的程序集引用和配置，甚至会为我们自动生成相关的代码，总之一句话：这种通过向导生成的项目在被创建之后其本身就是一个可执行的应用。

对于IDE提供的这种旨在提高生产效率的自动化机制，我个人自然是推崇的，但是我更推荐读者朋友们去了解一下这些自动化机制具体为我们做了什么？做这些的目的何在？哪些是必需的，哪些又是不必要的？正是基于这样的目的，在接下来演示的实例中，我们将摒弃Visual Studio为我们提供的向导，完全在创建的空项目中编写我们的程序。这些空项目体现在如右图所示的解决方案结构中。

如右图所示，整个解决方案一共包含6个项目，上面介绍的作为“联系人管理器”的单页Web应用对应着项目WebApp，下面的列表给出了包括它在内的所有项目的类型和扮演的角色。

• ·Common：这是一个空的类库项目，仅仅定义了表示联系人的数据类型而已。之所以将数据类型定义在独立的项目中，只要是考虑到它会被多个项目（WebApi和ConsoleApp）所使用。
• WebApi：这是一个空的类库项目，表现为HttpController类型的Web API就定义在此项目中，它具有对Common的项目引用。
• WebHost：这是一个空的ASP.NET Web应用，它实现了针对ASP.NET Web API的Web Host寄宿，该项目具有针对WebApi的项目引用。
• SelfHost：这是一个空的控制台应用，旨在模拟ASP.NET Web API的Self Host寄宿模式，它同样具有针对WebApi的项目引用。
• WebApp：这是一个空的ASP.NET Web应用，代表“联系人管理器”的网页就存在于该项目之中，至于具体的联系人管理功能，自然通过以Ajax的形式调用Web API来完成。
• ConsoleApp：这是一个空的控制台应用，我们用它来模拟如何利用客户端代理来实现对Web API的远程调用，它具有针对Common的项目引用。

二、定义Web API

在正式定义Web API之前，我们需要在项目Common中定义代表联系人的数据类型Contact。简单起见，我们仅仅为Contact定义了如下几个简单的属性，它们分别代表联系人的ID、姓名、联系电话、电子邮箱和联系地址。

   1: public class Contact

   2: {

   3:     string Id { get; set; }

   4:     string Name { get; set; }

   5:     string PhoneNo { get; set; }

   6:     string EmailAddress { get; set; }

   7:     string Address { get; set; }

   8: }

表现为HttpController的Web API定义在WebApi项目之中，我们一般将ApiController作为继承的基类。ApiController定义在“System.Web.Http.dll”程序集中，我们可以在目录“%ProgramFiles%Microsoft ASP.NETASP.NET Web Stack 5Packages”中找到这个程序集。具体来说，该程序集存在于子目录“Microsoft.AspNet.WebApi.Core.5.0.0libnet45”中。

Web API体现在如下所示的ContactsController类型中。在该类型中，我们定义了Get、Post、Put和Delete这4个Action方法，它们分别实现了针对联系人的查询、添加、修改和删除操作。Action方法Get具有一个表示联系人ID的可缺省参数，如果该参数存在则返回对应的联系人，否则返回整个联系人列表。由于ASP.NET Web API默认实现了Action方法与HTTP方法的映射，所以方法名也体现了它们各自所能处理请求必须采用的HTTP方法。

static List<Contact> contacts;

   4: static int counter = 2;

   5: 

static ContactsController()

   7:     {

   8:         contacts = new List<Contact>();

   9:         contacts.Add(new Contact { Id = "001",Name = "张三",

  10:             PhoneNo = "0512-12345678",EmailAddress = "zhangsan@gmail.com",monospace!important">  11:             Address = "江苏省苏州市星湖街328号" });

  12:         contacts.Add("002",128)">"李四",monospace!important">  13:             PhoneNo = "0512-23456789",128)">"lisi@gmail.com",monospace!important">  14:             Address = "江苏省苏州市金鸡湖大道328号" });

  15: }

  16: 

  17:     public IEnumerable<Contact> Get(string id = null)

  18:     {

  19:         return from contact in contacts

  20:             where contact.Id == id || string.IsNullOrEmpty(id)

  21:             select contact;

  22: }

  23: 

  24:     void Post(Contact contact)

  25:     {

  26:         Interlocked.Increment(ref counter);

  27:         contact.Id = counter.ToString("D3");

  28:         contacts.Add(contact);

  29:     }

  30: 

  31:     void Put(Contact contact)

  32:     {

  33:         contacts.Remove(contacts.First(c => c.Id == contact.Id));

  34:         contacts.Add(contact);

  35:     }

  36: 

  37:     void Delete(string id)

  38:     {

  39:         contacts.Remove(contacts.First(c => c.Id == id));        

  40:     }

  41: }

简单起见，我们利用一个静态字段（contacts）表示存储的联系人列表。当ContactsController类型被加载的时候，我们添加了两个ID分别为“001”和“002”的联系人记录。至于实现联系人CRUD操作的Action方法，我们也省略了必要的验证，对于本书后续的演示的实例，我们基本上也会采用这种“简写”的风格。

三、以Web Host方式寄宿Web API

我们在上面已经提到过了，虽然被命名为ASP.NET Web API，但是其核心的消息处理管道却是独立于ASP.NET平台的，所以我们可以对相同的Web API实施不同的寄宿方式。寄宿的本质就是利用一个具体的应用程序为Web API提供一个运行的环境，并最终解决“请求的接收和响应的回复”问题。作为寄宿的一种主要形式，Web Host就是创建一个ASP.NET Web应用作为Web API的宿主。

采用Web Host方式寄宿Web API的宿主程序WebHost是一个空的ASP.NET应用。除了让它引用定义ContactsController的WebApi项目之外，我们还需要为其添加如下这些必需的程序集引用。除了程序集“System.Net.Http.dll”（它属于.NET Framework 原生的程序集）之外，其余3个均可以在目录“%ProgramFiles%Microsoft ASP.NETASP.NET Web Stack 5Packages”中找到。

• System.Web.Http.dll（ Microsoft.AspNet.WebApi.Core.5.0.0libnet45）
• System.Net.Formatting.Http.dll（Microsoft.AspNet.WebApi.Client.5.0.0libnet45）
• System.Web.Http.WebHost.dll（Microsoft.AspNet.WebApi.WebHost.5.0.0libnet45）
• System.Net.Http.dll

与ASP.NET MVC一样，如果采用Web Host的方式来寄宿Web API，ASP.NET自身的路由系统会成为接收请求的第一道屏障。在将请求递交给ASP.NET Web API自己的消息处理管道之前，路由系统会解析出当前请求访问的目标HttpController和Action的名称。我们需要做的就是根据需求注册相应的路由，这也是采用Web Host寄宿方式所需的唯一操作。

我们在WebHost项目中添加一个Global.asax文件，并按照如下的形式在其Application_Start方法中注册了一个模板为“api/{controller}/{id}”的路由。此模板由3部分组成，静态文本“api”表示其前缀，后面是两个路由参数。前者（{controller}）表示目标HttpController的名称，后者（{id}）可以映射为目标Action方法的同名参数（比如ContractsController的Get方法的参数id），这是一个可以缺省的路由参数（RouteParameter.Optional）。

protected void Application_Start(object sender,EventArgs e)

   4:     {

   5:         GlobalConfiguration.Configuration.Routes.MapHttpRoute(

   6:             Name            : "DefaultApi",96)">   7:             routeTemplate   : "api/{controller}/{id}",96)">   8:             defaults        : new { id = RouteParameter.Optional });

   9:     }

  10: }

如上面的代码片断所示，路由注册是通过调用代表全局路由表的HttpRouteCollection对象的扩展方法MapHttpRoute来完成的。GlobalConfiguration的静态属性Configuration返回一个代表当前配置的HttpConfiguration对象，全局路由表就注册在它的Routes属性上。

如果你了解ASP.NET MVC的路由注册，可能觉得奇怪：注册路由的模板中并没有表示目标Action的路由参数，ASP .NET Web API如何根据请求确定哪个Action方法应该被调用呢？答案其实很简单：它能根据请求采用HTTP方法来确定目标Action方法。当然，在注册路由模板中提供代表Action名称的路由参数（{action}）也是支持的。

在默认情况下，通过Visual Studio（VS 2012或者VS 2013，本书采用的是后者）创建的Web应用总是使用IIS Express作为服务器，它会自动为我们指定一个可用的端口号。为了更好地模拟真实发布环境，同时避免“跨域资源共享”带来的困扰，我们采用本地IIS作为服务器。如下图所示，WebHost项目在IIS中映射的Web应用采用的URL为“http://localhost/webhost”。

   2: Host: localhost

   3: Connection: keep-alive

   4: Cache-Control: max-age=0

   5: Accept: text/html,application/xhtml+xml,application/xml ;q=0.9,image/webp,*/*;q=0.8

   6: User-Agent: Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/31.0.1650.63 Safari/537.36

   7: Accept-Encoding: gzip,deflate,sdch

   8: Accept-Language: en-US,en;q=0.8,zh-CN;q=0.6,zh-TW;q=0.4

   2:   ...

   3:   system.webServermodules runAllManagedModulesForAllRequests="true"   5:       remove name="WebDAVModule" />

</modules   7:      8: >

void Main(string[] args)

   5:         Assembly.Load("WebApi,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null");

   6:             

   7:         HttpSelfHostConfiguration configuration = new HttpSelfHostConfiguration("http://localhost/selfhost");

   8:         using (HttpSelfHostServer httpServer = new HttpSelfHostServer(configuration))

   9:         {

  10:             httpServer.Configuration.Routes.MapHttpRoute(

  11:                 name            :   12:                 routeTemplate   :   13:                 defaults        :   14: 

  15:             httpServer.OpenAsync();

  16:             Console.Read();

  17:         }

  18:     }

  19: }

ASP.NET Web API的Self Host寄宿方式通过HttpSelfHostServer来完成。如上面的代码片断所示，在手工加载了定义ContactsController类型的程序集“WebApi.dll”之后，我们根据指定的基地址（“http://localhost/selfhost”)，注册路由的URL模板将是以此作为基地址的相对地址）创建了一个HttpSelfHostConfiguration对象，HttpSelfHostServer由该对象创建。接下来，我们利用创建的HttpSelfHostConfiguration对象（对应着HttpSelfHostServer的Configuration属性）的Routes得到全局路由表，并调用扩展方法MapHttpRoute注册了与Web Host寄宿方式一样的路由。当我们调用OpenAsync方法成功开启HttpSelfHostServer之后，服务器开始监听来自网络的调用请求。

如果读者朋友们对WCF比较熟悉的话，应该清楚在进行WCF服务寄宿的时候我们必须指定寄宿服务的类型，但是对于ASP.NET Web API的寄宿来说，不论是Web Host还是Self Host，我们都无需指定HttpController的类型。换句话说，WCF服务寄宿是针对具体某个服务类型的，而ASP.NET Web API的寄宿则是批量进行的。

ASP.NET Web API的批量寄宿源自它对HttpController类型的智能解析，它会从“提供的”的程序集列表中解析出所有HttpController类型（所有实现了IHttpController接口的类型）。对于Web Host来说，它会利用BuildManager获得当前项目直接或者间接引用的程序集，但是对于Self Host来说，HttpController类型的解析在默认情况下只会针对加载到当前应用程序域中的程序集列表，这也是我们为何需要手工加载定义了ContactsController类型的程序集的原因所在。

如果现在运行这个作为宿主的控制台程序，我们依然可以对寄宿其中的Web API发起调用。同样采用浏览器作为测试工具，在分别访问目标地址“http://localhost/selfhost/api/contacts”和“http://localhost/selfhost/api/contacts/001”后，我们依然会得到上面的结果。

参考：http://www.cnblogs.com/artech/p/web-api-sample.html

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!