1. Web API简单说明

近来很多大型的平台都公开了Web API。比如百度地图 Web API，做过地图相关的人都熟悉。公开服务这种方式可以使它易于与各种各样的设备和客户端平台集成功能，以及通过在浏览器中使用 JavaScript来创建更丰富的HTML体验。所以我相信Web API会越来越有它的用武之地。

说道Web API很多人都会想到Web服务，但是他们仍然有一定的区别：Web API服务是通过一般的 HTTP公开了，而不是通过更正式的服务合同 （如SOAP）

2. ASP.NET Web API简介

ASP. NET Web API支持让你能够轻松地创建功能强大的 Web API，可以从范围广泛的客户端 （包括使用 JavaScript从浏览器中，到任何移动/客户端平台上的本机应用程序）访问。它提供以下支持：

(1)现代 HTTP 的编程模型：在你的 Web 应用程序中直接访问和处理 HTTP 请求并响应，使用清洁、 强类型的 HTTP 对象模型。除了在服务器上支持这个 HTTP 的编程模型之外，通过使用新的 HttpClient API来从任何.NET 应用程序中调用 Web ApI，我们也支持客户端中相同的编程模型。

(2)内容协商： Web API 有对内容协商的内置支持 — — 这使客户端和服务器一起工作以决定从一个 API 返回的正确的数据格式。我们为JSON、 XML 和Form URL 编码的格式提供默认支持，并可以通过添加你自己的格式化程序来扩展这种支持，或者甚至用你自己的来替换默认的内容协商策略。

(3)查询组成： Web API 通过 OData URL 公约使你能够轻松地支持查询。当你从你的 Web API 返回一种类型的 IQueryable <T> 时，框架将自动为它提供 OData 查询支持—— 使其易于分页和排序。

(4)模型绑定和验证：模型绑定器提供了一种简单的方法来从HTTP 请求中的不同部分提取数据，并将这些信息部分转换为Web API行为可使用的.NET对象。Web API 支持相同的模型绑定和ASP. NET MVC 现今支持的验证基础结构。

(5)路由： Web ApI 支持完整的路由功能集。现今ASP. NET MVC 和 ASP.NET也支持这一点，包括路线参数和约束。默认情况下，Web API 还提供了智能公约，使你能够轻松地创建实现 Web ApI的类，而无需不得不将属性应用到你的类或方法中。Web API 的配置纯粹是通过代码来实现的 — — 保持你的配置文件干净。

(6)筛选器： Web ApI 使你能够轻松地使用和创建筛选器 （例如： [授权]），那样你能够封装和应用交叉行为。

(7)改进的可测试性： 与其在静态文本对象中设置 HTTP 的详细信息，不如将 Web API 行为与 HttpRequestMessage 和 HttpResponseMessage 一起使用— — 两个新 的HTTP对象 （在其他内） 使测试更容易。例如，你可以单元测试你的 Web ApI，而无需不得不使用 Mocking 框架。

(8)IoC支持： Web API 支持由 ASP. NET MVC 实现的服务定位器模式，使你能够解决不同设备的依赖。你可以轻松地使用IoC容器或依赖注射架构来集成，以保持干净的依赖解决方案。

(9)灵活的托管： Web ApI可以托管在任何类型的 ASP.NET应用程序内 （包括这两个基于应用程序的ASP. NET MVC和ASP.NET Web Forms）。我们还设计了 Web API 支持，这样，你还可以选择在你自己的进程内托管/公开它们，如果你不想使用 ASP.NET/IIS 来这样做。至于你如何以及在哪儿使用它，这给了你最大的灵活性。

3. 创建一个Web API程序

启动VS2012创建一个新项目，在已经安装的模板中选择 ASP.NET MVC4 Web API程序

在ASP.NET MVC项目对话框中选择Web API项，点击确定

创建成功之后工程中会自动添加一个Web API服务控制器，上面并附带访问地址

项目解决方案，选择Models文件夹右键 添加一个Model类

代码如下：

namespace Git.Framework.WebAPI.Models


{




    public class Contact




    {




        public int ID { get; set; }








        public string Name { get; set; }








        public string Sex { get; set; }








        public DateTime Birthday { get; set; }








        public int Age { get; set; }




    }


 }


工程解决方案选择Controllers文件夹右键添加一个新的Web API controller




在添加控制器弹出对话框中选择模板： 空API控制器




控制器中添加如下代码：


namespace Git.Framework.WebAPI.Controllers




{




    public class ContactController : ApiController




    {




        Contact[] contacts = new Contact[] 




        { 




            new Contact(){ ID=1, Age=23, Birthday=Convert.ToDateTime("1977-05-30"), Name="情缘", Sex="男"},




            new Contact(){ ID=2, Age=55, Birthday=Convert.ToDateTime("1937-05-30"), Name="令狐冲", Sex="男"},




            new Contact(){ ID=3, Age=12, Birthday=Convert.ToDateTime("1987-05-30"), Name="郭靖", Sex="男"},




            new Contact(){ ID=4, Age=18, Birthday=Convert.ToDateTime("1997-05-30"), Name="黄蓉", Sex="女"},




        };








        /// <summary>




        /// /api/Contact




        /// </summary>




        /// <returns></returns>




        public IEnumerable<Contact> GetListAll()




        {




            return contacts;




        }








        /// <summary>




        /// /api/Contact/id




        /// </summary>




        /// <param name="id"></param>




        /// <returns></returns>




        public Contact GetContactByID(int id)




        {




            Contact contact = contacts.FirstOrDefault<Contact>(item=>item.ID==id);




            if (contact == null)




            {




                throw new HttpResponseException(HttpStatusCode.NotFound);




            }




            return contact;




        }








        /// <summary>




        /// 根据性别查询




        /// /api/Contact?sex=女




        /// </summary>




        /// <param name="sex"></param>




        /// <returns></returns>




        public IEnumerable<Contact> GetListBySex(string sex)




        {




            return contacts.Where(item => item.Sex == sex);




        }




    }


}


4. 浏览器访问API路径








Controller Methed




URI








GetListAll




/api/Contact








GetListBySex




"/api/Contact?sex=" + sex








GetContactByID




/api/Contact/"+id








在IE浏览器中浏览出现如下效果




如果在Chrome 或者 FireFox 中浏览会先下如下效果




5. Javascript访问Web API


在项目中添加一个About View视图




代码如下：


@{




    Layout = null;




}








<!DOCTYPE html>








<html>




<head>




    <meta name="viewport" content="width=device-width" />




    <title>About</title>




    <script type="text/javascript" src="/Scripts/jquery-1.7.1.min.js"></script>




    <script type="text/ecmascript">




        $(document).ready(function () {




            $("#btnAll").click(function () {




                $.getJSON("/api/Contact", function (data) {




                    var html = "<ul>";




                    $(data).each(function (i, item) {




                        html += "<li>"+item.ID+":"+item.Name+":"+item.Sex+"</li>";




                    });




                    html += "</ul>";




                    $("#contactAll").html(html);




                });




            });












            $("#btnID").click(function () {




                var id = $("#txtID").val();




                $.getJSON("/api/Contact/"+id, function (data) {




                    var html = "<ul>";




                    $(data).each(function (i, item) {




                        html += "<li>" + item.ID + ":" + item.Name + ":" + item.Sex + "</li>";




                    });




                    html += "</ul>";




                    $("#contactID").html(html);




                });




            });








            $("#btnSex").click(function () {




                var sex = $("#ddlSex").val();




                $.getJSON("/api/Contact?sex=" + sex, function (data) {




                    var html = "<ul>";




                    $(data).each(function (i, item) {




                        html += "<li>" + item.ID + ":" + item.Name + ":" + item.Sex + "</li>";




                    });




                    html += "</ul>";




                    $("#contactSex").html(html);




                });




            });




        });




    </script>




</head>




<body>




    <p>




        <input type="button" id="btnAll" value="查询所有" />&nbsp;




    </p>




    <p>




        <input type="text"  id="txtID" name="txtID"/>




        <input type="button" id="btnID" value="根据ID查询" />&nbsp;




    </p>




    <p>




        <select id="ddlSex" name="ddlSex">




            <option value="男">男</option>




            <option value="女">女</option>




        </select>




        <input type="button" id="btnSex" value="根据性别查询" />&nbsp;




    </p>




    <div id="contactAll">




    </div>




    <div id="contactID">




    </div>




    <div id="contactSex">




    </div>




</body>


</html>


运行结果效果图




6. Web API总结


1.Web API 控制器(Controller) 继承ApiController


2. Api 的 Url Map： api/{controller}/{id} 每个"Action"是通过 Http谓词(GET/POST/PUT/DELETE)映射的


3.客户端可以通过 Http Header 的 Accept 指定返回数据的格式。默认是支持：appliction/xml 和 application/json，当想返回比如 image/jpeg 这样的图片格式时，需要添加 MediaTypeFormatter 。比如：当指定某个 Task 时，通过指定 Accept : image/jpeg 获取该 Task 的图片信息。(后面详细介绍)
												


											
ASP.NET MVC Web API 学习笔记---Web API概述及程序示例的更多相关文章
	

    
								
  1. ASP.Net MVC开发基础学习笔记：五、区域、模板页与WebAPI初步
		
    一.区域—麻雀虽小,五脏俱全的迷你MVC项目 1.1 Area的兴起 为了方便大规模网站中的管理大量文件,在ASP.NET MVC 2.0版本中引入了一个新概念—区域(Area). 在项目上右击创建新 ...
    
		
    2. 
						
  2. ASP.Net MVC开发基础学习笔记（5）：区域、模板页与WebAPI初步
		
    一.区域—麻雀虽小,五脏俱全的迷你MVC项目 1.1 Area的兴起 为了方便大规模网站中的管理大量文件,在ASP.NET MVC 2.0版本中引入了一个新概念—区域(Area). 在项目上右击创建新 ...
    
		
    3. 
						
  3. 【jqGrid for ASP.NET MVC Documentation】.学习笔记.1.介绍
		
    1 介绍 jqGrid for ASP.NET MVC 是一个服务端组件. 专为MVC    分隔 model ,view , controller 的原则,完全观察者模式 非常快的速度    仅仅很 ...
    
		
    4. 
						
  4. ASP.NET MVC 5 系列 学习笔记 目录 (持续更新...)
		
    前言: 记得当初培训的时候,学习的还是ASP.NET,现在回想一下,图片水印.统计人数.过滤器....HttpHandler是多么的经典! 不过后来接触到了MVC,便立马爱上了它.Model-View ...
    
		
    5. 
						
  5. ASP.Net MVC开发基础学习笔记：一、走向MVC模式
		
    一.ASP.Net的两种开发模式 1.1 ASP.Net WebForm的开发模式 (1)处理流程 在传统的WebForm模式下,我们请求一个例如http://www.aspnetmvc.com/bl ...
    
		
    6. 
						
  6. ASP.Net MVC开发基础学习笔记：二、HtmlHelper与扩展方法
		
    一.一个功能强大的页面开发辅助类—HtmlHelper初步了解 1.1 有失必有得 在ASP.Net MVC中微软并没有提供类似服务器端控件那种开发方式,毕竟微软的MVC就是传统的请求处理响应的回归. ...
    
		
    7. 
						
  7. ASP.Net MVC开发基础学习笔记：三、Razor视图引擎、控制器与路由机制学习
		
    一.天降神器“剃须刀” — Razor视图引擎 1.1 千呼万唤始出来的MVC3.0 在MVC3.0版本的时候,微软终于引入了第二种模板引擎:Razor.在这之前,我们一直在使用WebForm时代沿留 ...
    
		
    8. 
						
  8. ASP.Net MVC开发基础学习笔记：四、校验、AJAX与过滤器
		
    一.校验 — 表单不是你想提想提就能提 1.1 DataAnnotations(数据注解) 位于 System.ComponentModel.DataAnnotations 命名空间中的特性指定对数据 ...
    
		
    9. 
						
  9. ASP.Net MVC开发基础学习笔记（4）：校验、AJAX与过滤器
		
    一.校验 — 表单不是你想提想提就能提 1.1 DataAnnotations(数据注解) 位于 System.ComponentModel.DataAnnotations 命名空间中的特性指定对数据 ...
    
		
    10. 
		

	


随机推荐
	

    
									
  1. 深入理解arguments.callee
			
    在函数内部,有两个特殊的对象:arguments 和 this.其中, arguments 的主要用途是保存函数参数, 但这个对象还有一个名叫 callee 的属性,该属性是一个指针,指向拥有这个 a ...
    
			
    2. 
						
  2. sql语句（一）— —判断是否有这条数据的优化
			
    今天发现一个业务上的存储过程写的不够完善,和老板反应后,老板说你来完善吧,我:苦瓜脸~.说实话,我对SQL语句的熟练程度真的是不提也罢[捂脸],大概的判断流程我知道,但是真的让我自己写,还真得上网查查 ...
    
			
    3. 
						
  3. DOS简单文件指令
			
    DOS和Windows最大的不同在于DOS命令方式操作,所以使用者需要记住大量命令及其格式使用方法,DOS命令分为内部命令和外部命令, 内部命令是随每次启动的COMMAND.COM装入并常驻内存,而外 ...
    
			
    4. 
						
  4. docker 导出导入镜像
			
    1.docker export jenkins > my_jenkins.tar   导出镜像到本地 cat my_jenkins | docker import my_jenkens:0.0. ...
    
			
    5. 
						
  5. 原生js实现清除子元素节点
			
    var table = document.body.querySelector('.mui-table-view'); while(table.hasChildNodes()) //当table下还存 ...
    
			
    6. 
						
  6. JavaScript 对象拷贝研究
			
    介绍一下JavaScript里面的一些对象拷贝的方法 浅拷贝 深拷贝 利用序列化进行对象拷贝
    
			
    7. 
						
  7. VueJs初步学习，一个表格的增删改查
			
    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...
    
			
    8. 
						
  8. itchat分析微信好友的个性签名
			
    itchat分析微信好友的个性签名 itchat是一个开源的微信个人号python接口(公众号.企业号接口为itchatmp).使用它可以非常优雅地操纵个人微信号.文档链接 七夕到了,博主也要自娱自乐 ...
    
			
    9. 
						
  9. 如何提高sql查询速度
			
    1.对查询进行优化,应尽量避免全表扫描,首先应考虑在 where 及 order by 涉及的列上建立索引. 2.应尽量避免在 where 子句中对字段进行 null 值判断,否则将导致引擎放弃使用索 ...
    
			
    10. 
						
  10. poj3320 Jessica's Reading Problem（尺取思路+STL）
			
    https://vjudge.net/problem/POJ-3320 尺取法,要想好组织方式. 又被卡了cin.. #include<iostream> #include<cstd ...
    
			
    11.