Nitrogen web framework 入门

Nitrogen web framework 入门

Author:	litaocheng@gmail.com
Data:	2009-1-23
Version:	0.1

目录

• 1   概述
• 2   特性
• 3   期待
• 4   术语(Glossary of Terms)
• 5   应用的结构
• 6   一个简单的例子
• 7   更多阅读

1   概述

Nitrogen是一个使用Erlang开发的Web Framework

2   特性

• 事件驱动模型（和ASP.NET相似，和Ruby On Rails不同）
• 简洁高效：只有~2.5k行代码实现
• 与JavaScript等脚本的交互
• 支持Client和Server的Form验证
• Coment和Long Polling的支持
• 通用的Ajax相关控件实现
• 页面表现与逻辑独立
• 页面文件为纯粹的Erlang代码
• 多种HTTP Server配置

3   期待

• 丰富的文档
• 完善的错误处理机制
• 丰富的调试工具
• 页面热替换
• 可配置javascript lib，比如"jquery", "Mootools", "MochiKit "等
• 提供多种数据库访问
• 精简Nitrogen中各种标签的定义及设置
• 制定一些通用web模型

4   术语(Glossary of Terms)

• application 包含很多的page
• 每个 page 包含很多 element ，nitrogen将其render为html tag
• 每个element可以关联一个或多个 action ，在浏览器中控制page
• 有些action可以成为 event ，event会从浏览器端postback到server端进行处理

5   应用的结构

一个Web Application其实就是Erlang OTP中的一个Application，这个Application我们可以通过脚本来进行创建. 包含下面的内容：

1. html模板文件(包含html,css,image，通常位于/wwwroot/目录下)
2. erl页面代码（包含myapp.app, *.erl文件，通常位于/src/目录下）
3. start.sh启动脚本（用来启动本应用，实质是调用erl启动Application）

Nitrogen默认的路径映射规则，是将 / 转化为 _ ,比如： http://domain/web/user 对应的页面文件为 web_user.erl

用户也可以通过定义myapp:route/1函数，定义自己的路径映射规则。

开发一个应用，首先我们设计编辑html模板页面，随后编写erl页面代码，最后是编译部署，启动。

6   一个简单的例子

创建一个Web版的"Hello World":

$ mkdir myfirstweb
$ cd myfirstweb
$ nitrogen create helloworld
 Copy Nitrogen Static: "livevalidation.js"
 ...
 Creating file: "helloworld_app.erl"
$ ls
doc        ebin       Emakefile  Makefile   src        start.sh   wwwroot
$ cd src/pages/
$ ls
web_index.erl

接下来让我们编辑web_index.erl::

-module (web_index).
-include_lib ("nitrogen/include/wf.inc").
-compile(export_all).

main() ->
       #template { file="./wwwroot/template.html"}.

title() ->
       "hello world".

body() ->
   [
       #h1{text ="My First Nirogen Web"}，
       #panel{text = "Hello World"}
   ].


event(_) -> ok.

保存后，继续:

$ cd ../..
$ ./start.sh
Starting Nitrogen.
Erlang (BEAM) emulator version 5.6.5 [source] [async-threads:0] [hipe] [kernel-poll:false]

Eshell V5.6.5  (abort with ^G)
(nitrogen@localhost)1> Recompile: ./src/pages/web_index

--- Nitrogen is now running on inets. Serving files from: ./wwwroot. Open your browser to: http://localhost:8000 ---

启动浏览器，URL：http://localhost:8000/ 看到Hello World了吧。

7   更多阅读

http://medevyoujane.com.nyud.net/blog/2008/12/12/5-minute-blog-using-nitrogen-and-couchdb.html

http://nitrogenproject.com/