Use uWebSockets like http-server in Nodejs
- Very tiny, only use uWebSocket do Micro Service;
- Client use
ws.fetch(uri)call server router files; - Easy extends options in router;
- Use very fast Log system, use pino;
- Auto reconnet WebSocket;
- Long time auto close WebSocket;
- Like Serral in StarCraft2, simple and direct powerful.
Look Demo
This way is easy run example, just copy this code in your Terminal:
git clone -b master --single-branch https://github.com/ymzuiku/serral
cd serral
yarn install && clear
node example/serve.js & sleep 0.5 && open example/client.html
Waiting git clone and npm install , if server runing, look Terminal and Browser like this:
The Web is at 30ms emit socket server;
Install
$ npm i --save serral
# or
$ yarn add -D serral
Get Started
You can look example/serve.js and example/client.html
In client:
If you use React or Vue, add code in src/index.js
import serralClient from 'serral/client';
const ws = serralClient('ws://127.0.0.1:4000');
ws.onopen = function() {
ws.fetch(
'hello',
{
name: 'client: hello-server',
age: 200,
},
res => {
console.log('catch-server-message:', res);
},
);
};In server:
server/index.js
const serral = require('serral');
const path = require('path');
// auto load routers/xxx.js and router/xxx/index.js;
// ignore underline begins files, like: _xxx.js
serral.load(path.resolve(__dirname, 'routers'));
serral.listen(4000);server/routers/hello.js
module.exports = function(data, ws) {
console.log(data);
// if set uri, client can run wsCallback[uri] function
ws.json({ uri:data.uri, name: 'server:hello-client', age: 100 });
};Run serve:
node server/index.jsLoad routers rule:
Use serral.load('dir-path'), serral can auto load files in directory:
- If file return a
function, serral use the file name like router path. - If file return a
{ obj }, serral use file.objName.objName... until obj is function - If the 'file' is Directory, serral use require(file/index.js)
- Ignore underline begins files, like: _xxx.js
This's example:
Server
server/index.js
const serral = require('serral');
const path = require('path');
serral.load(path.resolve(__dirname, 'routers'));
serral.listen(4000);server/routers/login.js
module.exports = {
// In client: ws.fetch('login.useEmail');
useEmail: function(data, ws, opts) {
// ws.json({ uri:data.uri, ...})
},
sendEmail: {
// In client: ws.fetch('login.sendEmail.changePassword');
changePassword: function(data, ws, opts) {
// ws.json({ uri:data.uri, ...})
},
bindEmail: {
// In client: ws.fetch('login.sendEmail.bindEmail.bindNow');
bindNow: function(data, ws, opts) {
// ws.json({ uri:data.uri, ...})
},
},
},
};Client
import serralClient from 'serral/client';
const ws = serralClient('ws://127.0.0.1:4000');
ws.onopen = function() {
// load server routers/login.js function
ws.fetch('login.useEmail');
ws.fetch('login.sendEmail.changePassword');
ws.fetch('login.sendEmail.bindEmail.bindNow');
};Extends: If use mysql or other package
Server:
server/index.js
const serral = require('../serve');
const Sequelize = require('sequelize');
const { resolve } = require('path');
const sequelize = new Sequelize('test', 'root', '111Asd', { dialect: 'mysql' });
sequelize.authenticate();
// Extends { db: sequelize } to opts
serral.use({ db: sequelize });
// serral.use() need before serral.load()
serral.load(resolve(__dirname, 'routers'));
serral.listen(4000);server/routers/hello.js
// sequelize is extends in opts
module.exports = function(data, ws, opts) {
console.log(opts); // { db: sequelize }
// use opts.db do someting
};Use local log files
If you set logPath, log save in local file, use pino
const serral = require('../serve');
const path = require('path');
// need ensure the existence of logPath
serral.use({ logPath: path.resolve(__dirname, 'logs') });
// serral.use() need before serral.load()
serral.load(path.resolve(__dirname, 'routers'));
serral.listen(4000);Use WebSocket replace to uWebSockets
serral default use uWebSockets, but it's remove in npm.org. serral keep use [email protected]. if you need use WebSocket replace to uWebSockets, you can use lib: 'ws' :
const serral = require('../serve');
const path = require('path');
serral.use({ lib: 'ws' });
serral.load(path.resolve(__dirname, 'routers'));
serral.listen(4000);API setting live
Licenes
MIT License
Copyright (c) 2013-present, Facebook, Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent