标签:
本文为个人对WebApi的回顾无参考价值。主要简单介绍WEB api和webapi项目的基本结构,并创建简单地webaapi项目实现CRUD操作。
在商业应用领域中,应用之间的关联是相当重要的,应用之间如移动应用或者单页应用的创建,都需要强大的后端服务提供相应的数据以便进行CRUD操作。
WCF是基于SOAP协议,支持多种传输协议,多种编码,寄宿于.net framework下,需要生产WSDL代理类文件,更安全可靠。
WebApi是基于HTTP协议,支持XML和json,开源可独立出.net framework。REST风格更适合。
WCF |
ASP.NET Web API |
支持多种传输协议(HTTP, TCP, UDP和自定义传输协议),允许在协议之间进行切换 |
只支持HTTP协议。比较适合传输来自各种浏览器、移动应用。 |
支持多种编码格式(Text, MTOM, Binary),允许相互切换。 |
支持各种媒体类型,如XML和JSON |
符合Web服务标准(可靠的数据,传输,和数据安全) |
不支持高标准的协议,如数据可靠性或者传输准确性。基于基本的协议和排版,如HTTP, WebSockets, SSL, JQuery, JSON, XML |
支持请求回复、单线和多重消息交换模式 |
支持HTTP的请求响应模式,但也支持扩展的,如SignalR和WebSocket的整合 |
基于SOAP协议,因此需要被描述为WSDL,允许自动化工具生成客户端代理,即使服务含有复杂的模式 |
支持多种方式描述API。从自动生成HTML帮助页面描述,到使用结构metadata整合ODATA到APIs中等等。 |
寄宿于.net framework |
寄宿于.net framework但是开源,也能够独立的下载 |
使用WCF创建可靠,安全的web服务,可以支持多种传输协议。使用WebAPI创建基于http协议的服务,服务更广的用户群。当创建和设计新的基于REST风格的服务是,采用webapi。虽然WCF也提供支持写REST风格的服务,但是Webapi的支持更好。
SOAP是基于标准XML的协议,能够与HTTP通讯。可以理解为程序之间通过以XML为格式的SOAP协议进行通讯。ASP.NET Web服务提供创建SOAP协议的web服务。
REST协议用于分布式环境的数据传输,它使我们能够将分布式服务当做一种资源,并通过简单的HTTP协议来操作这些资源。
REST对应数据库CRUD操作的方式,分为4种:
举例说明
当站点为:www.cnblogs.com/blogs, 则代表获取博客列表数据
当站点为www.cnblogs.com/blogs/1,则取决于type类型,如果是put,则创建新的BLOG。
如果是post,则更新当前blog。如果是delete,则删除当前blog。
REST与SOAP对比
WCF比web服务要晚出来。它提供更安全和成熟的方式去创建服务。通过WCF,我们可以定义自己的服务,并配置相关的协议如HTTP,TCP或者IPC甚至消息队列。WCF也可以创建REST服务。
WCF创建REST服务,需要我们做大量的配置工作。通常WCF适用于一些特殊场景,如单向消息传输,消息队列,双工通信。但是使用WCF创建REST服务过于复杂,而且局限于.net 3.5 framework。
微软提出ASP.NET Web API可以理解为一个框架,用于快速简易的创建REST服务。
我们可以点开Values的controller,它集成ApiController,实现的一般的Get,Post,Put,Delete的功能。并提供了响应的URL路径说明。
public class ValuesController : ApiController { // GET api/values public IEnumerable<string> Get() { return new string[] { "value1", "value2" }; } // GET api/values/5 public string Get(int id) { return "value"; } // POST api/values public void Post([FromBody]string value) { } // PUT api/values/5 public void Put(int id, [FromBody]string value) { } // DELETE api/values/5 public void Delete(int id) { } }
打开App_Start文件下的RouteConfig.cs文件,可以看到完整的api路由设置。
public class RouteConfig { public static void RegisterRoutes(RouteCollection routes) { routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); routes.MapRoute( name: "Default", url: "{controller}/{action}/{id}", defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } ); } }
public class UserController : ApiController { public IHttpActionResult GetRead() { var employeeListViewModel = new EmployeeListViewModel(); var empBal = new EmployeeBusinessLayer(); var employees = empBal.GetEmployees(); var empViewModels = employees.Select(emp => new EmployeeViewModel { Name = emp.Name, Salary = emp.Salary.ToString(), SalaryColor = emp.Salary > 15000 ? "yellow" : "green" }).ToList(); employeeListViewModel.Employees = empViewModels; employeeListViewModel.UserName = User.Identity.Name; return Ok(employees); } }
以上是初阶的内容,进阶地址:
http://www.cnblogs.com/ruanyifeng/p/5455105.html
标签:
原文地址:http://www.cnblogs.com/ruanyifeng/p/5455001.html