forum
Version:
126 lines (80 loc) • 3.01 kB
Markdown
#### 眼下放到测试服务器，所以感觉很慢，5月份上正式服务器。
快速运行
=======
##### 安装
npm install forum
##### 启动程序
例如 run.js
```
var app = require("forum")({
admin_email:"xxxxx@xxx.xxx" // 这个是管理员email，当你第一次用这个邮箱注册，你就成为超级管理员。
});
app.listen(3000);
```
运行 node run.js 即可运行。
论坛模块概念
==========
`core` 是核心对象，实现了全部论坛功能。通过调用 core.exec / core.call 方法对系统进行操作。
`controller控制器` 是服务于UI的中间层，介于core核心和UI之间，提供了权限控制、UI所需数据、验证码等。
`query查询` 是个从数据库或文件系统得到数据的组件，可以自己定制，但必须符合相应接口。
query是core核心层、控制器、UI都可调用的组建，它屏蔽的具体数据库，达到切换各种数据库的接口。
`view 动态页` 是依赖控制器的。
定义查询组件
==========
查询query，是应用程序与数据库之间的桥梁，用于获取数据。 我们知道查询在任何一个系统中都至关重要，所以要如何发挥其规范性是至关重要的环节；
另外如何能不依赖特定数据库，这个问题也是值得深思，为了做到这一点，我们需要特殊的方式。
#### 定义query
```
// 第一种查询组件定义方式
var query = require("query-brighthas");
// 添加一个查询
query
.add(
"get a user", // 查询名称
["id",{require:true}], // 限定查询参数, 表示必须要提供一个id，如果不提供会得到一个 callback(null)
function(args,callback){ // 查询函数, 最终返回一个值，只能赋予一个参数。
......
callback(xxx)
})
.add(
"all users",
function(args,callback){
......
callback(xxx)
})
```
```
// 其他查询组件定义方式
var query = {
// 第二种方式，args参数没有被限定，需要函数自己处理
"find a user":function(args,callback){
},
// 第三种方式，和第一种方式一样，只不过形式不同而已.
"find a user":{
args:{
"id":{require:true}
},
handle:function(args,handle){
}
},
// 第四种方式，和第一种方式一样，只不过形式不同而已.
"find a user":{
args:["id",{require:true}], // 和第三种参数限制一样，形式不同而已。
handle:function(args,handle){
}
}
}
#### 调用一个查询
// 第一种调用方式
query("get a user",{id:"001"},function(result){
... ...
})
// 第二种调用方式，效果和第一种方式等效，不过形式不同。
// 第二种方式返回一个 promise ，推荐这种调用方式，好处大家都知道。
query("get a user",{id:"001"}).then(function(result){
... ...
})
```
LICENSE
=======
GPLv3