oox 0.2.0 → 0.3.0-beta1

package/rpc/http.class.js

@@ -1,312 +0,0 @@
-
-const http = require ( 'http' )
-
-const { parseHTTPBody, 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 = ''
-
-        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 ) {
-
-            context = Global.getContext ( )
-        }
-
-        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,231 +0,0 @@
-
-const { genOOXTrace } = require ( '../util' )
-
-const Context = require ( './context.class' )
-
-const HTTP = require ( './http.class' )
-
-const SocketIO = require ( './socketio.class' )
-
-const Global = require ( '../global' )
-
-const RPCInterface = require ( './rpc.interface.class' )
-
-const Middleware = require ( '../middleware' )
-
-
-
-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
-
-        this.emit ( 'request', action, params, context )
-
-        const format = {
-            traceId,
-            success: false
-        }
-
-        try {
-
-            const result = await this.execute ( this.kvMethods, 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 {
-
-            return format
-        }
-    }
-
-
-    /**
-     * 
-     * @param {Map<String,Function>} methods 服务函数扁平化列表
-     * @param {String} action
-     * @param {Array} params
-     * @param {Context} context
-     */
-    async execute ( methods, action, params, context ) {
-
-        const __proxy = '__proxy', _proxy = '_proxy'
-
-
-
-        // 目标函数
-        const target = methods.get ( action )
-
-        // 目标代理函数
-        const targetProxy = methods.get ( action + _proxy )
-
-        // 即不存在目标也不存在目标代理时, 报错函数不存在
-        if ( !target && !targetProxy ) throw new Error ( 'Invalid Action [' + action + ']' )
-
-        Global.asyncStore.enterWith ( context )
-
-
-
-        // 最顶层代理
-        const topProxy = methods.get ( __proxy )
-
-        if ( topProxy ) {
-
-            const proxyReturns = await topProxy ( action, params, context )
-
-            if ( proxyReturns !== undefined ) return proxyReturns
-        }
-
-
-
-        // 'x.y.z' => [ 'x', 'y', 'z' ]
-        const nameStack = action.split ( '.' ), size = nameStack.length - 1
-
-        let  index = -1, proxyPrefix = ''
-
-
-
-        // 根代理遍历
-        while ( ++index < size ) {
-
-            // x.
-            // x.y.
-            proxyPrefix += nameStack [ index ] + '.'
-
-            // x.__proxy
-            // x.y.__proxy
-            const rootProxy = methods.get ( proxyPrefix + __proxy )
-
-            // x.__proxy ( 'y.z', ... )
-            // x.y.__proxy ( 'z', ... )
-            if ( rootProxy ) {
-
-                const proxyReturns = await rootProxy ( nameStack.slice ( index ).join ( '.' ), params, context )
-
-                if ( proxyReturns !== undefined ) return proxyReturns
-            }
-        }
-
-
-
-        // 同级代理
-        const layerProxy = methods.get ( proxyPrefix + _proxy )
-
-        if ( layerProxy ) {
-
-            const proxyReturns = await layerProxy ( nameStack [ index ], params, context )
-
-            if ( proxyReturns !== undefined ) return proxyReturns
-        }
-
-
-
-        if ( targetProxy ) {
-
-            const proxyReturns = await targetProxy ( params, context )
-
-            if ( proxyReturns !== undefined ) return proxyReturns
-        }
-
-
-
-        // make sure target action execute after all proxies
-        if ( target ) {
-
-            const sourceMethod = Middleware.wrappedActions.get ( action )
-
-            const middlewareNames = Middleware.actionMiddlewares.get ( sourceMethod )
-
-            if ( middlewareNames && middlewareNames.length ) for ( const name of middlewareNames ) {
-
-                const middleware = Middleware.middlewares.get ( name )
-
-                await middleware ( action, params, context )
-            }
-            
-            return await target ( ...params )
-        }
-    }
-  
-}

package/rpc/rpc.interface.class.js

@@ -1,119 +0,0 @@
-
-const { EventEmitter } = require ( 'events' )
-
-const { genKVMethods, getIPAddress } = require ( '../util' )
-
-const Context = require ( './context.class' )
-
-const Config = require ( './config.class' )
-
-
-
-module.exports = class RPC extends EventEmitter {
-
-
-
-    /**
-     * refMethods => methods
-     */
-    refMethods = { }
-
-
-
-    /**
-     * the kvMethods is all actions refs
-     * @type {Map<String,Function>}
-     */
-    kvMethods = new Map ( )
-
-
-
-    set methods ( methods ) {
-
-        this.refMethods = methods
-
-        this.kvMethods.clear ( )
-
-        genKVMethods ( methods, this.kvMethods )
-    }
-
-
-
-    appendMethods ( methods ) {
-
-        genKVMethods ( methods, this.kvMethods )
-    }
-
-
-
-    get methods ( ) {
-
-        return this.refMethods
-    }
-
-
-
-    /**
-     * RPC Node Name
-     */
-    name = ''
-
-
-
-    config = new Config
-
-
-
-    /**
-     * new RPC service
-     * @param {*} methods 
-     */
-    constructor ( name, methods ) {
-        super ( )
-
-        this.name = name
-
-        if ( methods )
-        this.methods = methods
-
-        const [ host ] = getIPAddress ( 4 )
-
-        this.config.host = host
-
-        this.config.name = name
-    }
-
-
-
-    async serve ( ) { }
-
-
-
-    async stop ( ) { }
-
-
-
-    /**
-     * RPC事件监听
-     * @param {'request'|'success'|'fail'} event
-     * @param {(action: String, params: [], context: Context, result: {
-     * traceId: String,
-     * success: Boolean,
-     * body: any,
-     * error: Error
-     * } | Error) => void} listener
-     */
-    on ( event, listener ) {
-        return super.on ( event, listener )
-    }
-
-
-
-    /**
-     * 通用RPC调用方法
-     * @param {String} action 
-     * @param {[]} params 
-     * @param {Context} context 
-     */
-    async call ( action, params=[], context ) { }
-}