Web API Get Started First

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

注：此博客是自官网修剪而来，博主IT新手

一、web api与web service的不同：

web api是基于Http协议，而web service是基于soap协议。两协议的区别小子看了很多，但是理解不了解释不清晰就不赘述，请各位读者自行找其他大神。

Http除了提供网页，还是一个用于创建API提供服务和数据的强大平台，Http是简单、灵活、适用性极强的。几乎所有的平台都有提供Http的服务包，因此http协议在客户端、浏览器端、移动端以及传统的桌面端都具有广泛的应用。

二、创建第一个web api应用程序：

1、创建一个MVC，选择web api类型：

2、创建一个Model类，名称为Product:

namespace WebAPI2.Models
{
public class Product
{
public int Id { get; set; } public string Name { get; set; } public int Price { get; set; } public string Style { get; set; }
}
}

3、创建一个控制器，名称是ProductController，在这个控制器的当中我们对Product进行初始化，在正规的程序当中我们是不这么做的，我们需要在建立数据库，使用EF或者是Ado.Net来访问数据，但是在这里为了方便我们只在控制器当中进行了初始化（创建一个数组，类型是Product）：

public Product[] products = {
new Product() {Id=,Name="SuJinBiao",Price=,Style="A" },
new Product() {Id=,Name="HouWeiXin",Price=,Style="B" },
new Product() {Id=,Name="HuangYuanPei",Price=,Style="C" },
new Product() {Id=,Name="ZhangJinKun",Price=,Style="D" },
new Product() {Id=,Name="ChenZeYu",Price=,Style="E" },
};

4、创建两个action，分别是获取全部Product以及按照Id进行查询：

public IEnumerable<Product> GetAllProducts() {
return products;
} public IEnumerable<Product> GetProductById(int id) {
var product = products.Where(o => o.Id == id).FirstOrDefault();
if (product==null) {
//return NotFound();
}
return (IEnumerable<Product>)product;
}

5、接下来我们需要访问数据，使数据显示出来，在View文件夹下的Home中，我们把index进行修改，删掉所有内容，然后添加Html代码如下：

<h1>ALL Products</h1>
<ul id="products"></ul>
<br />
<h3>Search Results</h3>
ID:<input type="text" id="searchBy" /><input type="button" id="search" value="Search"/>
<label id="result"></label>

6、接下来使用ajax访问数据，为了方便我们使用的是jQuery已经封装好的ajax：

7、运行程序我们会发现数据被显示出来了：

如图，在搜索框中按照Id我们可以进行搜索，搜索的结果显示在按钮的后面。

8、按照习惯插入一张导图：

9、发散：

（1）、路由是怎样的呢？

web api的路由的设置和mvc的路由设置是类似的，位置就在App _Start文件夹下面的webconfig文件当中，可以如MVC的路由一般修改规则：

在web api的路由当中，我们来看看默认的路由：“api/{controller}/{id}”；这其中，api是文字标识路径，与MVC的路由进行区分，而{controller}和{Id}则是占位符变量。

当应用程序根据请求查找到匹配的路由之后，就开始进行控制器的匹配和action的对应，这又是一个很有意思的事情。

按照官网的说法，当要进行action的匹配的时候，需要它首先找的是action的方法开头，如果客户端返回的是一个get请求，那么就找控制器当中的get请求方法，然后再进行匹配参数是否一致。如果在控制器的get方法当中没有找到（比如说我们狡猾的把开头给改成了post，而方法体是没有改变的），那么该程序就会觉得没有相应的action，所以为了给我们好体验返回GetAll（）方法的结果。这就要求我们在定义的时候不仅仅是参数要进行匹配，对于action的方法名称也要进行匹配限制。

以下是我把action的get改成了post的结果：