基于JVM的服务端javascript平台Ringo.js入门（四）：stick-web框架使用

参考：http://www.ringojs.org/tutorial/stickapp.md

stick是基于jsgi标准开发的web框架。其主要实现了jsgi的middleware相关的功能。具体功能如routing，session获取等等。从java类比来看，jsgi标准其实定义了一个与javaweb类似的机制。其中middleware类似filter可以链式一次执行最后进入app-function。app-function类似servlet。jsgi也定义了他们的使用的req resp的封装格式。其中req.env属性可以存放环境的本地实现，比如java的serlvetRequest类型的对象引用等。

stick101：

首先入门例子stick101.js

//stick测试101
var {Application} = require('stick');
var app = exports.app = new Application();
app.configure('route');
// 在对应web路径模式下，挂载响应函数。
app.get('/*', function(request) {
return {
body: ['Hello World'],
headers: {'Content-Type': 'text/html'},
status: 200
}
});
if (require.main == module) {
//   require('ringo/httpserver').main(module.id); //我的8080端口已经被占用所以不能用默认
var {Server} = require('ringo/httpserver');
var server = new Server({app: app, port: 8880});
server.start();
}

使用ringo stick101.js启动服务器。注意： app  就是被server注册的jsgi应用对应的函数名称。

使用浏览器分别访问

localhost:8880/xxx
localhost:8880/

会发现后者会访问失败。



因为函数被挂载在/*上 -。-

response对象糖果：

stkRt.js文件中做进一步修改。提供response对象辅助函数，同时作为返回对象。

//
var {Application} = require('stick');
var app = exports.app = new Application();
app.configure('route');
// 在对应web路径模式下，挂载响应函数。
app.get('/*', function(request) {
//使用response对象糖果
var response = require('ringo/jsgi/response');
//return response.json({'foo': 'bar'}).error();
//return response.text('Hello World!').setCharset('ISO-8859-1');
//return response.html('<b>hello,world!</b>');
return response.json({'foo': 'bar'});
});
if (require.main == module) {
//   require('ringo/httpserver').main(module.id);
var {Server} = require('ringo/httpserver');
var server = new Server({app: app, port: 8880});
server.start();
}

routing机制：

routing机制就是web框架最基础的web-path分段委派/分发（dispatcher）功能。

stick同时提供method分类。整体上其实非常类似rest类型的web框架，比如java中的jersey。其实前面的例子已经使用了routing。routing使用middleware的方式配置生效。

app.configure('route');

直接使用方法名称作为设定注册函数，来注册特定协议以及特定路径的处理函数。

如:get,post,put,del (rest主要支持的4个)

post("/mypath/spath",function(req){....});

统配付*表示任何字符

而名称占位（named placeholder）符则可以统配路径段，并将名称作为处理函数的参数来用。（完全就是rest）

比如这样的path模式：/blogposts/:yearplaceholder/:monthplaceholder/:anotherplaceholder/index.html

在stkRt上增加：

app.get('/:slug/edit', function(request, slug) {
var response = require('ringo/jsgi/response');
return response.html('Edit ', slug);
});

浏览器展示。



更多参考：

更多stick可以运行下载安装后的demo程序以及doc。

直接使用模块方式运行demo即可。

ringo stick/examples/demo

环境变量设置好以后可以在任何位置这样运行。



其实以实现的middleware还算丰富，mount routing对于较为实用。

常见方式就是：app.configure("notfound", "mount", "static"); 这样middleware就类似filter依次从notfound -> mount -> static -> unhandled  这样的顺序执行。而处理函数以及静态资源都挂载在mount或static下。

mount可以将另一个jsgi标准应用挂载到一个webpath下。

但是需要注意如下几点：

参考如下样例：

app.mount("/rjs/hi", module.resolve("mounted"),true);

1.挂载的app必须在目标模块中export且必须以“app”名称被export。在样例中就是说在模块mounted下必须有一个叫app的jsgi标准应用函数被export。(Application是stick的扩展实现。)

如：

....
export("app");
var app=Application();
app.configure("route");
...

2.在样例中需要增加最后的noRedirect参数true。不知为何stick默认会让mount的路径进行redriect。具体作用不详，但是在调试过程发现，如果不设置会出现路径跳转到其他位置情况，比较郁闷。

技巧： module.resolve("mount-route/app")；从源代码来看这个而方法主要用来将模块相对路径解析成文件系统中的路径。如果本来是相对于模块的目录路径，则直接给出相对于工作目录的路径。如果是模块资源路径则返回资源文件绝对路径。

技巧2：可以参考notfound实现自己的资源失败处理机制。