Nancy的基本用法

在前面的文章轻量级的Web框架——Nancy中简单的介绍了一下Nancy的特色，今天这里就介绍下它的基本用法，因为2.0的版本仍是预览状态，我这里用的是1.4版本，和最小的版本API仍是有些差别的。

 模块

Nancy的模块的概念相似于Asp.net中的Controller，一个典型的示例以下： 

public class Module : NancyModule
{
    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(@"r:\123.jpg");
            return new Response
            {
                ContentType = "image/jpg",
                Contents = s => s.Write(data, 0, data.Length)
            };
        };
    }
}