快速入门：Redis基本命令及用法简介

# Lighter 轻量级对象缓存服务中间件 [](https://www.apache.org/licenses/LICENSE-2.0.html) (目前主分支是 rebuild，如果在代码设计和风格统一上存在问题，请在评论区留言) **此项目已经废弃，请转移到 Go 重构的版本 kafo -- [码云](https://gitee.com/avino-plan/kafo) / [Github](https://github.com/avino-plan/kafo)** **目前正在使用 Go 语言进行重构！！！不仅会加入持久化功能，还会改造为真正的分布式缓存中间件。。。** **master 和 rebuild 分支是使用 Java 开发的单机版本，而 develop 分支则是目前正在改造的分布式版本。** + 使用 HTTP 请求作为网络协议，跨平台跨语言 + 可以直接与客户端相连，也可以在后端作为第一层缓存中间件存在 + 支持自定义的节点实现，默认带有一个节点实现 + 默认节点具备懒回收和哨兵回收两种过期回收机制 ### 1. 使用用途： 1) 主要用作于对象缓存，带有默认的缓存实现，并且允许多个节点的缓存，这也实现了负载均衡和分布式缓存。 2) 使用 `Tuz` 做容器托管（`Tuz` 是我写的另外一个开源项目：[Tuz 资源容器](https://gitee.com/FishGoddess/Tuz)，已发布到 [maven 中心仓库](https://mvnrepository.com/artifact/cn.com.fishin/Tuz)），并利用它的 IOC 技术和拦截器技术做业务解耦。 3) 在网络通信方面使用的是 `Netty`，并且实现了 `HTTP` 下的传输协议。 4) 整个项目的所有组件都允许自定义，包括缓存实现、节点选择、协议解析和网络通信协议，你只需要非常简单的实现一个接口即可。 + #### 留言网站：[https://www.fishin.com.cn](https://www.fishin.com.cn) + #### 联系方式：fishgoddess@qq.com + #### 开源协议：[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html) ### 2. 使用步骤： 详细请参考 [HowToUse.md](./HowToUse.md) 文件 1. 首先下载 Lighter 的压缩包 + 压缩包下载地址： + [码云地址](https://gitee.com/FishGoddess/Lighter/releases) + [GitHub](https://github.com/FishGoddess/Lighter/releases) 2. 当你下载好压缩包之后，就成功了一大半啦！ + 在 Linux 系统上如何启动 Lighter 服务？ a. 使用 `ls` 命令查看下载好的文件  b. 使用 `tar` 命令解压文件  c. 解压之后得到一个目录，使用 `cd` 命令进入目录，进去之后可以看到三个目录 + 首先来看 `bin` 目录，这是二进制文件所在的目录，运行服务和关闭服务的脚本都在这个目录下 + 让我们来启动服务吧！！ + 执行 `./startup.sh` 即可启动，当然，我们建议你使用后台启动方式，如图中：  + 你或许会担心以后台形式启动会看不到日志，不用担心，后面会提到日志在哪 + 如果你足够幸运，就可以看到下面这个 Lighter 图标：  + 到这里，服务就完全启动啦！！ + 注意：由于运行需要权限，如果你发现运行时显示`没有权限`，就先使用 `chmod` 赋予权限  + 如果你需要关闭服务，当然，我们不建议你这么做哈哈，但如果你坚持要这么做，可以执行 `shutdown.sh` 脚本   + 在 Windows 系统上如何启动 Lighter 服务？ a. 同样需要下载到 Lighter 的压缩包，这里就不赘述了，解压到一个目录下 b. 进入到这个目录，同样有三个目录，进入到 `bin` 目录下，双击 `startup.bat` 即可启动 c. 如果需要关闭服务，双击 `shutdown.bat` 即可 3. 服务运行中，日志在哪？ 在得到的目录中，有三个目录，`bin` / `conf` / `logs` 我想聪明的你已经猜到了，日志就是存放在 `logs` 目录，它以时间进行分割日志文件，一天一个日志文件  如果你需要配置服务，进入 `conf` 目录，打开 `config.properties` 文件进行配置即可 如果你需要配置日志信息，进入 `bin` / `classes` 目录，打开 `logback.xml` 文件进行配置即可 ### 请求例子： 下面这个协议完整版请点击：[Lighter 使用的 Http 协议](./protocol/HttpProtocol.md)。 这个协议目前实现的是 HTTP 请求，建议使用 Restful 的风格发送请求： 1. get 动作，获取一个对象: + 例子：http://127.0.0.1:9669/get/testKey + testKey 为对象的 key 值 + **建议使用 `GET 请求`** + 注意：返回值是一个 json 对象数组 2. set 动作，保存一个对象: + 例子：http://127.0.0.1:9669/set/testKey + testKey 为对象的 key 值 + **建议使用 `POST 请求`** + **建议使用 Content-Type: application/json;charset=utf-8** + 注意：返回值是一个 json 对象数组 请求体： ```json { "key1": "value1", "key2": "value2", "key3": "value3", "key4": "value4" } ``` 或者是： ```text 任意字符串 ``` 3. setAbsent 动作，如果对象键值不存在才保存: + 例子：http://127.0.0.1:9669/setAbsent/testKey + testKey 为对象的 key 值 + 如果 key 值不存在才保存 + **建议使用 `POST 请求`** + **建议使用 Content-Type: application/json;charset=utf-8** + 注意：返回值是一个 json 对象数组 请求体： ```json { "key1": "value1", "key2": "value2", "key3": "value3", "key4": "value4" } ``` 或者是： ```text 任意字符串 ``` 4. remove 动作，删除一个对象: + 例子：http://127.0.0.1:9669/remove/testKey + testKey 为对象的 key 值 + **建议使用 `DELETE 请求`** + 返回删除的这个对象 5. exists 动作，判断一个对象 key 是否存在: + 例子：http://127.0.0.1:9669/exists/testKey + testKey 为对象的 key 值 + **建议使用 `GET 请求`** + 返回 true 如果这个 key 存在 6. expiredTime 动作，判断一个对象 key 的存活时间: + 例子：http://127.0.0.1:9669/expiredTime/testKey + testKey 为对象的 key 值 + **建议使用 `GET 请求`** + 返回值的意义： + -2：这个 key 值不存在或者已经过期 + -1：这个 key 永不过期 + 正数：这个 key 的存活时间，大于 0 的一个数，等这个值变成 0，就意味着这个值已经过期 7. lighter 动作，获取 Lighter 服务运行的信息 + 例子：http://127.0.0.1:9669/lighter/info + 目前支持 keys、values、numberOfKeys、info 等动作 + info 为系统运行所有信息，包含上面几个系统动作的功能 + **建议使用 `GET 请求`** + 返回系统运行信息 ```json { "code": 0, "data": [ { "keys": { "node_15": [], "node_14": [], "node_0": [], "node_1": [], "node_2": [