kzcloud / xhttpcache Goto Github PK

##xhttpcache是什么？ xhttpcache 是一个HTTP静态缓存服务，也可以做为K-V存储的NOSQL数据库

支持redis协议接口,支持HTTP协议的REST接口;

##xhttpcache有哪些功能？

• 提供HTTP数据缓存服务，支持存储二进制数据;
• 完整的K-V存储实现, 支持数据持久化存储(ROCKSDB);
• 支持数据超时机制，提供毫秒级精度。
• 现实完整REDIS协议接口，支持redis的SET/GET/DEL/EXIRE/TTL命令;
• 实现HTTP/HTTPS协议接口，支持通过REST命令访问;
• 实现HTTP cache相关协议，支持eTage，支持304 Not Modified, 支持对传输内容gzip压缩;
• 自带WEB后台编辑器(http://127.0.0.1:9090/admin.htm)，可以直接添加(上传)/修改/删除数据;

###xhttpcache图解

##使用方法： xhttpcache被设计为HTTP数据加速服务器:通过提供的写接口向xhttpcache写入数据， 可以直接通过浏览器访问. 同时也提供了redis的协议接口，可以直接通过redis的client(支持各种语言接口)进行读写， 使之也可以当做简单的NOSQL数据库使用; 通过REDIS接口建立的数据，可以直接通过HTTP接口在浏览器里访问查看

####通过HTTP接口访问： xhttpcache 有两个HTTP服务端口，可以配置文件里配置; httpd_frontend_port 为开放访问端口，只支持读请求; httpd_backend_port 为后端数据操作端口，支持全部REST读写请求(get/post/put/delete); 后端数据接口访问可以设置登陆账号密码;

curl -d "testdata" http://test:[email protected]:9090/testkey
通过POST请求向 xhttpcache 提交建立一条kv格式的数据：testkey -- testdata

curl http://127.0.0.1:8080/testkey
通过get请求访问testkey的数据
通过前端端口访问，不需要密码验证，当然也可以通过后端接口带上密码访问：
curl http://test:[email protected]:9090/testkey
这两种方式通过GET请求访问的数据是完全一样的。

curl -I -X DELETE http://test:[email protected]:9090/testkey
通过http协议的delete请求删除testkey

####通过redis命令使用示例： 以下示例显示了所有的支持的REDIS命令

[xsky@localhost xhttpcache]$ redis-cli -p 6579
127.0.0.1:6579> set test hello 
OK
127.0.0.1:6579> get test
"hello"
127.0.0.1:6579> set test hello ex 1000
OK
127.0.0.1:6579> get test
"hello"
127.0.0.1:6579> ttl test
(integer) 988
127.0.0.1:6579> EXPIRE test 2000
(integer) 1
127.0.0.1:6579> ttl test
(integer) 1998
127.0.0.1:6579> get test
"hello"
127.0.0.1:6579> 

通过redis命令添加图片文件到 xhttpcache:

redis-cli -p 7379 -x set getheadimg.jpg <getheadimg.jpg

###数据批量导入

通过以下脚本向 xhttpcache 里批量导入磁盘文件, 以下脚本会将参数指定的目录下的文件都导入到 xhttpcache 里.

#!/bin/bash

# redis-cli -p 7379 -x set getheadimg.jpg <getheadimg.jpg
redis_cmd="redis-cli -p 7379 -x set "
function batch_convert() {
    for file in `ls $1`
    do
        if [ -d $1"/"$file ]
        then
            batch_convert $1"/"$file
        else
            #dos2unix $1"/"$file
            echo $redis_cmd $1"/"$file   $1"/"$file
            $redis_cmd $1"/"$file < $1"/"$file
        fi
    done
}

batch_convert $1

##特性说明： xhttpcache对通过HTTP访问的URI会进行类型判断，返回对应文件后缀的Content-Type， 使得xhttpcache的HTTP接口像一个真正的WEB服务器, 通过浏览器访问时，数据会直接以页面的形式显示。而不是像通常的数据接口一样。 例如：对于/test.htm 形式的地址，在返回内容时，http头部里返回: Content-Type: text/html; 这样，通过浏览器直接访问 test.htm 对应该的数据内容时，可以以HTML的形式显示。 对于/test.jpg 形式的key，如果对应该的value内容是JPG图片数据，通过浏览器访问/test.jpg时，就直接正常显示为图片; 并且后台还支持对图片的预览与上传; 根据以上特点，可以很容易的将静态网站文件全部加载到cache里,全部内存化.

##感激 感谢以下的项目,排名不分先后

• libevent
• libevhtp
• rocksdb
• ssdb

##关于作者

• xhttpcache 主页
• xSky blog
• xhttpcache QQ群: 195957781