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

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

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

before函数提供了一种机制，可以在文件接收之前根据req.headers对文件进行验证(如大小、类型)，return true 表示验证通并开始接收文件。在这里 before 中的回调函数会根据 req.headers 中的 content-length 判断上传的文件是否超出了尺寸限制（开发人员可以通过修改 if 语句中的常数改变文件上传尺寸上限，content-length 单位为 byte，1024 * 1024 即代表 1 MB），如果超出了，文件不会被上传，服务器返回错误信息；如果没有超出，函数返回值为 true，服务器继续执行 app.file 中的回调函数，将文件从临时地址转移到指定存储地址，文件上传到这里就完成了。  

OnceIO 的模块路由和模板注入机制是与其它Web框架最主要的区别之一。软件系统时常需要针对不同的客户定制不同的功能。OnceIO的模块路由可以通过一个扩展包，对系统原有模板(Template)和填充数据(Model)进行重定向或复写。可以在不更改系统源代码的情况下，以非侵入的方式对系统进行深度定制和扩展。

OnceIO是OnceDoc企业网盘的底层Web框架。可以对Web应用进行分布式模块化存储，并基于模块路由对http请求进行重定向。这样模块的前端、后端和数据库定义就可以集中存储在一个扩展包里，每一个扩展包都是一个功能独立的应用，只需通过添加/删除文件夹的方式就可实现功能删减，从而实现功能模块的自由组装。正是因为OnceIO的这种模块化机制，才可以让OnceDoc有能力扩展成邮箱、流程管理、分享社区、资产管理、商城等系统。这篇文章主要介绍如何开发一个简单的OnceIO模块，以及资源文件的模块路由规则。

本节主要介绍表单提交过程中，应用Filter工具箱实现表单内容验证与返回。并以app.validate和app.handle两个函数为例，展示表单与后台服务器信息交互过程。

app.validate: 在表单提交前对用户输入合法性做校验，返回错误信息则表示不合法
app.handle: 在表单提交后，对服务返回的信息做响应

服务器处理时间序列如下图所示：

在OnceVI中，您可以通过对相应svg模板进行绑定，实现表格信息的提交与保存。

以网站登录系统模板为例（见下图），在界面左侧选择，模板上添加输入框，并进行数据绑定。

企业管理软件在报表的应用上有大量需求，也存在大量困扰。OnceVI是一款使用Web和H5技术打造的前后端分离的报表开发工具。OnceVI支持直接在SVG矢量图上绑定数据，并通过JSON数据格式将后台数据呈现到前端报表界面。开发者可使用任何编程语言来编写JSON数据服务，OnceVI使用内存数据库来缓存数据，使用者不再需要考虑高并发下的性能问题。

OnceVI的可视化报表支持打印和手机浏览。几乎目前比较主流的浏览器，如Chrome等均支持将网页打印成PDF，我们为打印设计了一些特殊样式，确保只有报表本身会被打印。Chrome还提供了打印份数，打印布局(包含纵向和横向)，打印色彩(彩色和黑白色)等设置。 

OnceDoc是一个高性能的、高度独立的企业内容（网盘）管理系统，底层技术完全自主实现。你仅需预先安装好NodeJS的运行环境，无需配置例如IIS、Tomcat、MySQL/SQLServer、环境变量之类的复杂依赖，解压即用。不需要您具备任何IT知识,，30秒即可完成安装，打造专属于您自己的网盘和在线文档编辑工具。

OnceIO 提供将一个网页文件嵌套在另一个网页文件中的机制。文件嵌套与模板引擎无关，语法固定为 。

使用网页嵌套时，服务器需要时间加载所有被嵌套网页，因此用户第一次访问时浏览器可能无法显示被嵌套网页的内容，刷新后才能显示完整网页，OnceIO 内置的 preload 方法能解决这个问题。对当前目录下的 html 后缀的文件使用 preload 的示例代码如下：