ice 文档站:waitmoon.com/zh
1 Demo 仓库地址:
github:https://github.com/zjn-zjn/flink-ice
gitee:https://gitee.com/waitmoon/flink-ice
2 Demo 功能描述
通过 netcat 制造输入流(nc -l 9000 windows:nc -l -p 9000)
flink 接收本地 9000 端口输入流,以回车(\n)分割单词
输入流经过 IceProcessor 处理后打印结果流
3 项目搭建
使用 flink-quickstart-java 快速搭建 flink 项目
3.1 添加 ice 依赖
因 flink 为非 Spring 项目,需依赖 ice-core 并手动初始化,Spring 项目直接依赖 ice-client-spring-boot-starter 即可。
<dependency>
<groupId>com.waitmoon.ice</groupId>
<artifactId>ice-core</artifactId>
<version>${ice.version}</version>
</dependency>
复制代码
3.2 编写 StreamingJob
public class StreamingJob {
public static void main(String[] args) throws Exception {
// 创建 Flink 执行环境
final StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();
//接收本地socket9000端口输入流,以回车分割单词
//通过netcat制造输入流 nc -l 9000 (windows nc -l -p 9000)
DataStreamSource<String> stream = env.socketTextStream("localhost", 9000, "\n");
//按照单词长度keyBy,使用IceProcessor并打印结果
stream.keyBy(String::length).process(new IceProcessor()).print().setParallelism(1);
//执行程序
env.execute("Flink Streaming Java API Skeleton");
}
}
复制代码
3.3 编写 ice 算子 IceProcessor
在 static 代码块中初始化 ice 客户端,此处直接使用的自己部署的 ice-server 地址对应的 app:2
算子功能:将流内数据放入 roam,组装 pack 并执行 ice 规则处理(直接根据 iceId 触发,iceId 在 server 配置后台获取)
/**
* ice算子
*/
public class IceProcessor extends KeyedProcessFunction<Integer, String, String> {
//ice 客户端
private static IceNioClient iceNioClient;
static {
//初始化ice客户端
try {
//配置远程server地址,app,以及节点扫描路径
//此处使用了自己搭建的server,后台地址 http://eg.waitmoon.com/config/list/2
iceNioClient = new IceNioClient(2, "waitmoon.com:18121", "com.waitmoon.flink.ice.node");
//启动ice客户端
iceNioClient.start();
} catch (Exception e) {
throw new RuntimeException(e);
}
}
@Override
public void processElement(String value, Context ctx, Collector<String> out) {
//组装IcePack
IcePack pack = new IcePack();
//设置要触发的iceId(配置后台中需要触发的ID)
//http://eg.waitmoon.com/config/detail/2/1081
pack.setIceId(1081);
//初始化roam,将单词和长度放入roam中
IceRoam roam = new IceRoam();
roam.put("input", value);
roam.put("length", ctx.getCurrentKey());
pack.setRoam(roam);
//同步执行
Ice.syncProcess(pack);
//执行完成后,获取roam中的result
String result = roam.getMulti("result");
if (result != null) {
//result不为空,将结果放入下游算子
out.collect(result);
}
}
@Override
public void close() {
if (iceNioClient != null) {
//清理ice 客户端
iceNioClient.destroy();
iceNioClient = null;
}
}
}
复制代码
3.4 编写节点 ContainsFlow
节点功能:判断根据 key 去 roam 里拿的值是否在 set 中,是则返回 true,否则返回 false
/**
* @author waitmoon
* 过滤性质节点
* 判断值在不在集合中
*/
@Data
@Slf4j
@EqualsAndHashCode(callSuper = true)
public class ContainsFlow extends BaseLeafRoamFlow {
//默认input
private String key = "input";
private Set<String> set;
@Override
protected boolean doRoamFlow(IceRoam roam) {
//判断roam中的key对应的值是否在集合中
return set.contains(roam.<String>getMulti(key));
}
@Override
public void afterPropertiesSet() {
log.info("ContainsFlow init with key:{}, set:{} nodeId:{}", key, set, this.getIceNodeId());
}
public NodeRunStateEnum errorHandle(IceContext ctx, Throwable t) {
log.error("error occur id:{} e:", this.findIceNodeId(), t);
return super.errorHandle(ctx, t);
}
}
复制代码
3.5 编写节点 PutNone
节点功能:将 value 值放入 roam 的 key 中,不干扰流程(不返回 true/false)
/**
* @author waitmoon
* 不干扰流程性质节点
* 将一个值放入roam
*/
@Data
@EqualsAndHashCode(callSuper = true)
public class PutNone extends BaseLeafRoamNone {
//默认result
private String key = "result";
private Object value;
@Override
protected void doRoamNone(IceRoam roam) {
//将value放到roam中
roam.putMulti(key, value);
}
}
复制代码
4 项目启动
4.1 netcat 制造输入流
mac/linux 使用 nc -l 9000 命令,windows 使用 nc -l -p 9000 命令 制造一个 socket 输入流
4.2 运行 StreamingJob
运行时可以看到 ice 客户端启动相关信息
5 编排 ice 规则
在 ice-server 后台编辑 ice 规则,用的是自己部署的 ice-server,地址:http://eg.waitmoon.com/config
5.1 新增 app
5.2 新增 ice
此处 Debug 填 2 表示只打印节点执行过程,pack 中的 iceId 即为此处的 ID,点击查看详情即可编排规则
5.3 编排 ice 规则
此编排实现逻辑:根据不同的输入单词,输出对应的结果到 roam 的 result 字段中供后续使用。
如输入 waitmoon,在管理员列表中,则输出"you are admin~"到 roam 的 result 字段
6 发布与执行
在编排完规则后切记要发布后才会将变更推送到客户端并生效!!!
在终端输入单词并回车
在 flink 项目日志里可以看到:
ice 打印了执行过程,[节点 ID:节点类名简称:节点执行结果:节点执行耗时]
flink 因为最后的 sink 是 print(),所以打印了对应的输出。
这时候你就可以随意的更改变更规则去实现自己的业务啦~~~
评论