今天学习一下:WebAPI如何使用呢?
首先我们打开vs新建一个WebAPI项目,可以看到一共有这些文件夹目录
首先了解一下这些文件夹/文件的意义(按照程序启动的流程,相关的配置项就不说了),
Global.asax:这个是程序启动的文件,内部的默认方法【Application_Start】对文件绑定、WebAPI路由、mvc控制器路由等进行注册,只会在第一个用户访问的时候运行;上网找了一下相关资料,发现可以在其中添加很多的配置方法:
1 using System;2 using System.Collections.Generic;3 using System.IO;4 using System.Linq;5 using System.Text;6 using System.Web;7 using System.Web.Http;8 using System.Web.Mvc;9 using System.Web.Optimization;10 using System.Web.Routing;11 12 namespace AAAAAA.WebAPI13 {14 /// <summary>15 /// WebApi全局设置16 /// </summary>17 public class WebApiApplication : System.Web.HttpApplication18 {19 /// <summary>20 /// 第一个访问网站的用户会触发该方法. 通常会在该方法里定义一些系统变量21 /// 如聊天室的在线总人数统计,历史访问人数统计的初始化等等均可在这里定义.22 /// </summary>23 protected void Application_Start()24 {25 26 }27 28 /// <summary>29 /// 在应用程序关闭时运行的代码,在最后一个HttpApplication销毁之后执行30 /// 比如IIS重启,文件更新,进程回收导致应用程序转换到另一个应用程序域31 /// </summary>32 /// <param name="sender"></param>33 /// <param name="e"></param>34 void Application_End(object sender, EventArgs e)35 {36 37 }38 39 /// <summary>40 /// 每个用户访问网站的第一个页面时触发;41 /// </summary>42 /// <param name="sender"></param>43 /// <param name="e"></param>44 void Session_Start(object sender, EventArgs e)45 {46 string IP = this.Context.Request.UserHostAddress;47 Session["IP"] = IP;48 }49 50 /// <summary>51 /// 使用了session.abandon(),或session超时用户退出后均可触发.52 /// </summary>53 /// <param name="sender"></param>54 /// <param name="e"></param>55 void Session_End(object sender, EventArgs e)56 {57 // Session["User"]; 向数据库中记录用户退出时间58 }59 /// <summary>60 /// 在每一个HttpApplication实例初始化的时候执行61 /// </summary>62 /// <param name="sender"></param>63 /// <param name="e"></param>64 void Application_Init(object sender, EventArgs e)65 {66 67 }68 69 /// <summary>70 /// 在应用程序被关闭一段时间之后,在.net垃圾回收器准备回收它占用的内存的时候被调用。71 ///在每一个HttpApplication实例被销毁之前执行72 /// </summary>73 /// <param name="sender"></param>74 /// <param name="e"></param>75 void Application_Disposed(object sender, EventArgs e)76 {77 78 }79 80 /// <summary>81 ///所有没有处理的错误都会导致这个方法的执行82 /// </summary>83 /// <param name="sender"></param>84 /// <param name="e"></param>85 void Application_Error(object sender, EventArgs e)86 {87 #region 记录错误日志88 //Exception ex = Server.GetLastError().GetBaseException();89 //StringBuilder str = new StringBuilder();90 //str.Append("\r\n" + DateTime.Now.ToString("yyyy.MM.dd HH:mm:ss"));91 //str.Append("\r\n.客户信息:");92 93 94 //string ip = "";95 //if (Request.ServerVariables.Get("HTTP_X_FORWARDED_FOR") != null)96 //{97 // ip = Request.ServerVariables.Get("HTTP_X_FORWARDED_FOR").ToString().Trim();98 //}99 //else
100 //{
101 // ip = Request.ServerVariables.Get("Remote_Addr").ToString().Trim();
102 //}
103 //str.Append("\r\n\tIp:" + ip);
104 //str.Append("\r\n\t浏览器:" + Request.Browser.Browser.ToString());
105 //str.Append("\r\n\t浏览器版本:" + Request.Browser.MajorVersion.ToString());
106 //str.Append("\r\n\t操作系统:" + Request.Browser.Platform.ToString());
107 //str.Append("\r\n.错误信息:");
108 //str.Append("\r\n\t页面:" + Request.Url.ToString());
109 //str.Append("\r\n\t错误信息:" + ex.Message);
110 //str.Append("\r\n\t错误源:" + ex.Source);
111 //str.Append("\r\n\t异常方法:" + ex.TargetSite);
112 //str.Append("\r\n\t堆栈信息:" + ex.StackTrace);
113 //str.Append("\r\n--------------------------------------------------------------------------------------------------");
114 创建路径
115 //string upLoadPath = Server.MapPath("~/Logs/");
116 //if (!System.IO.Directory.Exists(upLoadPath))
117 //{
118 // System.IO.Directory.CreateDirectory(upLoadPath);
119 //}
120 创建文件 写入错误
121 //System.IO.File.AppendAllText(upLoadPath + DateTime.Now.ToString("yyyy.MM.dd") + ".log", str.ToString(), System.Text.Encoding.UTF8);
122 处理完及时清理异常
123 //Server.ClearError();
124 跳转至出错页面
125 //Response.Redirect("Error.html");
126 #endregion
127 }
128
129
130 /// <summary>
131 /// //每次请求时第一个出发的事件,这个方法第一个执行
132 /// </summary>
133 /// <param name="sender"></param>
134 /// <param name="e"></param>
135 void Application_BeginRequest(object sender, EventArgs e)
136 {
137 var url =Request.Url.ToString();
138
139 }
140
141 /// <summary>
142 ///在执行验证前发生,这是创建验证逻辑的起点
143 /// </summary>
144 /// <param name="sender"></param>
145 /// <param name="e"></param>
146 void Application_AuthenticateRequest(object sender, EventArgs e)
147 {
148
149 }
150
151 /// <summary>
152 /// 当安全模块已经验证了当前用户的授权时执行
153 /// </summary>
154 /// <param name="sender"></param>
155 /// <param name="e"></param>
156 void Application_AuthorizeRequest(object sender, EventArgs e)
157 {
158
159 }
160
161 /// <summary>
162 /// 当ASP.NET完成授权事件以使缓存模块从缓存中为请求提供服务时发生,从而跳过处理程序(页面或者是WebService)的执行。
163 ///这样做可以改善网站的性能,这个事件还可以用来判断正文是不是从Cache中得到的。
164 /// </summary>
165 /// <param name="sender"></param>
166 /// <param name="e"></param>
167 void Application_ResolveRequestCache(object sender, EventArgs e)
168 {
169
170 }
171
172 /// <summary>
173 /// 读取了Session所需的特定信息并且在把这些信息填充到Session之前执行
174 /// </summary>
175 /// <param name="sender"></param>
176 /// <param name="e"></param>
177 void Application_AcquireRequestState(object sender, EventArgs e)
178 {
179
180 }
181
182 /// <summary>
183 /// 在合适的处理程序执行请求前调用
184 ///这个时候,Session就可以用了
185 /// </summary>
186 /// <param name="sender"></param>
187 /// <param name="e"></param>
188 void Application_PreRequestHandlerExecute(object sender, EventArgs e)
189 {
190
191 }
192
193
194 /// <summary>
195 ///当处理程序完成对请求的处理后被调用。
196 /// </summary>
197 /// <param name="sender"></param>
198 /// <param name="e"></param>
199 void Application_PostRequestHandlerExecute(object sender, EventArgs e)
200 {
201
202 }
203
204 /// <summary>
205 /// 释放请求状态
206 /// </summary>
207 /// <param name="sender"></param>
208 /// <param name="e"></param>
209 void Application_ReleaseRequestState(object sender, EventArgs e)
210 {
211
212 }
213
214 /// <summary>
215 /// 为了后续的请求,更新响应缓存时被调用
216 /// </summary>
217 /// <param name="sender"></param>
218 /// <param name="e"></param>
219 void Application_UpdateRequestCache(object sender, EventArgs e)
220 {
221
222 }
223
224 /// <summary>
225 /// EndRequest是在响应Request时最后一个触发的事件
226 ///但在对象被释放或者从新建立以前,适合在这个时候清理代码
227 /// </summary>
228 /// <param name="sender"></param>
229 /// <param name="e"></param>
230 void Application_EndRequest(object sender, EventArgs e)
231 {
232
233 }
234
235 /// <summary>
236 /// 向客户端发送Http标头之前被调用
237 /// </summary>
238 /// <param name="sender"></param>
239 /// <param name="e"></param>
240 void Application_PreSendRequestHeaders(object sender, EventArgs e)
241 {
242
243 }
244
245 /// <summary>
246 /// 向客户端发送Http正文之前被调用
247 /// </summary>
248 /// <param name="sender"></param>
249 /// <param name="e"></param>
250 void Application_PreSendRequestContent(object sender, EventArgs e)
251 {
252
253 }
254 }
255 }
App_Start:这里面主要是程序启动的时候需要进行的一下注册文件,比如路由,文件筛选什么的;
其他的就不介绍了。
打开框架默认提供的控制器【ValuesController】,可以看到内部提供了5个demo,分别是无参Get,带参Get,Post,Put,Delete的请求方式,其中Post和Put的例子参数都是带有【FromBody】特性,这里介绍一下【FromBody】和【FromUrl】;
【FromBody】:强制接口从FormData中读取数据;
【FromUrl】:强制接口从Uri中读取数据。
webApi的路由我们可以看到
控制器之后是直接带参数的,程序是如何根据路由找到对应的接口的呢?WebApi是遵循RESTful设计风格的,webapi会根据请求方式的不同来自动寻找对应的接口,如果一个webAPI控制器内部对于同样的请求方式有多个接口,那么webapi默认路由会找不到对应的接口而报错,如果要遵循RESTful风格,可能需要对每个业务的接口进行控制器隔离。
那么如果需要改变这种请求方式,变成和MVC类似的请求,应该如何修改呢?
我们需要将webapi添加一个路由机制:
这样我们就可以使用mvc模式的路由或者webapi默认路由进行接口的调用了。
WebApi是遵循Restful风格的,所以不建议在路由中出现action,不推荐使用和MVC控制器相同格式的路由
那么使用webapi有哪些地方需要注意呢?
1.ajax中的type有四种方式:get(查询),post(修改),delete(删除),put(插入) 。
2.写webapi时,在后台的方法最好将特性标记号对应上[HttpGet],[HttpPost],[HttpDelete],[HttpPut]。http请求和rest风格的api如果不想在后台方法写特性,但也可以将方法名以Get开头,否则会报错。
get:若是查询数据,通过get,其实get请求会将参数拼装到url上面,而url长度是有限的
post:若是对原有数据新增和修改就用post,多用post即可。post不是将参数放在url上面的,而是放在表单上的。
3.传递的参数username名一定要相同,但是大小写可以不一样。
4.若是user={name:"张苏纳",id:123,age:'19'} 然后data:user那么在后台是接收不到的,即使在页面调试时是可以看到数据。若是想接收到的话,需要在后台写成GetUserModeuri([FormUri]Users user)。
5.基于第4的另一种方法。可以将user序列化转化为一个字符窜,然后后台接收后反序列化即可得到。data:{userString:JSON.stringify(user)}
6.(1)若是通过post请求的时候,是将数据放在from data里面的,若是传递单个参数,不要在ajax上不要写对应参数。
(2)只有不写id才能得到,与[formbody]无关。若是通过post传递实体,那么在后台可以直接拿到 ,不需要任何转化。
(3)当然也可以通过data:Json.stringify(user) contentType:'application/json'(contentType默认是json类型的)来在后台同样得到。
(4)若是参数包含了一个实体,还有一个字符串参数data:{"User":user,"Info":info}该怎么办,可以通过引用Newtonsoft.Json.Linq的JObject类型。jObject.ToObject是一个序列化方法,将josn转化为对象。
7.dynamic动态类型,比如一个实体和一个参数放到同一个对象中,获取对象后,然后dynamic json=jData; var mm= json.user,动态类型是可以直接访问属性的。
8.put和post是一样的使用,put主要是插入数据使用。
9.delete也是一样的。
10.webapi最方便的是给前端使用。