在前面的文章[轻量级的Web框架——Nancy]中简单的介绍了一下Nancy的特点，今天这里就介绍下它的基本用法，由于2.0的版本还是预览状态，我这里用的是1.4版本，和最小的版本API还是有些差异的。
模块
Nancy的模块的概念类似于Asp.net中的Controller，一个典型的示例如下：
{ public Module()
{
Get["/greet"] = x => "hello world";
}
}
它定义了一个模块，并且定义了该模块下的一个Get操作。Nacy的模块需要继承自NancyModule ，服务器启动时默认会通过反射加载所有程序集下的NancyModule，包括各个dll中的程序集。
如果要实现动态加载别的程序集下的模块，初始化的时候使用Assembly.LoadFile之类的方法将其程序集加载即可。
Assembly.LoadFile(Path.GetFullPath(@".\WebModules.dll"));
操作
在模块中定义操作的基本用法如下：
Get["/greet"] = x => "hello world";
我们访问http://xxxx/greet的时候，就可以看到hello world字样。可以看出，每个模块中，对于Get，Post，Put及Delete等基本操作都定义了一个字典，类型为RouteBuilder，在RouteBuilder中定义了各种操作。
路由
默认情况下，RouteBuilder的key值定义的是绝对路径，例如
Get["/greet"] = x => "hello world";
定义的路由就是/greet。非常直接，
父路由
如果Module下的操作比较多，我们往往会将其设计为放在统一的父路由底下。如果每一个都定义一个父路由显得比较繁琐，此时，可以通过在Module中定义父亲路由的方式解决此问题。
public class ResourceModule : NancyModule
{ public ResourceModule() : base("/products")
{ //此时的路径就是 /products/list
Get["/list"] = _ => "The list of products";
}
}
参数传递
我们可以使用类似Asp.net类似的路由方式传递参数：
Get["/greet/{name}"] = para => $"Hello {para.name}";
参数是通过一个dynamic对象传递给该路由的操作行为的，每个参数都是该对象的一个属性值。可以通过 /greet/abc类似的路径查看访问结果。
但是，有时我们想要通过QueryString传递参数，如 /greet?name=abc， 此时可以通过Request.Query获取查询字符串。示例如下：
public class Module : NancyModule
{ public Module()
{
Get["/greet"] = para => { var name = Request.Query["name"];
return $"Hello {name}";
};
}
}
前面的示例我们的操作都是返回一个字符串，但这种方式对于复杂对象来说是不够用的，此时我们就需要用到Nancy的标准返回值对象Response了。
public class Module : NancyModule
{ public Module()
{
Get["/image"] = x => {
var data = File.ReadAllBytes(@"C:\test.jpg");
return new Response
{
ContentType = "image/jpg",
Contents = s => s.Write(data, 0, data.Length)
};
};
}
}
网友评论