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. UVA 1592 DataBase
			
    思路: 知识补充: ①make_pair和pair: /*pair是将2个数据组合成一个数据,当需要这样的需求时就可以使用pair,如stl中的map就是将key和value放在一起来保存.另一个应用 ...
    
			
    2. 
						
  2. 英语口语练习系列-C13-聚会
			
    词汇 音频 1. apartment [əˈpɑ:tmənt] n. 公寓 a big / small apartment 一个大的/小的公寓 in an apartment 在公寓 2. arm [ ...
    
			
    3. 
						
  3. PostgreSQL数组使用
			
    原文:https://my.oschina.net/Kenyon/blog/133974 1.数组的定义  不一样的维度元素长度定义在数据库中的实际存储都是一样的,数组元素的长度和类型必须要保持一致, ...
    
			
    4. 
						
  4. LeetCode(12. 整数转罗马数字)
			
    问题描述 罗马数字包含以下七种字符: I, V, X, L,C,D 和 M. 字符 数值 I 1 V 5 X 10 L 50 C 100 D 500 M 1000 例如, 罗马数字 2 写做 II , ...
    
			
    5. 
						
  5. ThinkPHP CI codeignitor 框架 apache 重写 url 隐藏index.php 服务器 报错：Object not found! 可能是.htaccess隐藏index.php
			
    隐藏index.php可以去掉URL地址里面的入口文件index.php,但是需要额外配置WEB服务器的重写规则.以Apache为例,需要在入口文件的同级添加.htaccess文件(官方默认自带了该文 ...
    
			
    6. 
						
  6. php回话控制 cookie
			
    <?php class CustomCookie{ static private $_instance = null; private function __construct(array $o ...
    
			
    7. 
						
  7. [USACO18DEC]The Cow Gathering
			
    Description: 给定一棵树,每次删去叶子,有m个限制,分别为(a,b)表示a需要比b先删,为每个点能否成为最后被删的点 Hint: \(n,m \le 10^5\) Solution: 手模 ...
    
			
    8. 
						
  8. Java 多线程 临界区
			
    临界区表示一种公共资源或共享数据,可以被多个线程使用.但是每一次只能有一个线程使用它.一旦临界区资源被占用,想使用该资源的其他线程必须等待. 例如,办公室里的打印机一次只能执行一个任务.当小王和小明同 ...
    
			
    9. 
						
  9. javaweb数据库编程代码详细讲解
			
    import java.sql.*; /*默写数据库练习数据库编程及注释讲解代码*/ public class Main{ public static void main(String[]args)t ...
    
			
    10. 
						
  10. Linux 压缩解压缩
			
    先直接给出各种解压缩命令 .tar 压缩:tar cvf FileName.tar FileName 解压:tar xvf FileName.tar ------------------------- ...
    
			
    11.