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)
            };
        };
    }
}