Web API 跨域请求

分布式技术在项目中会频繁用到，以前接触过WebService（可跨平台）、WCF（功能强大，配置繁琐）, 最近由于上层业务调整，将原来的MVC项目一分为三，将数据层提取出来，用API去访问。然后新建一类库项目，集成大量的辅助类来帮助MVC web端去访问Web API。

VS2013上新建WebAPI的时候会多一个区域Areas的文件夹，这个区域可以看成是一个mini的MVC项目，我向来本着技术不够，篇幅来凑的原则，来初步记录下API的基础学习，API和MVC还是有区别的，对于新手，比如我，狭隘的自认MVC主用户请求返回视图界面，API主用户请求返回数据。访问API一般分为 Jquery中的Ajax 访问、HttpClient访问，今天在这里，先写一写Ajax与Web API的那些事。

一、建Web API 项目

1、建立Web API项目之后，在Model文件夹下建立实体数据模型

2、新建一控制器StudentController，写个根据学生ID返回学生对象的方法

    public class StudentController : ApiController
    {
        IBCCEntities db = new IBCCEntities();
        //返回学生信息集合
        public IEnumerable<Student> AllStu() 
        {
            return db.Student;
        }
        
        //根据学生ID查询学生信息
        //根据路由规则 调用： api/Student/id
        public Student GetStuById(int id) 
        {
            Student student = db.Student.FirstOrDefault(m => m.StudentID == id);
            return student;
        }

    }

3. 在该项目上新建一视图，用来请求后台API数据（同项目协议、端口、域名都相同，不存在跨域问题）

 <script type="text/javascript">
        $(document).ready(function () {
            $("#btnID").click(function () {
                var id = $("#txtID").val();
                $.getJSON("/api/Student/" + id, function (data) {
                    var html = "<ul>";
                    $(data).each(function (i, data) {
                        html += "学号:" + data.StudentID + "<br/>"+"姓名:" + data.StudentName + "<br/>"+
                              "班级:"+ data.StudentClass +"<br/>"+"成绩:"+data.grade+"<br/>"+"入学时间："+data.updatetime+"<br/";
                    });
                    $("#contactID").html(html);
                });
            });

        });
    </script>

只是一个最简单的Ajax调用后台，因为前台需要接收数据，所以后台Student控制器返回的学生数据对象，而不是视图

二、客户端异步调用Web API

当客户端不在服务器上，客户端调用API是存在跨域问题的，异步调用的跨域（协议、端口号、域名）问题该怎么处理，上文演示的前台发起请求，后台API返回数据，下面来模拟客户端来调用API，另新建一MVC项目作为客户端，起始和上面前台界面相同，为了作比较，写一个ajax的底层用法

<script type="text/ecmascript">
    $(function () {
        $("#btnID").click(function () {
            var id = $("#txtID").val();
            $.ajax({
                type: "GET",
                dataType: "json",
                url: "http://localhost:11308/api/Product/"+id,
                success: function (data) {
                    var html = "<ul>";
                        $(data).each(function (i, item) {
                            html += "学号:" + data.StudentID + "<br/>" + "姓名:" + data.StudentName + "<br/>" +
                        "班级:" + data.StudentClass + "<br/>" + "成绩:" + data.grade + "<br/>" + "入学时间：" + data.updatetime + "<br/";
                        });
                        html += "</ul>";
                        $("#contbyId").html(html);
                },
                error: function () {
                    alert("發送失敗");
                }
            });
        })
    });
</script>

而此时进行请求，发现浏览器会提示加载失败，请求不被允许。

由于启动每个项目时，配置的端口号不同，所以调用API项目时，就产生的跨域，不是任何客户端都能得到服务端回执数据的，如果不在后台给客户端MVC项目的访问权限，客户端是接收不到服务端返回的数据，

处理方法：

1.在客户端添加一个类文件，用作过滤器，将客户端的URL地址写进去

    public class ProductFilter:System.Web.Http.Filters.ActionFilterAttribute
    {
        private const string Origin = "Origin";
        private const string AccessControlAllowOrigin = "Access-Control-Allow-Origin";
        private const string originHeaderdefault = "http://localhost:20630";
        public override void OnActionExecuted( HttpActionExecutedContext actionExecutedContext)
        {
          actionExecutedContext.Response.Headers.Add(AccessControlAllowOrigin, originHeaderdefault);
        }
    }

2.添加特性，把这种行为标注到一个过多个控制器或动作方法上。如：把该类文件名放置StudentController方法上

        //根据学生ID查询学生信息
        //根据路由规则 调用： api/Student/id
        [StudentFiltet]
        public Student GetStuById(int id) 
        {
            Student student = db.Student.FirstOrDefault(m => m.StudentID == id);
            return student;
        }

目前这样虽然能达到效果，如果有多个客户端来调用此服务端的API，那岂不是需要把所有客户端的URL加到服务端，如果用一个“泛称” 添加服务端的过滤器中，这样就类似于公开接口，

如下：

        private const string Origin = "Origin";
        private const string AccessControlAllowOrigin = "Access-Control-Allow-Origin";
        //private const string originHeaderdefault = "http://localhost:20630";
        public override void OnActionExecuted(HttpActionExecutedContext actionExecutedContext)
        {
            actionExecutedContext.Response.Headers.Add(AccessControlAllowOrigin, "*");
        }

用了泛称 * 代替具体的客户端好值之后，该API的接口便等于公开接口，写的这里前台Ajax 调用API 基本如此，后面会介绍HttpClient调用API。

世人皆大笑，举手揶揄之