webapi访问数据库
Ⅰ WebApi 2 路由机制
.net中包含的路由有两种,第一种是MVC模式的按url匹配action,第二种是WebApi模式的按http请求的方法匹配action,本文我们学习WebApi的路由模式。
首先新建一个WebApi项目,选择ASP.NET Web应用程序(.NET Framework)
这里我们首先来看WebApi的基础配置 WebApiConfig.cs ,其路径为 /App_Start/WebApiConfig.cs
首先以浏览器启动webapi项目
会发现页面显示403,这是很正常的,因为我们在新建项目的时候没有加入MVC,所以没有可视化的view页面,不过我们却拿到了这个项目的 端口号
为了更加方便直观的看我们的接口请求,我们选择postman,首先在项目新建一个 controller
通过以上的操作,我们就搭建好了一个webApi2的项目工程,后面我们就在这个工程的基础上进行webApi 2的开发和学习。
webApi的路由过程主要经历了如下三步
WebApiConfig.cs 这个文件是进行路由表的核心文件, WebApiConfig 里面只有一个方法,这个方法在 Global.asax 文件里的 Application_Start() 方法被调用, Global.asax 文件是一个全局文件,当我们网页启动时就会去执行它。 Register(HttpConfiguration config) 方法是配置WEB API路由的。
因此 在webAP工程启动的时候,会执行 Global.asax ,这个文件里面注册了 WebApiConfig.cs 的一系列初始化配置,从而实现了webapi。
WebApi 2 框架使用路由表。 并由Web API 的 Visual Studio 项目模板创建默认路由
转到 MapHttpRoute 的定义,可以看到它有4个重载
分别来看看各个参数的作用
webApi2工程自动为我们创建了默认的路由
经过上面的讲解,我们知道了匹配的URL是 api/{controller}/{id}
那么我们在实际的请求中应该如何请求
新建一个 StudentsController
依次对以下地址进行请求
总结:
默认路由的缺点
如下
添加如下的方法(action)
得到了一下的结果
我们来看看这个请求是如何进行匹配的,首先找到 /App_Start/WebApiConfig.cs
按照路由模板来看,我们请求的路由没有 action 名称,那么它是怎么进行匹配的呢?
其实当我们访问 http://localhost:65066/api/student 这个url的时候,webapi会自动去匹配 api/{controller}/{id} 这个模板,在这个路径中,student是controller,那么它又是怎么去找到 getStudentName 这个action的呢?明明我们都没有传action这个参数,其实Webapi的路由规则是通过http方法去匹配对应的action,我们请求这个地址是用的 GET 方法,那么webapi会找Order这个控制器里面的get请求的方法,同事我们的这个 getStudentName 是以 get 开头的,它符合了webapi的匹配规则,于是就请求成功了,但前提是你写的方法必须是以get开头的,如果当前这个controller一个get开头的都没有,那么就显示 请求的资源不支持 http 方法“GET” 。
当然不以get开头的前提是你必须加上 [HttpGet] 这个特性,webapi才知道你这个是get的请求方法,就能正确进行匹配。
然后我们再回到 /App_Start/WebApiConfig.cs ,看下里面 MapHttpRoute 的各个参数的含义,首先转到它的定义,发现它是 HttpRouteCollection 的扩展方法, MapHttpRoute 有4类重载
在 WebApiConfig.cs 里面修改为如下的路由模板
接口请求如下
通过 action 的名称来匹配很好理解,上面的 StudentName() 是方法名, webApi 会默认它就是 action 的名称,如果你想要方法名和 action 的名称不一致,你也可以自定义 action 的名称,这个可以通过特性 ActionName 来实现,如下:
首先看路由模板
对于同请求类型,同请求参数的请求,会出现 不传参数,找不到匹配的资源 或 传了参数,但是找到了与该请求匹配的多个操作 的问题,如下所示
解决以上的办法有两种
如果要使用特性路由,首先在 WebApiConfig.cs 的 Register 方法里面必须先启用特性路由(一般情况下,当我们新建一个 WebApi 项目的时候,会自动在 Register 方法里面加上这句话。)
特性路由的目的是为了解决我们公共路由模板引擎解决不了的问题。一个action定义了特性路由之后,就能通过特性路由上面的路由规则找到。
只要出现了特性路由,匹配的规则是按特性路由来的
修改studentController如下
参考
参考
路由前缀的一般的做法是在控制器上面使用特性 [RoutePrefix] 来标识。
但是需要注意路由前缀不能以 / 开头
Ⅱ MVC WebApi在调试开发下访问正常,部署到服务器访问不到接口
1、服务器是否正常启动(查看日志)
2、服务器的IP+PORT是否可以访问,查看端口是否被占用
3、若服务正常启动,端口也可以访问,查看你的访问路径是否正确(部署后的上下文webcontent是否与调试中一致)
4、访问不到有很多原因,要看你面对的具体问题去排查,比如报错信息之类~