【ASP.NET Web API2】初识Web API

 

Web Api 是什么？

MSDN：ASP.NET Web API 是一种框架，用于轻松构建可以访问多种客户端（包括浏览器和移动设备）的 HTTP 服务

百度百科：Web API是网络应用程序接口。

个人理解：Web API 是提供给多种客户端对data做CRUD(增删查改)操作的统一接口

-------------------------------------------

Asp.net Web API 支持多种寄宿方式

1，IIS作为宿主（创建一个Asp.net web应用程序作为Web API 的宿主）

2，自宿主（不需要IIS支持，使用任意的应用程序作为宿主【控制台、Windows Forms、WPF甚至Windows Service】）

看了Artech大神的一小节Web API，记录一下学到的东西 

[构建简单的Web API]

1,以Web Host方式寄宿Web API

     Visual Studio 为我们提供了专门用于创建ASP.NET Web API应用的项目模板，我们可以一键式创建一个完整的APS.NET Web API项目。

这里先不使用Visual Studio自动创建的。我们完全在创建的空项目中编写我们的程序。

1.1  构建解决方案

•  API: 一个空的类库项目，表现为HttpController类型的Web API就定义在此项目中
• Model：一个空的类库项目，实体类定义在这里
• WebHost：一个空的ASP.NET Web应用程序

1.2 定义Web API

       在正式定义Web API 之前，我们需要在项目Model中定义一个代表联系人的实体类Contact,这里做简单的定义

    public class Contact
    {
        public string ID { get; set; }

        public string Name { get; set; }

        public string PhoneNum { get;set; }
       
    }

        Web API定义在API项目中，需要继承ApiController,ApiController定义在程序集“System.Web.Http.dll”, 程序集在“C:Program Files (x86)Microsoft ASP.NETASP.NET Web Stack 5PackagesMicrosoft.AspNet.WebApi.Core.5.0.0lib et45”可以找到

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

 public class ContactsController : ApiController
    {
        List<Contact> contacts;
        public ContactsController()
        {
            contacts = new List<Contact>();
            contacts.Add(new Contact() { ID = "001", Name = "小白", PhoneNum = "13529093839" });
            contacts.Add(new Contact() { ID = "002", Name = "大白", PhoneNum = "13529093838" });
            contacts.Add(new Contact() { ID = "003", Name = "小黑", PhoneNum = "13529088838" });
        }

        public IEnumerable<Contact> Get(string id=null) {
            return from c in contacts 
                   where c.ID==id||string.IsNullOrEmpty(id) 
                   select c;        
        }

        public void Post(Contact item) {
            contacts.Add(item);
        }

        public void Put(Contact item) {
            contacts.Remove(contacts.First(c => c.ID == item.ID));
            contacts.Add(item);
        }

        public void Delete(string id) {
            contacts.Remove(contacts.First(c => c.ID == id));
        }
    }

1.3 将WebHost作为Web API的宿主

    WebHost在解决方案中是一个空的ASP.NET Web应用程序，我们还需要为其添加一些必需的程序集引用。

•     System.Web.Http;(Microsoft.AspNet.WebApi.Core.5.0.0lib et45)
•     System.Web.Http.WebHost;(Microsoft.AspNet.WebApi.WebHost.5.0.0lib et45)
•     System.Net.Http;
•     System.Net.Http.Formatting;(Microsoft.AspNet.WebApi.Client.5.0.0lib et45)

  我们需要在WebHost项目中添加一个Global.asax全局配置文件，注册一个默认路由，路由系统会解析当前请求访问的目标HttpController和Action的名称

        protected void Application_Start(object sender, EventArgs e)
        {
            GlobalConfiguration.Configuration.Routes.MapHttpRoute(
                name: "Default",
                routeTemplate: "api/{controller}/{id}",
                defaults: new { id = RouteParameter.Optional }
                );
        }

　　路由规则中没有表示目标Action的路由参数，ASP.NET Web API如何根据请求确定哪个Action方法应该被调用呢？其实它能根据请求采用HTTP方法来确定目标Action方法。当然在注册路由模板中提供代表Action名称的路由参数({action})也是支持的。

     现在Web API的以WebHost为宿主的工作就完成了，我们可以利用浏览器来调用寄宿的Web API来判断寄宿工作是否成功。由于浏览器在默认情况下访问我们在地址栏中输入的地址总是采用HTTP-GET请求，所以我们只能利用它来调用支持HTTP-GET的Action方法，即定义在ContactsController中的Get方法。

 采用Chrome浏览器可以看到我们获取的联系人列表是XML格式的数据表示，对于ASP.NET Web API 来说，它会优先利用请求报头"Accept"携带的媒体类型来确定相应内容应用的表现形式。

如下所示是Chrome访问“http://localhost:3697/api/contacts/001”发送请求的内容，它之所以会得到以XML表示的响应是因为“Accept”报头指定的媒体类型列表中只有“application/xml”被ASP.NET Web API支持。如果我们使用IE，请求的“Accept”报头将携带不同的媒体类型列表，我们实际上会得到以JSON格式表示的响应结果

Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Encoding:gzip, deflate, sdch
Accept-Language:zh-CN,zh;q=0.8
Cache-Control:max-age=0
Host:localhost:3697
Proxy-Connection:keep-alive
User-Agent:Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36

我们利用Fiddler来发送调用Web API的HTTP请求，获取以JSON格式表示的响应结果。

如图，利用Fiddler发送了一个针对目标地址"http://localhost:3697/api/contacts/001"的Http-GET请求，并添加了一个值为"application/json"的“Accept”报头，Execute发送请求之后确实得到了Json格式表示的联系人列表

使IIS支持Put和Delete请求

       在定义ContactsController的时候，我们分别采用Get、Post、Put、Delete作为获取、创建、修改和删除联系人的操作所支持的HTTP方法。但是IIS默认是不支持Put和Delete请求的

      IIS拒绝PUT和DELETE请求是由默认注册的一个名为"WebDAVModule"的自定义HttpModule导致的。解决这个问题最为直接的方式就是将注册的HttpModule移除

<system.webServer>
    <modules runAllManagedModulesForAllRequests="true">
      <remove name="WebDAVModule"/>
    </modules>
</system.webServer>

2,自宿主的方式寄宿Web API

   我们在原来的解决方案中添加一个空的控制台应用程序SelfHost作为宿主

跟WebHost一样，引用解决方案中的API.dll,同样需要应用一些必需的程序集(红色为与WebHost不同的)

•     System.Web.Http;(Microsoft.AspNet.WebApi.Core.5.0.0lib et45)
•     System.Web.Http.SelfHost;(Microsoft.AspNet.WebApi.SelfHost.5.0.0lib et45)
•     System.Net.Http;
•     System.Net.Http.Formatting;(Microsoft.AspNet.WebApi.Client.5.0.0lib et45)

通过前面的WebHost,我们知道接下来需要做的是注册路由了。在此之前我们还需要动态加载解决方案中的程序集API.dll，

下面是Artech大神在 【在一个空ASP.NET Web项目上创建一个ASP.NET Web API 2.0应用 】中写的， 有个错误的地方httpServer.OpenAsync()后没有执行Wait()方法，导致计算机并未分配一个端口给程序，这让我折腾了好久，不过也学到了其他知识，比如：[如何查看计算机某个端口被谁占用] 

        static void Main(string[] args)
        {           
            Assembly.Load("API,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null");
            HttpSelfHostConfiguration configuration = new HttpSelfHostConfiguration("http://127.0.0.1:7304");
            using (HttpSelfHostServer httpServer = new HttpSelfHostServer(configuration))
            {
                httpServer.Configuration.Routes.MapHttpRoute(
                    name: "DefaultApi",
                    routeTemplate: "api/{controller}/{id}",
                    defaults: new { id = RouteParameter.Optional });
                httpServer.OpenAsync();//纠正：httpServer.OpenAsync().Wait();
                Console.Read();
            }
        }

当我们没有执行Wait()方法时，查看一下计算机是否有分配端口

1，首先调出命令窗口：开始---->运行---->cmd，或者是window+R组合键

2，输入命令：netstat -ano，可以看到所有端口的情况。发现找了几百遍也是找不到7304端口的

如果你加了Wait(),运行后出现

“HTTP 无法注册 URL http://+:****/。进程不具有此命名空间的访问权限(有关详细信息，请参见 http://go.microsoft.com/fwlink/?LinkId=70353)”

你只要以管理员的身份打开Visual Studio就可以了