微软的web api是在vs2012上的mvc4项目绑定发行的，它提出的web api是完全基于RESTful标准的，完全不同于之前的（同是SOAP协议的）wcf和webService。它是简单，代码可读性强的，上手快的，如果要拿它和web服务相比，我会说，它的接口更标准，更清晰，没有混乱的方法名称，有的只有几种标准的请求，如get,post,put,delete等，它们分别对应的几个操作，下面讲一下：
GET：生到数据列表（默认），或者得到一条实体数据
POST：添加服务端添加一条记录，记录实体为Form对象
PUT：添加或修改服务端的一条记录，记录实体的Form对象，记录主键以GET方式进行传输
DELETE：删除 服务端的一条记录
注意上面公开的API接口都是在XMLHttpRequest情况下调用的，当然你可以使用jquery的ajax组件来完成这个请求调用，它的代码更加面向对象，下面举例说明一下
这是页面的HTML代码部分，实现最基本的CRUD操作
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
<script src="~/Scripts/jquery-1.8.2.min.js"></script>
</head>
<body>
<fieldset>
<a href="javascript:add()">添加(Add)</a>
<a href="javascript:Put(4)">更新(Put)</a>
<a href="javascript:Delete()">删除(Delete)</a>
<a href="javascript:getAll()">获取所有</a>
</fieldset>
<script type="text/javascript">
function getAll() {
$.ajax({
url: "/api/Values",
type: "Get",
success: function (data) {
alert(JSON.stringify(data));
}
});
}
function add() {
$.ajax({
url: "/api/Values",
type: "Post",
data: {"UserId":4,UserName:"壮老大",Age:99,Emali:"zhuanglaoda@qq.com"},
success:function(data) {
alert(JSON.stringify(data));
}
});
}
function Put(id) {
$.ajax({
url: "/api/Values?id="+id,
type: "put",
data: { "UserId": 4, UserName: "壮老大(Update)", Age: 99, Emali: "zhuanglaoda@qq.com" },
});
}
function Delete() {
$.ajax({
url: "/api/Values",
type: "Delete",
data: { "id": 4 },
});
}
</script>
</body>
</html>
后台代码
using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
namespace WebApiDemo.Controllers
{
public class ValuesController : ApiController
{
public static List<User> UserList = new List<User>
{
new User{ UserId=1,UserName="大壮", Age=1, Emali="dazhuang@qq.com"},
new User{ UserId=2,UserName="小壮", Age=10, Emali="xiaozhuang@qq.com"},
new User{ UserId=3,UserName="壮壮", Age=20, Emali="zhuangzhuang@qq.com"}
};
// GET api/values
public IEnumerable<User> Get()
{
return UserList;
}
// GET api/values/5
public User Get(int id)
{
return UserList.FirstOrDefault(c=>c.UserId==id);
}
// POST api/values
public bool Post([FromBody]User user)
{
UserList.Add(user);
return true;
}
// PUT api/values/5
public bool Put(int id, [FromBody]User user)
{
var temp_user = UserList.FirstOrDefault(c => c.UserId == id);
if (temp_user != null)
{
temp_user.UserName = user.UserName;
temp_user.Age = user.Age;
temp_user.Emali = user.Emali;
}
return true;
}
// DELETE api/values/5
public bool Delete(int id)
{
UserList.Remove(UserList.FirstOrDefault(c=>c.UserId==id));
return true;
}
public class User
{
public int UserId { get; set; }
public string UserName { get; set; }
public int Age { get; set; }
public string Emali { get; set; }
}
}
}
值得注意的一点，如果网站地址是:127.0.0.1/ 如果API接口的控制器是values 默认路由规则的话127.0.0.1/values是可以访问的,但是要注意,由于所有的API控制器是集成了ApiController,所以默认的路由规则是不起作用的。
笔者也被坑了一会，后来看App_Start在WebApiConfig中看到注册了一个这样的方法
public static void Register(HttpConfiguration config) { config.Routes.MapHttpRoute( name: "DefaultApi", routeTemplate: "api/{controller}/{id}", defaults: new { id = RouteParameter.Optional } ); // 取消注释下面的代码行可对具有 IQueryable 或 IQueryable<T> 返回类型的操作启用查询支持。 // 若要避免处理意外查询或恶意查询，请使用 QueryableAttribute 上的验证设置来验证传入查询。 // 有关详细信息，请访问 http://go.microsoft.com/fwlink/?LinkId=279712。 //config.EnableQuerySupport(); // 若要在应用程序中禁用跟踪，请注释掉或删除以下代码行 // 有关详细信息，请参阅: http://www.asp.net/web-api config.EnableSystemDiagnosticsTracing(); }
大家懂了吧, 在API接口前面加api就可以访问了,或者像MVC路由那样在注册几个路由也是可以的。
对于WebApiConfig的具体实现,目前我也是刚接触,我们后面讨论,