node-server是一个用node实现的web服务器，支持基本的反向代理、node开发后端应用。
node-server的配置文件位于conf目录下，是一个正常的node模块，config.demo.js为config的配置说明。
exports . config = { contexts :[ { path :'/' , //配置 docBase :[ '/workspace' //配置静态资源目录绝对地址 //{dir:'/workspace'} //以对象方式定义docBase //{dir:'/workspace',path:'/work'} 定义每个工作目录的path ] , port :8080 //port:[8080,8081] } ] } ; exports . config = { contexts :[ { ...proxy :{ protocol :null , pathRule :'^/api' , server :'192.168.1.100' , port :80 , headers :{ } } } ] } ; proxy:配置代理，为一个对象或是数组，如配置为数组，则会根据顺序选择满足pathRule规则的代理。
node-server会话默认是关闭的，当session配置有效时会启用会话，会话存储默认提供2中方式，文件会话存储于redis会话存储。
exports . config = { contexts :[ { ...session :{ provider :{ type :'file' , dataFile :'/data/log/session.data' } , timeout :30 } } ] } ; provider:会话提供者
exports . config = { contexts :[ { ...session :{ provider :{ type :'redis' , host :'127.0.0.1' , port :7050 , password :'' } , timeout :30 } } ] } ; host:配置redis主机地址
如果两种会话方式不满足实际需求，可对会话提供方式进行扩展，会话实现需要继承抽象类Session，会话提供者需要实现抽象类SessionProvider，然后在session/impl.json中进行配置即可。
node-server协议类型支持http|http2|https
exports . config = { contexts :[ { ...protocol :'http' } ] } ; protocol:定义协议类型，默认是http协议
exports . config = { contexts :[ { ...protocol :'https' , key :filePath . resolve ( 'conf/private.pem' ) , cert :filePath . resolve ( 'conf/file.crt' ) } ] } ; https协议需要配置私钥与证书路径
exports . config = { contexts :[ { ...protocol :'http2' , key :filePath . resolve ( 'conf/private.pem' ) , cert :filePath . resolve ( 'conf/file.crt' ) } ] } ; combo属性，当combo为true时允许请求多个静态资源 exports . config = { contexts :[ { ...combo :true } ] } ; //请求url格式 http://localhost??app/test.js,js/common.js //注意多个?(＞＝2)为识别符 如：http://localhost????app/test.js,js/common.js // http://localhost/app/comp??a.js,b.js,c.js exports . config = { contexts :[ { ...attributes :{ anonymous :false } } ] } ; attributes:定义上下文属性，可以通过config对象获取
/** * *@type {{logFilePath: string, multiProcess: boolean, contexts: *[]} } * * 服务器启动过程中会对context中配置进行解析，对每一个context的dir目录进行扫描，对controllers和filters字段设定的目录解析 * 生成映射规则和过滤器,默认值为controllers和filters * * context中字段配置说明 * dir 用户工作目录 * controllers 用户控制器逻辑,可根据目录路径生成请求路径和控制规则关系 * filters 用户过滤器，根据每个过滤器的priority字段决定调用次序 * path 上下文路径，此路径会比context.path优先使用 */ var filePath = require ( '../file/file-path' ) ; config = { debugMode :false , multiProcess :false , //是否对多个contexts启动多进程 contexts :[ { serverName :'x3 nodejs server' , //服务器名称 multiCpuSupport :false , //根据CPU数量,启动多个进程,配置为true时，需要配置为redis session zipResponse :true , //对输出进行压缩 protocol :null , //【optional default http】协议定义 sessionCookieName :null , //【optional】 sessionCookiePath :null , //【optional default /】 //protocol:'https', // 【default http】 //key:filePath.resolve('conf/private.pem'), // //cert:filePath.resolve('conf/file.crt'), // //serverOption:【optional default null】服务器创建时其他选项参数 //disabledAgentCache:true, //禁用客户端缓存 docBase :[ //服务器工作目录 { dir :'/' } , //{dir:'目录名称',controllers:'controllers',filters:'filters',path:'/'} '/workdpace' , { dir :'/' , path :'/ctx' } ] , //optional 不配置session时不会启用session session :{ provider :{ type :'file' , //会话持久化机制 dataFile :'/data/log/session.data' //会话文件 } , /* provider:{ type:'redis', host:'127.0.0.1' //port password }, */ timeout :30 , //会话过期时间，单位为分，默认30分钟 } , path :'/' , //上下文路径 port :[ 8080 ] , //服务器监听端口,可配置多个 attributes :{ anonymous :false } , //配置自定义属性 combo :true , //合并请求资源 proxy :{ protocol :null , //【optional default http】 协议定义 pathRule :null , //【required】配置需要代理url的匹配规则，为正则表达式字符串 server :'192.168.1.100' , //配置服务端IP port :80 , //【optional】配置服务端端口，如不配置则与请求端口一致 headers :{ } , //【optional】配置发送请求时需要添加的header url :null //【optional】配置重写url } } ] } ; 对于每个context会启动一个node子进程，每个进程是相对独立的。
request-response-wrapper 实现常用的接口调用
ControllerDispatcher 负责用户node程序接口的调用
node-server默认会解析用户工作目录下filters目录，并解析目录中js文件的filter
function loginFilter ( chain , request , response ) { //todo chain . next ( ) ; } loginFilter . priority = 1 ; //[optional] exports . execute = loginFilter filter文件是一个node模块，包含execute方法则被视为有效的filter，execute方法调用时会传入3个参数。
function getUsers ( request , response ) { var users = [ ] ; var result = JSON . stringify ( users ) ; response . outputContent ( result , 'application/json' ) ; } exports . users = getUsers ; //request url http://localhost/users //you can also change default url mapping rule function getBooks ( request response ) { var pathParams = request . pathParams ; var userId = pathParams . userId ; var books = [ ] ; var result = JSON . stringify ( books ) ; response . outputContent ( result , 'application/json' ) ; } getBooks . $mappingUrl = '/users/{userId}' exports . books = getBooks ; //request url http://localhost/users/123 server启动时会扫描用户工作目录下的controllers目录以及子目录js文件
每个controller也是一个node模块，exports中的每个方法对应controller的一个接口
var server = require ( 'nm-web-server' ) ; var config = { contexts :[ { ...} ] } ; server . startServer ( config ) ; Request
Session
Response