基于HTTP协议的轻量级开源简单队列服务:HTTPSQS [转张宴]


httpsq 

ulimit -SHn 65535

wget http://httpsqs.googlecode.com/files/libevent-1.4.13-stable.tar.gz
tar zxvf libevent-1.4.13-stable.tar.gz
cd libevent-1.4.13-stable/
./configure –prefix=/usr
make
make install
cd ../

wget http://httpsqs.googlecode.com/files/tokyocabinet-1.4.41.tar.gz
tar zxvf tokyocabinet-1.4.41.tar.gz
cd tokyocabinet-1.4.41/
./configure
#注:在32位Linux操作系统上编译Tokyo cabinet,请使用./configure –enable-off64代替./configure,可以使数据库文件突破2GB的限制。
#./configure –enable-off64
make
make install
cd ../

/sbin/ldconfig

wget http://httpsqs.googlecode.com/files/httpsqs-1.1.tar.gz
tar zxvf httpsqs-1.1.tar.gz
cd httpsqs-1.1/
make
make install
cd ../

 [root@xoyo ~]# httpsqs -h

-l <ip_addr> 监听的IP地址,默认值为 0.0.0.0
-p <num> 监听的TCP端口(默认值:1218)
-x <path> 数据库目录,目录不存在会自动创建(例如:/opt/httpsqs/data)
-t <second> HTTP请求的超时时间(默认值:1)
-d 以守护进程运行
-h 显示这个帮助

  示例:

ulimit -SHn 65535
httpsqs -d -p 1218 -x /data0/search/queue

  请使用命令“killall httpsqs”、“pkill httpsqs”和“kill httpsqs的进程ID”来停止httpsqs。

  注意:请不要使用命令“pkill -9 httpsqs”和“kill -9  httpsqs的进程ID”来结束httpsqs,否则,内存中尚未保存到磁盘的数据将会丢失。


  5、HTTPSQS 客户端使用文档:

  (1)、入队列(将文本消息放入队列):

  HTTP GET 协议(以curl命令为例):

curl “http://host:port/?name=your_queue_name&opt=put&data=经过URL编码的文本消息”

  HTTP POST 协议(以curl命令为例):

curl -d “经过URL编码的文本消息” http://host:port/?name=your_queue_name&opt=put

  如果入队列成功,返回:

HTTPSQS_PUT_OK

  如果入队列失败,返回:

HTTPSQS_PUT_ERROR

  (2)、出队列(从队列中取出文本消息):

  HTTP GET 协议(以curl命令为例):

curl “http://host:port/?charset=utf-8&name=your_queue_name&opt=get”

curl http://host:port/?charset=gb2312&name=your_queue_name&opt=get

  返回消息队列的内容给客户端。如果没有未取出的消息队列,则返回:
HTTPSQS_GET_END
  参数charset说明(例如:/?charset=utf-8):
  指定HTTP输出Header头的字符编码,即:
  Content-Type: text/plain; charset=utf-8

  任何在IANA注册的字符编码均可使用,但是,并不是所有的浏览器都能解析全部的字符编码。对于中文,常用的字符编码有:utf-8、gb2312、gbk、gb18030、big5等。


  (3)、查看队列状态:

  HTTP GET 协议(以curl命令为例):

curl http://host:port/?name=your_queue_name&opt=status

  返回(示例):

HTTP Simple Queue Service v1.0
——————————
Queue Name: xoyo
Maximum number of queues: 1000000
Put position of queue (1st lap): 45
Get position of queue (1st lap): 6
Number of unread queue: 39

  如果“队列写入点值”大于“最大队列数量值”,将重置“队列写入点”为1,即又从1开始存储新的队列内容,覆盖原来队列位置点的内容:
HTTP Simple Queue Service v1.0
——————————
Queue Name: xoyo
Maximum number of queues: 1000000
Put position of queue (2st lap): 4562
Get position of queue (1st lap): 900045
Number of unread queue: 104517


  (4)、查看指定队列位置点的内容:

  跟一般的队列系统不同的是,HTTPSQS 可以查看指定队列ID(队列点)的内容,包括未出、已出的队列内容。可以方便地观测进入队列的内容是否正确。

  另外,假设有一个发送手机短信的队列,由客户端守护进程从队列中取出信息,并调用“短信网关接口”发送短信。但是,如果某段时间“短信网关接口”有故障,而这段时间队列位置点300~900的信息已经出队列,但是发送短信失败,我们还可以在位置点300~900被覆盖前,查看到这些位置点的内容,作相应的处理。

  HTTP GET 协议(以curl命令为例):

curl “http://host:port/?charset=utf-8&name=your_queue_name&opt=view&pos=5″

curl http://host:port/?charset=gb2312&name=your_queue_name&opt=view&pos=19

  pos >=1 并且 <= 1000000000

  返回指定队列位置点的内容。


  (5)、重置指定队列:

  HTTP GET 协议(以curl命令为例):

curl http://host:port/?name=your_queue_name&opt=reset

  如果重置成功,返回:

HTTPSQS_RESET_OK

  如果重置失败,返回:

HTTPSQS_RESET_ERROR


  (6)、更改指定队列的最大队列数量:

  默认的最大队列长度(100万条):1000000

  HTTP GET 协议(以curl命令为例):

curl http://host:port/?name=your_queue_name&opt=maxqueue&num=1000000000

  num >=10 并且 <= 1000000000

  如果更改最大队列数量成功,则返回:

HTTPSQS_MAXQUEUE_OK

  更改的最大队列数量必须大于当前的“队列写入点”。另外,当“队列写入点”小于“队列读取点”时(即PUT位于圆环的第二圈,而GET位于圆环的第一圈时),本操作将被取消,然而返回给客户端以下信息:
HTTPSQS_MAXQUEUE_CANCEL


  (7)、全局错误:

  如果发送全局错误(即指令、参数错误等),将返回以下信息:

HTTPSQS_ERROR
  1. No comments yet.
(will not be published)
  1. No trackbacks yet.