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. .NET Framework 4 与.NET Framework 4 Client Profile有什么区别？
			
    .net framework 自从 2002 年发展至今,已经历了好几个版本,1.0, 1.1, 2.0, 3.0, 3.5 等不同的版本更替,.net framework 的Redistributa ...
    
			
    2. 
						
  2. Django单表操作
			
    一.数据库相关设置 配置ORM的loggers日志: # 配置ORM的loggers日志 LOGGING = { 'version': 1, 'disable_existing_loggers': F ...
    
			
    3. 
						
  3. Scrapy基础(五) ------css选择器基础
			
    基本语法: *                  选择所有节点#container         选择id为container的节点.container      选择所有class包含contai ...
    
			
    4. 
						
  4. 【开源GPS追踪】 之 硬件开源
			
    根据设定目标: 使用GPS 采集经纬度,然后通过GPRS模块/wifi 发送到服务器显示,WIFI不常有,所有就使用GPRS模块! 对于GPS模块,没有特殊要求,只要输出格式符合NMEA协议即可,为了 ...
    
			
    5. 
						
  5. 编程菜鸟的日记-初学尝试编程-C++ Primer Plus 第5章编程练习2
			
    #include <iostream>using namespace std;const int MAXSIZE=100;int main(){ int a[MAXSIZE]; int s ...
    
			
    6. 
						
  6. yii创建控制台命令
			
    创建控制台命令程序1.控制台命令继承自 yii\console\Controller控制器类2.在控制器类中,定义一个或多个动作,动作与控制台子命令相对应3.在动作方法中实现业务需求的代码 运行控制台 ...
    
			
    7. 
						
  7. Python内置模块的几点笔记
			
    1.shutil模块 import shutil shutil.make_archive('shutil_archive_test', 'zip', 'D:\pyworkspace\.idea') m ...
    
			
    8. 
						
  8. JDBC（10）—批处理
			
    批量处理JDBC语句,提高处理速度. 当需要成批的的插入或更新记录时可以采用java的批量更新机制,这一机制允许多条语句一次性提交给数据库批量处理,通常情况下比单独提交处理更有效率. 批量处理的方法: ...
    
			
    9. 
						
  9. poj3259 Wormholes（Bellman-Ford判断负圈）
			
    https://vjudge.net/problem/POJ-3259 一开始理解错题意了,以为从A->B一定得走路,B->A一定得走虫洞.emmm其实回来的时候可以路和虫洞都可以走,只要 ...
    
			
    10. 
						
  10. linux 新建用户、用户组 以及为新用户分配权限（转）
			
    本文转自https://www.cnblogs.com/clicli/p/5943788.html 感谢作者 Linux 系统是一个多用户多任务的分时操作系统,任何一个要使用系统资源的用户,都必须首先 ...
    
			
    11.