您的位置: 首页  >  IT文章  >  ASP.NET Web API自身对CORS的支持：从实例开始

ASP.NET Web API自身对CORS的支持：从实例开始

分类: IT文章 • 2022-05-08 19:02:17

在《通过扩展让ASP.NET Web API支持W3C的CORS规范》中我们通过自定义的HttpMessageHandler为ASP.NET Web API赋予了跨域资源共享的能力，具体来讲，这个自定义的CorsMessageHandler的自由主要体现在如下两个方面：其一，为简单跨域请求的响应和继预检请求后的真实跨域资源请求的响应添加CORS报头；其二，对从浏览器发送的预检请求予以响应。实际上ASP.NET Web API本身就提供了针对CORS的支持，就其实现原理来看，与我们的实现没有本质的区别。接下来我们通过实例演示如何利用ASP.NET Web API自身的支持来实现“跨域资源共享”。

class WebApiApplication : System.Web.HttpApplication 
   2: {
void Application_Start()
   4:     {
   5:         GlobalConfiguration.Configuration.EnableCors();
//其他操作
   7:     }
   8: }

和在《通过扩展让ASP.NET Web API支持W3C的CORS规范》实现CORS的实例一样，ASP.NET Web API自身也是借助于应用在HttpController类型或者定义其中的Action方法的特性来定义CORS授权策略的，这个特性类型为System.Web.Http.Cors.EnableCorsAttribute，它定义在程序集System.Web.Http.Cors.dll中。我们只需要按照如下的方式将EnableCorsAttribute特性应用到定义在ContactsController中的Action方法GetAllContacts上即可。

)]
class ContactsController : ApiController
   3: {
public IHttpActionResult GetAllContacts()
   5:     {
new Contact[]
   7:         {
},
},
},
  11:         };
return Json<IEnumerable<Contact>>(contacts);
  13:     }
  14: }
  15:  
class Contact
  17: {
string Name { get; set; }
string PhoneNo { get; set; }
string EmailAddress { get; set; }
  21: }

如上面的代码片断所示，我们为应用的EnableCorsAttribute特性指定了三个参数。根据参数名称和上面我们针对W3C的CORS规范的介绍，我们应该可以猜得到它们分别代表：授权的源站点，和请求所允许的自定义包头和HTTP方法。我们将客户端ASP.NET MVC应用所在的站点“http://localhost:9527”设置为授权的源站点，后两者则直接设置为“*”表示对此不作任何限制。

接下来们在MvcApp应用中定义如下一个HomeController，默认的Action方法Index会将对应的View呈现出来。

class HomeController : Controller
   2: {
public ActionResult Index()
   4:     {
return View();
   6:     }
   7: }

如下所示的是Action方法Index对应View的定义。我们的目的在于：当页面成功加载之后以Ajax请求的形式调用上面定义的Web API获取联系人列表，并将自呈现在页面上。如下面的代码片断所示，Ajax调用和返回数据的呈现是通过调用jQuery的getJSON方法完成的。

>
>
>
>
   1:  
   2: </head>
   3: <body>
></ul>
>
function ()
   7:         {
;
function (contacts) {
function (index, contact)
  11:                 {
;
;
;
;
;
).append($(html));
  18:                 });
  19:             });
  20:         });
  21:     
          </script>
>
>

现在运行我们的ASP.NET MVC程序，依然可以得到如右图所示的输出结果。从编程的角度来讲，ASP.NET Web API针对CORS的实现仅仅涉及到两个方面：

  • 其一，HttpConfiguration的扩展方法EnableCors，它用于开启ASP.NET Web API针对CORS的支持；
  • 其二，EnableCorsAttribute特性，它为目标HttpController或者Action方法定义CORS授权策略。

但是整个CORS体系不限于此，在它们背后隐藏着一系列的类型，我们将会利用后续的文章对此作全面讲述。

CORS系列文章
[1] 同源策略与JSONP
[2] 利用扩展让ASP.NET Web API支持JSONP
[3] W3C的CORS规范
[4] 利用扩展让ASP.NET Web API支持CORS
[5] ASP.NET Web API自身对CORS的支持: 从实例开始
[6] ASP.NET Web API自身对CORS的支持: CORS授权策略的定义和提供
[7] ASP.NET Web API自身对CORS的支持: CORS授权检验的实施
[8] ASP.NET Web API自身对CORS的支持: CorsMessageHandler

相关推荐