这是一个简单易用的 NPL Web 应用框架，实现方式参考自 Express，用法也与 Express 基本相似。
所有对 HTTP 的处理操作均采用中间件（middleware）的形式。你也可以为 NPLExpress 开发你自己的中间件。
（该插件还未更新，敬请期待。。。。。。。。。。。）
-
一、确保你已经为你的 Visual Studio 安装了 NPLLuaLanguageService 插件，如果没有，请下载并安装它：
https://marketplace.visualstudio.com/items?itemName=Xizhi.NPLLuaLanguageService
-
二、使用 Visual Studio 创建一个 Web Application for Express：
（等待截图中。。。。。。。。）
-
三、项目创建后，Visual Studio 会自动帮我们生成一些基本的文件：
（等待截图中。。。。。。。。）
-
四、点击 Visual Studio 顶部的 “运行”
即可启动项目并在浏览器中打开项目首页：（等待截图中。。。。。。。。）
你也可以右键点击项目名，在弹出菜单中选择 “Open Command Prompt Here...”，
（等待截图中。。。。。。。。）
这会打开一个命令行窗口，在该命令行窗口中输入指令
npl bin/www.npl并回车：（等待截图中。。。。。。。。）
同样可以启动项目。但这种方式启动项目后不会自动在浏览器中打开项目首页。你可以在浏览器地址栏中输入
http://localhost:3000来打开项目首页。
NPLExpress 推荐使用 NPLLustache 模板引擎。
如果你希望在你的项目中使用 NPLLustache ，可以这样做：
local express = NPL.load('express');
local app = express:new();
app:set('views', 'views');
app:set('view engine', 'lustache');
代码 app:set('view engine', 'lustache') 设置了你的应用将使用 NPLLustache 模板引擎，app:set('views', 'views') 设置了模板文件所在的路径，即模板文件放置在应用程序的根目录下的 views 目录。
如果你希望使用其它的模板引擎，则只需将 app:set('view engine', 'lustache') 的第二个参数改为模板引擎的模块名（包名）即可。必须能通过 NPL.load('YOURR_MOD_NAME') 或 require('YOUR_MOD_NAME') 加载到该模块。
作为在 NPLExpress 中使用的模板引擎，如果你期望能使用 NPLExpress 的 render(path, data) 方法来渲染模板并推送到客户端的话，则该模板引擎必须拥有 renderFile(path, data) 方法 和 render(template, data) 方法。
renderFile(path, data) 方法的第一个参数表示需要转换成 HTML 的模板文件的路径，第二个参数为传递给模板的数据（table）。
render(template, data) 方法的第一个参数表示需要转换成 HTML 的模板字符串，第二个参数为传递给模板的数据（table）。
这两个方法都需要能返回转换后的 HTML 字符串。
如果该模板引擎没有以上两种方法，则不能使用 NPLExpress 的 render(path, data) 方法，但你可以使用你的模板引擎所提供的方法将模板渲染成 HTML 字符串，然后再使用 NPLExpress 的 send(html) 方法将其推送到客户端。
如果该模板引擎需要能被配置，则需提供一个 config(cnf) 方法。NPLExpress 会通过该方法将有关针对模板引擎的配置传递给模板引擎，比如设置的模板文件所在的路径。当 config(cnf) 方法接收到的参数有个 key 值为 'views' 时，即表示是在设置模板文件所在的路径。
NPLExpress 的路由匹配不支持复杂的正则匹配。对于未来是否加入复杂的正则匹配，正在考虑中。目前这种简单的匹配方式已经能够满足绝大部分应用的需求。
local express = NPL.load('express');
local router_news = NPL.load('./routes/news');
local app = express:new();
app:use('/news', router_news);
注意上面代码中的 app:use('/news', router_news) ，表示当接收到了客户端的请求地址是 /news 时，则用 router_news 来处理。严格来说，是当客户端的请求地址是以 /news 开头时，则使用 router_news 来处理。router_news 是一个 express.Router 的实例，在这个案例中，我们的实现如下：
./routes/news.lua
local express = NPL.load('express');
local router = express.Router:new();
router:get('/', function(req, res, next)
res:send({msg = 'Hello NPLExpress'});
end);
NPL.export(router);
注意这里的 router:get(...) ，它会匹配客户端的 GET 请求。在这个案例中，当客户端访问的地址是 /news 时，并且是使用的是 GET 方式，则会使用 router:get(...) 的第二个 function 参数去处理这个请求。
如果希望处理的是 POST 请求，则应该是 router:post(...) ，依此类推，还可以是 router:delete(...) 、 router:put(...) 等等。
如果希望处理的请求地址是 /news/hot 时，可将路由配置中的 app:use('/news', router_news) 修改为：
app:use('/news/hot', router_news);
也可将 ./routes/news.lua 中的 router:get('/', ...) 修改为：
router:get('/hot', function(req, res, next)
res:send({msg = 'Hello NPLExpress'});
end);
NPLExpress 是“逐层匹配”。上例中的 app:use('/news', router_news) 就是第一层的配置。当 NPLExpress 接收到的请求地址为 /news/hot 时，会先在第一层配置中按配置的先后顺序逐个查找有没有相匹配的，它会发现配置的地址 /news 与请求地址 /news/hot 中的第一个节点相匹配，然后它就会执行到第二个参数。第二个参数是一个 express.Router 的实例时，在它里面也可以对路由进行配置，这就是第二层的配置了。NPLExpress 会按先后顺序再次匹配，当找到一个配置的地址为 /hot 时，就与客户端请求的地址完全匹配上了，然后就会执行这个配置的第二个参数（一个function）了，这个 function 才是对请求的处理函数。
按照这套匹配规则，为了提升匹配效率，我们应该将可能与更多请求地址匹配成功的路由配置写在后面，如：
app:use('/news', router_news);
app:use('/', router_index); -- 这个配置应该写在最后面，因为 `/` 能与任何请求地址匹配成功。
从在 express.Router 的实例中配置路由的代码可以看出，配置路由时，第二个参数除了可以是一个 express.Router 的实例外，也可以是一个 function 。用 app:use(....) 来配置路由时，第二个参数也可以是一个 function ：
app:use('/news', function(req, res, next)
-- do something
next(req, res, next);
end);
注意，如果你希望 NPLExpress 继续往下匹配，则需要调用 next(....) 方法。除非你非常明确你的代码的意图，否则不建议这样使用。
如果希望通过 URL 传递参数，如：当用户访问的网址为 /news/9527 时，你希望网址中的 “9527” 是新闻的ID，则可这样配置路由：
app:use('/news/:id', router_news);
这里的 “:” 表示这里是一个占位符，它可与任何字符串匹配，“:” 后面的 “id” 是一个名字，可在路由的处理函数中通过 request 对象按这个名字找到填充到这里的值：
local id = req.params.id;
路由的处理函数会接收到三个参数，分别是 request 对象的实例、 response 对象的实例、以及一个 next 方法。
request 对象是对客户端请求数据的封装，主要包含下属性和方法：
-
Host： string ，当前请求的域名，如在本机测试，可能的值为 “localhost:3000”
-
url: string ，当前请求的URL，如：“/news/hot”
-
pathname: string ，不包含 query 部分的 URL，如请求的地址为 “/news?id=100”，则 pathname 的值为 “/news”
-
search: string ，请求的 URL 的 query 部分，如请求的地址为 “/news?id=100”，则 search 的值为 “id=100”
-
method: string ，当前请求的 method，可能的值有 'GET'、'POST'、'DELETE'、'PUT'、'UPDATE' 等
-
User-Agent: string ，客户端浏览器的版本信息，以下为一个示例：'Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
-
Accept-Language: string ，客户端浏览器所使用的语言，以下为一个示例：'zh-CN,zh;q=0.8'
-
params: table ，通过 URL 传递的参数（注意：不是 query 参数）
-
query: table ，query 参数
-
body: table ，通过 POST 传递的参数
-
session: express.Session ，可通过它对 session 进行操作
-
cookies: table ，客户端传递过来的 cookie
-
client: table ，客户端相关的信息。如：ip（客户端的IP地址）
-
files: table ，客户端上传的文件。
response 用来将数据传递给客户端。主要属性和方法有：
-
send(data): function ，如果参数 data 为字符串，将直接将字符串推送到客户端，如果参数 data 为 table ，则会将 table 转为 JSON 再推送到客户端。
-
render(path, data) function ，渲染一个模板文件，将得到的 HTML 字符串推送到客户端。参数 path 是一个 string ，表示模板文件的路径。参数 data 是一个 table ，这个 table 会传递给模板文件。
-
redirect(otherUrl) function ，跳转到另一个 URL，参数 otherURL 为一个字符串，即希望跳转到的 URL。
-
appendCookie(cookie) function ，向客户端添加一个 cookie 。参数 cookie 为一个 express.Cookie 对象。
-
setHeader(key, value) function ，设置发送到客户端的响应头。参数 key 与 value 均为 string 。
-
setStatus(statusCode) function ，设置发送到客户端的响应状态码。参数 statusCode 为一个正整数。
-
setContentType(contentType) function ，设置发送到客户端的 content-type ，参数 contentType 为一个 string，可能的值有：“text/htm”、“text/css”、“image/jpeg”、“application/x-javascript”、“application/json” 等等。
-
setCharset(charset) function ，设置字符编码。参数 charset 为一个 string ，如：“utf-8”。
-
setContent(content) function ，设置发送到客户端的主体内容。content 可以是一个 string ，也可以是一个 table 。
local express = NPL.load('express');
local app = express:new();
app:use(express.static('public'));
以上代码设置了根目录下的 “public” 文件夹是用来存放静态文件的，也可以说，针对静态文件来说 “public” 文件夹就是应用程序的根目录。
还可以在这里默认文件，即当客户端请求的网址是一个目录，不是具体的某个文件，则应该访问的是哪个文件。默认值为 “index.htm”，即，当客户端访问的是网址为 http://www.domain.com/ 时，实际访问的是 http://www.domain.com/index.htm 。可以这样修改此默认值：
app:use(express.static('public', { default = 'default.htm' }));
这样，当客户端访问的是网址为 http://www.domain.com/ 时，实际访问的是 http://www.domain.com/default.htm 。
本质上，express.static(...) 返回的是一个 NPLExpress 的中间件，由此中间件来处理所有针对静态文件的请求。你也可以开发自己的用来处理静态文件的中间件。
如果希望在你的应用中使用 session，则需配置 session 中间件：
app:use(express.session());
建议将此代码写在配置静态文件中间件的代码 app:use(express.static('public')) 后面。因为 NPLExpress 是按代码顺序执行中间件的，而针对静态文件的请求是不需要在服务器端操作 session 的。这样处理会在性能上有所优化。
express.session() 返回的也是一个中间件，你当然也可以用你自己写的 session 中间件替换它。该方法还能接受以下配置参数：
app:use(express.session({
maxAge: 3600, -- session 经过多长时间后会被清除，单位为“秒”。默认值为 86400 。
domain: 'nooong.com', -- 设置 session 所作用的域，默认值为 nil ，即只会作用于当前域。
secure: true -- 是否加密传输。默认值为 false
}));
你当然也可以在设置某个 session 时单独为其指定以上参数：
req.session:set({
name = 'myname',
value = 'caoyongfeng',
maxAge = 3600
});
在设置 session 时，参数中的 name 和 value 是必须的，其它都是可选的。
根据 session 名取得 session 对象：
local mysession = req.session:get('myname');
session 对象包含以下属性：
local mysession = req.session:get('myname');
local name = mysession.name; -- session 的名字，这里当然返回的是 'myname'（如果 mysession 不为 nil 的话）
local value = mysession.value; -- 该 session 中存储的数据。
local maxAge = mysession.maxAge; -- 生命期。
local domain = mysession.domain; -- 作用域。
如果希望修改 session 的值，可以这样做：
local mysession = req.session:get('myname');
mysession.value = 'cyf';
但需要注意的是：这样并不会重置 session 的有效期。如果希望修改 session 的值后其有效期也能被重置，则可以直接设置一个同名的 session ：
req.session:set({
name = 'myname',
value = 'cyf',
maxAge = 3600
});
这样，新的 session 将会覆盖旧的 session 。
如果希望将指定的 session 移除，可以这样写：
req.session:remove('mynmae');
读取客户端传递过来的 cookie ：
local cookie = req.cookies['COOKIE_NAME'];
local value = cookie.value; -- cookie 的值
设置 cookie :
local c = express.Cookie:new({
name = 'myname',
value = 'caoyongfeng',
maxAge = 3600 * 24, -- 可选。该 cookie 过多长时间过会失效。单位为“秒”。默认值为 86400
path = '/', -- 可选。设置 cookie 的 path ，默认值为 “/”
domain = 'nooong.com', -- 可选。设置 cookie 的 domain ，默认值为 nil
secure = false -- 可选。设置 cookie 的 secure ，默认值为 false
});
res:appendCookie(c);
如果希望修改 cookie 的值，则需重新设置一个同名的 cookie 。
如果希望删除一个 cookie ，则设置一个同名的 cookie ，并将 maxAge 设为负数：
local c = express.Cookie:new({
name = 'myname',
maxAge = -1
});
res:appendCookie(c);
可通过 request 对象的 files 属性取得客户端上传的文件。
if(req.files) then -- 如果客户端没有上传文件，则 req.files 为 nil
local file = req.files[1]; -- req.files 是一个数组（table）
if(file) then
local re = file:saveAs();
-- 文件会被默认保存到 /public/uploads/ 目录下。
-- 如果希望保存到指定的目录，可为 saveAs() 传递一个参数，如：file:saveAs('/public/imgs')。
-- 也可为通过配置改变默认目录： app:set('upload_dir', '/public/imgs');
-- 保存的文件名是一个随机字符串，如果希望指定文件名，则可为 saveAs() 方法传递第二个参数： file:saveAs(nil, 'YOUR_FILE_NAME')
-- saveAs() 方法返回一个 table ,包含：
-- filename: 保存在服务器上的文件的名字
-- size: 文件大小
-- contentType: 上传文件时使用的 contentType
-- srcname: 文件原来的名字
end
end