oox 0.0.9 → 0.3.0-beta1

package/global.class.js

@@ -1,124 +0,0 @@
-
-const { getTraceIdByStack } = require ( './util' )
-
-const Context = require ( './rpc/context.class' )
-
-const RPC = require ( './rpc/rpc.interface.class' )
-
-const Socket = require ( './socketio/socket.class' )
-
-const SetMap = require ( './setMap.class' )
-
-
-
-module.exports = class Global {
-
-
-
-    /**
-     * @type {[RPC]}
-     */
-    instances = [ ]
-
-
-
-    /**
-     * all contexts map
-     * @type {Map<String,Context>}
-     */
-    contexts = new Map ( )
-
-
-
-    /**
-     * @type {Map<String,Socket>}
-     */
-    sockets = new Map ( )
-
-
-
-    /**
-     * @type {SocketIOServer[]}
-     */
-    socketIOServers = [ ]
-
-
-
-    /**
-     * @type {Map<String,Set<Socket>>}
-     */
-    socketIORegistry = new SetMap
-
-
-
-    /**
-     * 生成随机不重复id
-     * @returns {String}
-     */
-    genTraceId ( ) {
-
-        const uid = [ 
-            Math.floor ( Date.now ( ) / 1000 ).toString ( 16 ),
-            Math.floor ( Math.random ( ) * 0xffffffff ).toString ( 16 ).padStart ( 8, '0' )
-        ]
-
-        return uid.join ( '' )
-    }
-
-
-
-    /**
-     * 获取链路跟踪上下文
-     * @param {Context} param0 
-     */
-    genContext ( { caller, callerId, traceId, ip, sourceIP } = { } ) {
-
-        const context = new Context ( )
-
-        if ( caller ) {
-
-            context.caller = caller
-        } else {
-
-            const primaryService = this.instances [ 0 ]
-
-            if ( primaryService ) context.caller = primaryService.name
-        }
-
-        context.traceId = traceId || this.genTraceId ( )
-        context.ip = ip
-        context.sourceIP = sourceIP || ip
-        context.callerId = callerId
-
-        return context
-    }
-
-
-
-    genContextByStack ( stack ) {
-
-        if ( !stack ) {
-
-            let trace = { }
-
-            Error.captureStackTrace ( trace )
-
-            stack = trace.stack
-        }
-
-        const traceId = getTraceIdByStack ( stack )
-
-        if ( traceId ) {
-
-            const sourceContext = this.contexts.get ( traceId )
-
-            if ( sourceContext ) {
-
-                return this.genContext ( { traceId, sourceIP: sourceContext.sourceIP } )
-            } else {
-
-                return this.genContext ( { traceId } )
-            }
-        } else return this.genContext ( )
-    }
-}

package/global.js

@@ -1,13 +0,0 @@
-
-if ( Error.stackTraceLimit < 20 ) Error.stackTraceLimit = 20
-
-const Global = require ( './global.class' )
-
-/**
- * @type {Global}
- */
-const oox = global.oox
-
-module.exports = oox || new Global
-
-global.oox = module.exports

package/rpc/config.class.js

@@ -1,48 +0,0 @@
-
-module.exports = class Config {
-
-
-
-    /**
-     * 服务名称
-     */
-    name = ''
-
-
-
-    /**
-     * 主机地址列表
-     */
-    host = ''
-
-
-
-    /**
-     * 跨域处理
-     */
-    origin = null
-
-
-
-    /**
-     * 网关地址
-     */
-    gateway = {
-
-
-
-        /**
-         * http 网关地址
-         * @type {{port:Number,path:String}}
-         */
-        http: null,
-
-
-
-        /**
-         * socketio 网关地址
-         * @type {{port:Number,path:String}}
-         */
-        socketio: null
-    }
-}

package/rpc/context.class.js

@@ -1,15 +0,0 @@
-
-
-module.exports = class Context {
-
-    // 请求溯源IP
-    sourceIP = ''
-    // 请求者IP
-    ip = ''
-    // 请求溯源ID
-    traceId = ''
-    // 请求者名称
-    caller = ''
-    // 请求者ID (长连接专用)
-    callerId = ''
-}

package/rpc/http.class.js

@@ -1,327 +0,0 @@
-
-const http = require ( 'http' )
-
-const { parseHTTPBody, getTraceIdByStack, getIPAddress, httpRequest } = require ( '../util' )
-
-const Context = require ( './context.class' )
-
-const RPC = require ( './rpc.interface.class' )
-
-const Global = require ( '../global' )
-
-
-
-module.exports = class HTTPModule {
-
-
-
-    /**
-     * @type {RPC}
-     */
-    rpc = null
-
-
-
-    /**
-     * listen port
-     */
-    port = 0
-
-
-
-    /**
-     * socket.io service path
-     */
-    path = '/'
-
-
-
-    /**
-     * @param {{port:Number, path:String}} config
-     */
-    set config ( config ) {
-
-        if ( !config ) return this.rpc.config.gateway.http = null
-
-        config = this.rpc.config.gateway.http = Object.assign ( this.config || { }, config )
-
-        this.port = config.port || 0
-
-        if ( config.path ) this.path = config.path
-        else config.path = this.path
-    }
-
-
-
-    get config ( ) {
-
-        return this.rpc.config.gateway.http
-    }
-
-
-
-    /**
-     * @type {http.Server}
-     */
-    server = null
-
-
-
-    /**
-     * 
-     * @param {RPC} rpc 
-     */
-    constructor ( rpc ) {
-
-        this.rpc = rpc
-    }
-
-
-
-    /**
-     * start http service
-     * @returns {http.Server}
-     */
-    async serve ( ) {
-
-        await this.stop ( )
-
-        const config = this.config
-
-        if ( !config ) return
-
-        const { port } = config
-
-        const isRndPort = 'number' !== typeof port || port === 0
-
-        const server = 
-        this.server = http.createServer ( this.call.bind ( this ) )
-
-        server.listen ( isRndPort ? 0 : port )
-
-        config.port = server.address ( ).port
-        config.path = this.path
-
-        return server
-    }
-
-
-
-    /**
-     * stop http service
-     */
-    stop ( ) {
-
-        if ( this.server && this.server.listening )
-        return new Promise ( ( resolve, reject ) => {
-
-            this.server.close ( function ( error ) {
-
-                if ( error ) reject ( error ) 
-                else resolve ( )
-            } )
-        } )
-    }
-
-
-
-    /**
-     * CORS
-     * @param {http.IncomingMessage} request 
-     * @param {http.ServerResponse} response 
-     */
-    cors ( request, response ) {
-
-        // origin checking
-        if ( this.rpc.config.origin ) {
-
-            const origin = this.rpc.config.origin
-
-            const requestOrigin = request.headers.origin
-
-            if ( origin === '*' ) {
-
-                response.setHeader ( 'Access-Control-Allow-Origin', '*' )
-            } else if ( origin === requestOrigin || Array.isArray ( origin ) && origin.includes ( requestOrigin ) ) {
-
-                response.setHeader ( 'Access-Control-Allow-Origin', requestOrigin )
-
-                response.setHeader ( 'Vary', 'Origin' )
-            } else {
-
-                response.statusCode = 403
-
-                response.end ( )
-
-                return false
-            }
-
-            response.setHeader ( 'Access-Control-Max-Age', 3600 )
-            response.setHeader ( 'Access-Control-Allow-Headers', 'x-caller,content-type' )
-            response.setHeader ( 'Access-Control-Allow-Methods', 'POST' )
-        }
-
-        if ( request.method === 'OPTIONS' ) {
-
-            response.statusCode = 204
-
-            response.end ( )
-
-            return false
-        }
-
-        return true
-    }
-
-
-
-    /**
-     * HTTP-RPC服务器请求监听方法
-     * @param {http.IncomingMessage} request 
-     * @param {http.ServerResponse} response 
-     */
-    async call ( request, response ) {
-
-        if ( request.url !== this.path ) {
-
-            return this.respond ( request, response, new Error ( 'URL Incorrect' ) )
-        }
-
-        if ( !this.cors ( request, response ) ) return
-
-        let body = Object.create ( null )
-
-        try {
-
-            body = await parseHTTPBody ( request )
-
-            if ( !body || 'object' !== typeof body ) throw new Error ( 'Content Invalid' )
-
-        } catch ( error ) {
-
-            return this.respond ( request, response, error )
-        }
-
-        // global unique id
-        const traceId = request.headers [ 'x-trace-id' ]
-
-        // service name, required
-        const caller = request.headers [ 'x-caller' ] || 'anonymous'
-
-        // client ip or caller service ip
-        const ip = request.headers [ 'x-ip' ] || request.socket.remoteAddress
-
-        // startup client ip
-        const sourceIP = request.headers [ 'x-real-ip' ]
-
-        const { action, params = [ ] } = body
-
-        const context = Global.genContext ( { traceId, caller, sourceIP, ip } )
-
-        const format = await this.rpc.call ( action, params, context )
-
-        this.respond ( request, response, format )
-    }
-
-
-
-    /**
-     * HTTP Response Catch
-     * @param {http.IncomingMessage} request 
-     * @param {http.ServerResponse} response 
-     * @param {Object} format 
-     * @param {Boolean} format.success
-     * @param {Error} format.error
-     * @param {any} format.body
-     */
-    respond ( request, response, format ) {
-
-        let formatString = ''
-
-        if ( format instanceof Error ) {
-
-            format = {
-                success: false,
-                error: {
-                    message: format.message,
-                    stack: format.stack
-                }
-            }
-        }
-
-        try {
-
-            formatString = JSON.stringify ( format )
-        } catch ( { message, stack } ) {
-
-            delete format.body
-
-            format.success = false
-
-            format.error = {
-                message,
-                stack
-            }
-
-            formatString = JSON.stringify ( format )
-        }
-
-        response.setHeader ( 'Content-Type', 'application/json' )
-
-        response.setHeader ( 'Content-Length', Buffer.byteLength ( formatString ) )
-
-        response.end ( formatString )
-    }
-
-
-
-    /**
-     * HTTP RPC
-     * @param {String|URL|http.RequestOptions} url
-     * @param {String} action 函数名称
-     * @param {Array} params 参数列表
-     * @param {Context} context 上下文
-     */
-    static async call ( url, action, params, context ) {
-
-        if ( !context || !context.traceId ) {
-
-            let trace = { }
-
-            Error.captureStackTrace ( trace )
-
-            context = Global.genContextByStack ( trace.stack )
-        }
-
-        const { traceId, caller, sourceIP } = context
-
-        const headers = {
-            'Content-Type': 'application/json',
-            'x-trace-id': String ( traceId ),
-        }
-
-        if ( caller ) headers [ 'x-caller' ] = String ( caller )
-
-        if ( sourceIP ) headers [ 'x-real-ip' ] = sourceIP
-
-        headers [ 'x-ip' ] = getIPAddress ( 4 ) [ 0 ]
-
-        const format = await httpRequest ( url, {
-            headers
-        }, JSON.stringify ( { action, params } ) )
-
-        if ( 'string' === typeof format ) throw new Error ( format )
-
-        const { error, body } = format
-
-        if ( error ) {
-
-            const asyncError = new Error ( error.message )
-
-            throw asyncError
-        } else {
-
-            return body
-        }
-    }
-}

package/rpc/rpc.class.js

@@ -1,130 +0,0 @@
-
-const { genOOXTrace } = require ( '../util' )
-
-const Context = require ( './context.class' )
-
-if ( Error.stackTraceLimit < 20 ) Error.stackTraceLimit = 20
-
-const HTTP = require ( './http.class' )
-
-const SocketIO = require ( './socketio.class' )
-
-const Global = require ( '../global' )
-
-const RPCInterface = require ( './rpc.interface.class' )
-
-
-
-module.exports = class RPC extends RPCInterface {
-
-    static Context = Context
-
-    static HTTP = HTTP
-    static SocketIO = SocketIO
-
-
-
-    /**
-     * @type {HTTP}
-     */
-    http = new this.constructor.HTTP ( this )
-
-
-
-    /**
-     * @type {SocketIO}
-     */
-    socketio = new this.constructor.SocketIO ( this )
-
-
-
-    /**
-     * new RPC service
-     * @param {*} methods 
-     */
-    constructor ( name, methods ) {
-        super ( name, methods )
-
-        Global.instances.push ( this )
-    }
-
-
-
-    async serve ( ) {
-
-        let isShareServer = false
-
-        if ( this.http.config && this.socketio.config ) {
-
-            isShareServer = !this.http.config.port && !this.socketio.config.port
-
-            isShareServer |= this.http.config.port === this.socketio.config.port
-        }
-
-        await this.http.serve ( )
-
-        if ( isShareServer ) this.socketio.server = this.http.server
-
-        await this.socketio.serve ( )
-    }
-
-
-
-    async stop ( ) {
-
-        await this.http.stop ( )
-        await this.socketio.stop ( )
-    }
-
-
-
-    /**
-     * 通用RPC调用方法
-     * @param {String} action 
-     * @param {[]} params 
-     * @param {Context} context 
-     */
-    async call ( action, params=[], context ) {
-
-        if ( !Array.isArray ( params ) ) params = [ params ]
-
-        const { traceId } = context
-
-        Global.contexts.set ( traceId, context )
-
-        this.emit ( 'request', action, params, context )
-
-        const format = {
-            traceId,
-            success: false
-        }
-
-        const OOXTrace = genOOXTrace ( traceId, this.kvMethods )
-
-        try {
-
-            const result = await OOXTrace [ traceId ] ( action, [ ...params ], context )
-
-            format.body = result
-
-            format.success = true
-
-            this.emit ( 'success', action, params, context, result )
-        } catch ( error ) {
-
-            format.error = {
-            message: error.message,
-            stack: error.stack
-            }
-
-            this.emit ( 'fail', action, params, context, error )
-        } finally {
-
-            delete OOXTrace [ traceId ]
-
-            Global.contexts.delete ( traceId )
-
-            return format
-        }
-    }
-}