Swagger+AutoRest 生成web api客户端(.Net)
对于.net来说,用web api来构建服务是一个不错的选择,都是http请求,调用简单,但是如果真的要在程序中调用,则还有些工作要做,比如我们需要手写httpClient调用,并映射Model, 如果服务少还可以,多了就繁琐了。
关于Swagger的信息,其他博客已经有介绍,这里就不多说。 大家可以参考http://chuansong.me/n/322685748559 ,使用Swagger后,可以解决服务没有文档或者文档和服务不同步的问题,同时Swagger自带的就有模拟请求的功能,所以可以在页面上直接测试接口。 这些不仅对开发,对测试同学也是友好的。
下面是一个简单的Web API,添加注释
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165304562-85094526.png)
引用swagger后,访问http://XXX/swagger/ui/index(XXX为你的域名),结果如下,可以看到页面上会显示你的服务,以及服务的描述。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165328062-781677877.png)
点击具体某个服务,你可以看到你定义的参数,并可以直接在页面上发起测试。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013171548828-253716540.png)
有了Swagger后,方便查看服务,接下来就是如何调用服务,过往我们通常会写一个HttpUtils的类,里面包含SendGet,SendPost两个方法,如果是简单参数还好,但是如果Get请求返回一个对象,或者Post的时候需要发送一个对象,则需要手写这些类进行封装。 这里介绍一个组件:AutoRest (https://github.com/Azure/AutoRest), 简单来说,就是一个EXE工具,可以根据Swagger的结构生成服务的客户端,这个客户端可以让你像调用本地方法一样调用服务,方法内部包装了Http请求。
在Swagger页面,你可以点击Explore按钮,通过浏览器可以看到这里返回了一个Json字符串,页面也是根据这个字符串进行的渲染,AutoRest也是根据这个结构来生成调用类。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165350187-1082364938.png)
选择Nuget,下载AutoRest
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013171732328-1738175231.png)
在solution下面找到pageage文件夹,目录如下:
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165433171-1367871236.png)
在命令行里面打开 ,输入如下 AutoRest.exe -CodeGenerator CSharp -Modeler Swagger -Input http://XXX/swagger/docs/v1 -Namespace UserServiceClient, 其中Input的参数就是Swagger的Json地址,具体参数含义可以查看文档。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165451328-143836273.png)
执行成功后,在当前目录下会生成一个Generated目录
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165513171-1825053880.png)
打开文件如下:
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165525421-1458821648.png)
新建一个控制台程序,将整个文件夹copy到控制台程序下,文件夹名称可以随意定义。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165548062-1870009137.png)
同时控制台程序需要在Nuget中引用一个Client.
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013165619609-1063293640.png)
写代码,调用,同时支持同步接口和异步接口。
![](https://images2015.cnblogs.com/blog/365270/201610/365270-20161013175327562-931455600.png)
至此,全部完成。
1. 以上这种方式,可以由服务端的同学完成,然后将生成的代码,简单修改后,编译发布到公司内nuget上,其他同学可以直接到公司内nuget下载
2. 服务端同学可以只集成Swagger,然后其他同学如果要用,可以通过工具生成。
3. 以上仅是公司再未使用RPC前,方便服务调用的一种方式。 后面我会介绍一些.Net下的其他的服务调用方式,比如Hession,serverstack
分类: 服务调用