进阶之路—WebAPI的布置以及调用

之前两篇文章讲解了 Web Service 和 WCF 的部署调用,本章我们主要来研究一下 WebAPI 的部署调用,其实相对于其他俩中技术, WebAPI 更加另类,为什么这么说呢,因为之前我们在学习无论是 Web Service ,还是 WCF 的时候,这两种技术在远程调用的时候,都需要添加服务引用才能调用得到,但是 WebAPI 则不同,对比之前两种技术,WebAPI 更接近于 ASP.net MVC 这种框架,虽然说 WebAPI 可以寄存在控制台程序,甚至 Winform 程序中,但是 WebAPI 本质就是一个支持谓词的 HTTP 请求。

WebAPI:本质是支持谓词的 HTTP 请求,类似于 MVC 。

接下来我们从头来一遍,看看 WebAPI 到底是什么东西。首先,还是之前的那个项目,我们之前在建立项目选择的时候就已经创建了含有 WebAPI 的 MVC 框架,所以在项目中会自动生成一个文件

进阶之路—WebAPI的布置以及调用_第1张图片


WebAPI自动生成的配置文件

熟悉 MVC 框架的朋友可能会觉得眼熟,其实现在很多公司在建立 MVC 项目的时候都已经直接创建含有 WebAPI 的 MVC 项目了。

进阶之路—WebAPI的布置以及调用_第2张图片


详细代码

从这个自动生成的文件中,我们可以看出跟 MVC 的路由配置很相像,上图中第一段代码是我自定义的,地下那段代码是自动生成的,至于为什么要自定义,这个还是看个人爱好,因为上面的默认格式更加符合 RESTful 风格,而底下自动生成的代码则是抛弃了 action 使用谓词的方式自动检索控制器里面的方法,但是如果出现方法名称不规范的时候就会出现问题。

接下来,我们新建一个控制器,并在控制器当中写一个简单的 Get 方法

进阶之路—WebAPI的布置以及调用_第3张图片


新建的Controller代码

方法本身没有什么特别,但是需要注意的是,这个控制器是需要继承自 ApiController 这个类的,而一般的 Controller 责集成的是 Controller 这个类。接下来,我们就算是部署成功了,接下来我们来聊一聊什么是谓词。

所谓的谓词,就是指我们在调用请求时候的方法,这点大家都很了解,无论是使用 Ajax 还是正常提交请求,都会涉及到 get , post 之类的方法,而在 WebAPI ,默认的路由匹配也是通过这种谓词的形式,举个例子,如果我们在某个 Controller 中定义某个方法,取名为 GetUser ,那么此时对于默认路由来讲也是可以匹配到的,,这就有些奇怪了,为什么配置了 { action }和没有配置的结果都是一样的呢,其实这就是 .net 常说的约定大于配置,默认的路由匹配请求的方式是:在找到相应的 Contorller ,之后在根据你提交的路径中是否出现 Get 为首字母的方法,这样就会跳转过去。同样也适用于 post , delete, put 等方法。

接下来我们还要说一个特性  [ HttpGet ]

[ HttpGet ]:该特性用来表示 Contorller 中的方法,表示了该特性的方法只能以 Get 方式请求到。

同样的,也有对应其他请求的特性。

接下来就是通过远程控制台调用我们之前写的这个方法了,在 WebAPI 中,远程调用我们写好的方法有些不一样,他不需要像在 Web Service 或是 WCF 中添加服务引用,因为 WebAPI 本质上是一个 HTTP 请求,那么我们只需要在调用端写好地址,直接请求就可以了。


进阶之路—WebAPI的布置以及调用_第4张图片


使用HttpClient的代码

上图中我是使用 HttpClient 的方法获取的,也可以使用 HttpWebRequest 的方法调用


进阶之路—WebAPI的布置以及调用_第5张图片


使用HttpWebRequest方法的代码

至此,就可以在控制台程序上面调用到远程服务的代码了。

你可能感兴趣的:(进阶之路—WebAPI的布置以及调用)