OPQ
An Open sourced Persistent message Queue
Code is tested under go1.4.2, higher version should be OK (CAUTION: OPQ hasn't been tested in production environment so far)
Features
persistent message storage
push model - push message to target service and block when failure
easy to use - simple API whith HTTP POST method, no addtional client integration is required
message replay
high performance aimed
operations-friendly - graceful stop/restart, HA (TODO)
Performance
over 20,000(Message/Second) with 2K(Byte) message payload
over 30,000(Message/Second) with 1K(Byte) message payload
Install
Download source code
go get -u github.com/LevinLin/OPQ
Build OPQ
cd /path/to/OPQ
go build
Run OPQ
cd /path/to/OPQ
nohup ./OPQ &>/dev/null &
-debug
System runs in debug model when given debug=yes, which will enable
log/output in debug level, default to no
-port
Listening port, default to 8999
-syslog
System log name, default to system.log
-admin
Enable admin portal when given admin=yes, default to no (TODO, not
available yet)
Gracefully restart OPQ
kill -1 %{PID}
Usage
Push Message
url:
http://%{SERVER_NAME}[:%{SERVER_PORT}]/opq/push
post fields:
url: target url
topic: each message should belong to a topic
message: message content
header: specify the header if you need
example:(PHP)
$url = "http://localhost:8999/opq/push";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
$data = array(
'url' => 'http://127.0.0.1/Comment/addComment?comment=nny&user=q18',
'topic'=> 'comment',
'message'=> 'this is message body',
);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
var_dump($response);
curl_close($ch);
Replay Message
url:
http://%{SERVER_NAME}[:%{SERVER_PORT}]/opq/replay
post fields:
topic: topic name
cmd: commond number (message index, start from 0)
example:(PHP)
$url = "http://localhost:8999/opq/replay";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
$data = array(
'topic'=> 'comment',
'cmd'=> '30',
);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
var_dump($response);
curl_close($ch);