Skip to content

NetEase/pomelo-status-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pomelo-status-plugin

pomelo-status-plugin is a plugin for pomelo, it can be used in pomelo(>=0.6).

pomelo-status-plugin provides global status service for pomelo, which uses persistent storage to save users information.

##Installation

npm install pomelo-status-plugin

##Usage

var status = require('pomelo-status-plugin');

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379
}});

##API

###getSidsByUid(uid, cb) get frontend server id by user id ####Arguments

  • uid - user id
  • cb - callback function

####Return

  • err - error
  • list - array of frontend server ids

###getStatusByUid(uid, cb) ####Arguments

  • uid - user id
  • cb - callback function

####Return

  • err - error
  • status - boolean, true if user is online (at least one session with a frontend) or false otherwise

###getStatusByUids(uids, cb) ####Arguments

  • uids - array of user ids
  • cb - callback function

####Return

  • err - error
  • statuses - object with uid as keys and boolean as value, true if user is online (at least one session with a frontend) or false otherwise

###pushByUids(uids, route, msg, cb) ####Arguments

  • uids - array of user ids
  • route - route string
  • msg - messages would be sent to clients
  • cb - callback function

####Return

  • err - error
  • fails - array of failed to send user ids

##Notice

status plugin use redis as a default persistent storage, you can change it with your own implementation.

var status = require('pomelo-status-plugin');
var mysqlStatusManager = require('./mysqlStatusManager');

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379,
  channelManager: mysqlStatusManager
}});

in >=0.0.3 version add cleanOnStartUp option, when you enable this option, status plugin would clean up the old data with the given prefix string.

app.use(status, {status: {
  host: '127.0.0.1',
  port: 6379,
  cleanOnStartUp: true
}});