Redis - 连接分布式K/V缓存服务

Redis 是一个高性能的key-value缓存/存储系统，由Pivotal旗下的SpringSource维护（https://redis.io/）。

主要功能

支持Redis 6.0.6版本的缓存服务
提供CCAPI封装，方便开发者使用
支持CC环境变量
支持SLA服务质量监控和告警通知，提供全局requestId
提供访问日志开关

特别说明

使用该应用要求AWS PaaS平台许可支持CC服务
使用该应用要求AWS PaaS平台版本不低于6.4.1

1.配置

配置Redis适配器。

项	说明
名称	Redis适配器的名称
服务模式	常规(单机模式)/Sentinel(哨兵)/Cluster(集群)，redis不同的部署模式
默认DB(dbindex)	访问的db索引
密码	认证密码，支持@公式，如@env(xxx)可获取环境中相应变量值
SSL	使用ssl协议
--- 常规 ---	--- 常规 ---
服务器IP
端口	Redis服务器端口，Redis服务默认端口为6379
--- Sentinel(哨兵) ---	--- Sentinel(哨兵) ---
主服务名	主服务名
节点	格式:`IP1:PORT1,IP2:PORT2`。支持@公式，如@env(xxx)可获取环境中相应变量值
--- Cluster(集群) ---	--- Cluster(集群) ---
节点	redis集群节点列表，格式:`IP1:PORT1,IP2:PORT2`。支持@公式，如@env(xxx)可获取环境中相应变量值
最大出错转发次数	集群模式失败转发次数
------	------
最小空闲数	连接池维持的最小空闲连接
最大空闲数	连接池维持的最大空闲连接
最大连接数	连接池维持的最大并发连接
描述	适配器描述信息

2.调用

由开发者在Java代码中调用Redis服务。

获取模型ID

在CC连接列表中可获取适配器模型ID。

API代码示例

在访问前，我们假设已创建了一个CC Redis技术适配器，其分配的模型Id为00000000

import com.actionsoft.bpms.bpmn.engine.core.delegate.ProcessExecutionContext;
import com.actionsoft.bpms.bpmn.engine.listener.ExecuteListener;
import com.actionsoft.sdk.local.SDK;
import com.actionsoft.sdk.local.api.cc.RedisAPI;
import com.actionsoft.sdk.local.api.cc.jedis.*;
import com.actionsoft.sdk.local.api.cc.jedis.serializer.Serializer;
import com.actionsoft.sdk.local.api.cc.jedis.serializer.StringSerializer;

import java.util.Date;
import java.util.Set;


/**
 * 需要在开发环境中引入AWS PaaS平台以下目录下所有jar包：
 * bin/lib目录下
 * bin/jdbc目录下
 * apps/install/com.actionsoft.apps.cc.connector.redis/lib目录下
 */
public class RedisAPITest extends ExecuteListener {
    @Override
    public void execute(ProcessExecutionContext processExecutionContext) throws Exception {
        //获得一个操作redis服务的RedisAPI对象
        RedisAPI<String,String> api = SDK.getCCAPI().getRedisAPI('00000000');
        api.serializer(new StringSerializer());

        //opsList()，这是定义key.   rightPush（）,在右边放值,每push一次，size就会加1
        api.opsList( "A1").rightPush("这是A1的值");

        //rightPop() 删除，pop一次，就会删除一个，list siZe就会减1
        api.opsList("A1").rightPop();

        //显示所有的List
        api.opsList("A1").range(0, redisAPI.opsList("A1").size());

        //关闭释放资源
        api.close();

        //...
    }
}

RedisAPI JavaDOC https://docs.awspaas.com/api/aws-api-javadoc/com/actionsoft/sdk/local/api/cc/RedisAPI.html

3.平台SESSION缓存放到Redis

把新建的Redis适配器ID配置到bin/conf/server.xml的redis.cc.id属性中，配置好后不需要重启平台服务

然后从工具附加-Redis Connector进入操作列表，找到AWS PaaS实例控制台应用中的缓存是 com.actionsoft.bpms.commons.session.cache.SessionCache，点击 切换到Redis将对应的操作切换到Redis,完成SESSION缓存放到Redis操作

缓存放到Redis,必须先实现RedisAdapter接口，否则无法切换到Redis，实现RedisAdapter接口示例详细参见这里

4.日志

当连接器开启记录访问请求到审计日志和记录返回结果到文件日志开关后，调用RedisAPI相关方法时，可记录日志，具体哪些方法会记录日志，请参见javadoc RedisAPI说明。

记录访问请求到审计日志

开启后，将访问请求记录到审计日志，该日志存储在AWS PaaS平台SYS_AUDIT_LOG表中，可在日志页进行查看。

记录返回结果到文件日志

开启后，将请求数据和返回结果记录到文件日志，该日志存储在AWS PaaS平台%AWS_HOME%/logs/目录下，默认每个文件日志最大为20M，最多存储20个文件，超出将自动清除最早日期文件。 log文件个数及单文件最大值可在%AWS_HOME%/bin/conf/aws-log4j.xml文件中配置。