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