2-Nancy文档教程--探索NANCY MODULE

原文地址：https://github.com/NancyFx/Nancy/wiki/Exploring-the-nancy-module

在所有的NANCY应用程序中，module都是最核心的那块。因为module是程序动作的定义者和指导者，不管怎么样你都无法忽略它。事实上，声明一个单独的module是任何一个nancy程序的最低要求。

每一个被创建出来的module都应该继承NancyModule 类。只要你有module，那么你就是上帝，你可以开始定义你程序的各种行为动作，路由的形式以及当他们被调用的时动作的执行方式。总之，module告诉了nancy在运行的时候该做些什么。

一个module不仅仅只是可以用来定义程序的动作。它可以提供给你全局范围内的有用信息，比如当前请求的全部信息，访问请求正在被处理的内容，帮助你建立特定类型的响应(如json,xml,files,redirect等)，渲染视图等。

在程序中你想定义几个module就定义几个，没人会管你，但前提是你得保证至少有一个module和route。

Modules 是全局性的

Modules可以被定义在任何一个你想定义的地方，只要它们在你程序运行的时候可以被整个程序访问得到。Nancy可以扫描和识别所有NancyModule类型的子类。

举个例子，你可以在外部配置你的module，只要你能保证在程序运行的时候，不管你是通过引用还是动态加载在程序中加入这些配置，它都是合法的，都是可被识别的。你可以利用这一点在不同的程序复用你的一些动作定义，你甚至可以为它写一个小而美的nuget。

你是不是会认为这样的扫描所花费的代价太大了？别担心。并不是每次程序请求都会扫描一次，它只是作为NANCY程序启动的一部分，而且它一旦被调用后，信息就会存在缓存里。

通过modules来为你的routes（路由）创建路径

Module的一个小而美的特征是它可以定义module路径。你可以把这个当做是定义在这个module里的所有路径的根命名空间。每一个路径都是这个module的子路径。这样你就不必重复写那部分相同的路径，并且基于它们的联系你可以很好的管理这些路径。

public class ResourceModule : NancyModule
{
    public ResourceModule() : base("/products")
    {
        // would capture routes to /products/list sent as a GET request
        Get["/list"] = parameters => {
            return "The list of products";
        };
    }
}