最近要写一个接口(DEMO),基于HTTP 的 Web 服务,并且绑定在exe上面(console 或者windows service),让客户端可以调用本地系统的关机,获取本机配置等功能。
API框架很多:.NET CORE,WEBAPI,NANCY等。因为功能比较简单,并且是接口绑定在本地一个应用程序上。就想用轻量级框架Nancy。
Nancy的介绍
Nancy 是一个轻量级用于构建基于 HTTP 的 Web 服务,基于 .NET 和 Mono 平台。
Nancy 设计用于处理DELETE,GET,HEAD,OPTIONS,POST,PUT和 PATCH等请求方法,并提供简单优雅的 DSL 以返回响应。
Nancy和Asp.net MVC原理相似,但有自己的一套路由机制,在使用上更加易用,可以用Nancy快速开发一些网站。Nancy官网
Nancy框架搭建
1.建立一个控制台程序
2.点击“引用”,右击“管理Nuget工具包”,安装Nancy相关文件(这里安装Nancy.Hosting.Self就可以了)
3.在Program.cs文件里面设置本地服务的地址。
4.设置Modules:添加一个Modules文件夹,里面添加一个名称为HomeModule类并且继承NancyModule(类似MVC,所有controller继承Controller,所有controller都放在Controllers文件夹下,强制性的规定名称),然后设置路由。(注意Nancy的路由都是在构造函数里面定义,它在启动的时候回去遍历所有的构造函数,同一个地址设置下默认选择最后一个设置的路由),我这里直接用异步的路由了,Nancy路由的种类和功能很强大(设置参数模型:后面会介绍),其他相关设置路由的方法网上很多可以自己去找。
注:这里的CloseSystem()方法是去关闭系统,responseJsonp是jsonp格式字符串。(个人业务)
5.访问 http://localhost:8888/API/CloseSystem 就会自动关机了。
6.设置参数 http://localhost:8888/API/CloseSystem?CallBack=1 想要获取到CallBack的值,要利用参数绑定机制。var obj= this.Bind<Object>();
a.先建立一个model,里面一个字段CallBack
b.获取传过来的model(这句话随便写哪里都可以获取到当前获取到的model)
到现在这个控制台接口就可以满足需求了
当然Nancy的知识还很多例如:各种路由(地址参数,规定参数类型,正则表达式地址,参数模型)
各种回传类别(json,文本,xml等等):
以及Nancy用到WEB端,跨平台等等。
后期发现的Nancy中文转码问题
方法:
找了半天。。汗。。
参考文章:
博客1;