OnceIO是OnceDoc系统的底层Web框架，它可以实现模板文件、静态文件的全缓存，运行起来完全不需要I/O操作，并且支持客户端缓存优化，GZIP压缩等（只在第一次压缩），拥有非常好的性能，为您节约服务器成本。它可以让你对Web进行分布式存储，即一个扩展包里即可包含前端、后端和数据库定义，只需通过添加/删除目录的方式就可实现功能删减，实现真正的模块化扩展。这里是介绍如何使用OnceIO的一系列文章。

OnceIO 是一个自身功能极简，完全由路由、中间件和Handler构成的 web 开发框架：一个 OnceIO 应用本质上就是在调用各种中间件和Handler。  

中间件是一个函数，它可以访问请求对象（request object (req)）, 响应对象（response object (res)），并将应用的请求-响应循环传向下一个中间件。

一个应用的请求-响应循环如下图所示，由请求对象、响应对象、中间件和 handler 构成：

Handler 针对请求发出响应，循环终结于此，一个请求-响应循环只会由一个 handler处理；但每个请求在到达 handler 之前会依次经过许多中间件，如Session、Securty(登录认证)、表单解析等都是典型的中间件，NoceJS中的MiddlerWare与Java中的Filter和.NET中的HttpModule概念类似。一个请求-响应循环也可以不经过中间件，比如说静态CSS/JS文件就没有执行Session、认证中间件的必要。

中间件的功能包括：

• 执行任何代码。
• 修改请求和响应对象。
• 终结请求-响应循环。
• 调用堆栈中的下一个中间件。

如果当前中间件没有终结请求-响应循环，则必须调用 req.filter.next() 将控制权交给下一个中间件，否则请求就会挂起。

下面我们将以 Lesson 1 中简单的 'Hello World' 应用为例，为其增加两个中间件：能在终端输出一条简单消息的 myLogger 和能在网页上显示 HTTP 请求的时间戳的 requestTime.

var onceio = require('../onceio/onceio')
var app = onceio()


app.get('/', function(req, res) {
  res.end('Hello World!')
})

中间件函数 myLogger

myLogger 函数会在 request 经过它时在 console 界面输出“LOGGED”。myLogger 函数的代码如下：

var myLogger = function(req, res) {
  console.log('LOGGED')
  req.filter.next()
}

//or

var myLogger = function(req, res, next) {
 console.log('LOGGED')
 next()
}

把 myLogger 添加到应用中：

var onceio = require('../onceio/onceio')
var app = onceio()


var myLogger = function(req, res) {
  console.log('LOGGED')
  req.filter.next()
}

app.use(myLogger)

app.get('/', function(req, res) {
  res.end('Hello World!')
})  

每当应用收到请求时，它都会在终端输出“LOGGED”：

中间件的加载顺序很重要：中间件必须要被首先加载并且被首先执行，否则在请求到达中间件之前请求-响应循环就被终止了，中间件将不被执行。

中间件函数 requestTime

接下来，我们创建一个叫做 requestTime 的中间件函数：

var requestTime = function(req, res) {
  req.requestTime = Date.now()
  req.filter.next()
}  

把 requestTime 添加到应用中：

var onceio = require('../onceio/onceio')
var app = onceio()


var requestTime = function(req, res) {
  req.requestTime = Date.now()
  req.filter.next()
}

app.use(requestTime)

app.get('/', function(req, res) {
  var responseText = 'Hello World!<br>';
  responseText += '<small>Requested at: ' + req.requestTime + '</small>';
  res.send(responseText);
})  

每当应用收到请求时，它都会在浏览器显示请求的时间戳：

我们在这里只演示了两个简单的中间件，事实上中间件的种类和功能非常多样，例如，app.use() 函数可以有多达三个参数：

app.use('/file', function(req, res) {
   var user = req.session.get('user')
   if (!user || !user.username) {
     res.end('No permission')
     return
   }

   res.cache(0)
   req.filter.next()

}, { session: true })

其中第一个参数指定所有以“/file”开头的 URL（发起的请求）都会经过这个中间件；第三个参数指定这个中间件需要session支持。因为onceio的session对象可能是存放在数据库中的，从数据库获取session会有一定的性能损失，所以在设计时您可根据情况，比如说在用户界面、管理后台添加session解析支持。

中间件能访问请求对象、响应对象、堆栈中下一个中间件和整个 OnceIO API，因此它的用法拥有无限的可能性。

OnceIO地址：  https://github.com/OnceDoc/onceio