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. Redis自学笔记:3.6入门-有序集合类型
			
    3.6有序集合类型 3.6.1介绍 在集合类型基础上,为集合中每个元素都关联了一个分数,故可以获得 分数最高(最低)的前N个元素,可以获得指定范围内的元素等 有序集合中每个元素不同,但它们的分数却可以 ...
    
			
    2. 
						
  2. Codeforces.449D.Jzzhu and Numbers(容斥 高维前缀和)
			
    题目链接 \(Description\) 给定\(n\)个正整数\(a_i\).求有多少个子序列\(a_{i_1},a_{i_2},...,a_{i_k}\),满足\(a_{i_1},a_{i_2}, ...
    
			
    3. 
						
  3. 潭州课堂25班：Ph201805201 django框架 第三课   模板路径，变量，过滤器，静态文件的引用  (课堂笔记)
			
    第二种方法 首先   'APP_DIRS': True, 将 app 的名字在 INSTALLED_APPS 进行注册 模板变量 传的各种数据类型,和取值 过渡器: 静态文件: 在项目文件目录 中创建 ...
    
			
    4. 
						
  4. 反射与内置方法str del
			
    1.反射 用字符串来操作类或者对象的属性 class People:# country= 'china'# def __init__(self,name):# self.name= name## de ...
    
			
    5. 
						
  5. HTML（一）
			
    html基本结构 一个html的基本结构如下: <!DOCTYPE html> <html lang="en"> <head> <meta ...
    
			
    6. 
						
  6. python系统编程（七）
			
    多线程-共享全局变量 from threading import Thread import time g_num = 100 def work1(): global g_num for i in r ...
    
			
    7. 
						
  7. JS 之 script标签
			
    1.script标签 1.js代码的解析(包括下载js文件)会阻塞页面加载 2.当js文件放在头部,页面必须等所有js代码都被下载,解析和执行完成后才开始呈现页面内容(遇到body标签才呈现),对于那 ...
    
			
    8. 
						
  8. 3ds max学习笔记（九）-- 实例操作(路径阵列)
			
    栅栏 路径阵列也叫间隔工具,将选择的物体沿指定的路径进行复制.实现物体在路径上的饿均匀分布. 选择需要分布的物体对象,在视图中绘制二维图形做为路径线条. 1.选择线条,制作路径 2.选择需要分布的物体 ...
    
			
    9. 
						
  9. 解释Eclipse下Tomcat项目部署路径问题(.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps)
			
    配置eclipse的开发环境,配置jdk的安装路径和tomcat安装路径.在eclipse下建立Dynamic Web Project工程zhgy,在使用eclipse中new一个tomcat,通过启 ...
    
			
    10. 
						
  10. IO流（5）—缓冲流
			
    1.IO体系: 抽象基类--节点流(文件流)--缓冲流(处理流的一种) InputStream --FileInputStream--BufferedInputStream OutputStream- ...
    
			
    11.