提供以WebSocket为通讯协议的缓存服务, 受到Redis启发.
docker run \
--detach \
--publish 8080:8080 \
blackglory/cache
git clone https://github.com/BlackGlory/cache
cd cache
yarn install
yarn build
yarn bundle
yarn --silent start
git clone https://github.com/BlackGlory/cache
cd cache
yarn install
yarn docker:build
version: '3.8'
services:
cache:
image: 'blackglory/cache'
restart: always
volumes:
- 'cache-data:/data'
ports:
- '8080:8080'
volumes:
cache-data:
interface INamespaceStats {
items: number
}
interface IItem {
value: JSONValue
metadata: IItemMetadata
}
interface IItemMetadata {
updatedAt: number
timeToLive: number | null
}
interface IAPI {
getAllNamespaces(): string[]
getAllItemKeys(namespace: string): string[]
getNamespaceStats(namespace: string): INamespaceStats
hasItem(namespace: string, itemKey: string): boolean
getItem(namespace: string, itemKey: string): IItem | null
getItemValue(namespace: string, itemKey: string): JSONValue | null
setItem(
namespace: string
, itemKey: string
, itemValue: JSONValue
, timeToLive: number | null /* ms */
): null
removeItem(namespace: string, itemKey: string): null
clearItemsByNamespace(namespace: string): null
}
通过环境变量CACHE_HOST
和CACHE_PORT
决定服务器监听的地址和端口,
默认值为localhost
和8080
.
通过环境变量CACHE_WS_HEARTBEAT_INTERVAL
可以设置WS心跳包(ping帧)的发送间隔, 单位为毫秒.
在默认情况下, 服务不会发送心跳包,
半开连接的检测依赖于服务端和客户端的运行平台的TCP Keepalive配置.
当CACHE_WS_HEARTBEAT_INTERVAL
大于零时,
服务会通过WS的ping帧按间隔发送心跳包.
发送SIGUSR1执行heapdump:
kill -SIGUSR1 {pid}
- JavaScript/TypeScript(Node.js, Browser): https://github.com/BlackGlory/cache-js