一、从WordCount开始
1.1 Maven依赖
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.coderead</groupId>
<artifactId>flink-quick-start</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<encoding>UTF-8</encoding>
<java.version>1.8</java.version>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<scala.version>2.11</scala.version>
<flink.version>1.8.1</flink.version>
</properties>
<dependencies>
<dependency>
<groupId>org.apache.flink</groupId>
<artifactId>flink-streaming-java_${scala.version}</artifactId>
<version>${flink.version}</version>
</dependency>
</dependencies>
</project>
-
2.11
表示 Flink 是使用 Scala 2.11 编译的; -
1.8.1
表示的是 Flink 的版本号;截止撰写本文,Flink 已经有 1.14.0 版本了 Download Flink
1.2 Flink 代码
import org.apache.flink.api.common.functions.FlatMapFunction;
import org.apache.flink.api.java.tuple.Tuple2;
import org.apache.flink.streaming.api.datastream.DataStreamSource;
import org.apache.flink.streaming.api.environment.StreamExecutionEnvironment;
import org.apache.flink.util.Collector;
public class SocketTextWorkCountStream {
public static void main(String[] args) throws Exception {
StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();
DataStreamSource<String> src = env.socketTextStream("localhost", 8888);
src.flatMap(new LineSplitter()).setParallelism(1)
.keyBy(0)
.sum(1).setParallelism(1)
.print();
env.execute("Java WordCount from SocketTextStream Example");
}
private static final class LineSplitter implements FlatMapFunction<String, Tuple2<String, Integer>> {
@Override
public void flatMap(String value, Collector<Tuple2<String, Integer>> collector) {
// normalize and split the line
// \W 匹配非字母、数字、下划线。等价于 '[^A-Za-z0-9_]'。
String[] tokens = value.toLowerCase().split("\\W+");
// emit the pairs
for (String token : tokens) {
if (token.length() > 0) {
collector.collect(new Tuple2<>(token, 1));
}
}
}
}
}
1.3 服务端程序
在启动上面的程序之前,我们需要一个服务端程序:
import java.io.BufferedWriter;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.net.InetSocketAddress;
import java.net.ServerSocket;
import java.net.Socket;
import java.util.Scanner;
public class TextServer {
public static void main(String[] args) throws IOException {
try (ServerSocket server = new ServerSocket()) {
// 监听 8888 端口
server.bind(new InetSocketAddress(8888));
Socket socket = server.accept();
// 命令行输出
Scanner in = new Scanner(System.in);
// 通过 Socket 输出
try (BufferedWriter out = new BufferedWriter(new OutputStreamWriter(socket.getOutputStream()))) {
while (in.hasNextLine()) {
String value = in.nextLine();
out.write(value);
out.write("\n");
out.flush();
}
}
}
}
}
这个程序可以为我们的 SocketTextWorkCountStream
提供数据。
那么,为什么我们用的是以下这段代码呢?
BufferedWriter out = new BufferedWriter(new OutputStreamWriter(socket.getOutputStream()))
原因是要和 env.socketTextStream("localhost", 8888)
底层代码保持一致————代码一直跟到 SocketTextStreamFunction
第 97 行:
try (BufferedReader reader = new BufferedReader(new InputStreamReader(socket.getInputStream())))
当然, TextServer
也可以用另一种发送报文的方式:
try (PrintWriter out = new PrintWriter(socket.getOutputStream())) {
while (in.hasNextLine()) {
String value = in.nextLine();
out.println(value);
out.flush();
}
}
本质也是一样的,我们可以看一下 PrintWriter
的构造函数,也用到了 new BufferedWriter(new OutputStreamWriter(out))
:
public PrintWriter(OutputStream out, boolean autoFlush) {
this(new BufferedWriter(new OutputStreamWriter(out)), autoFlush);
// save print stream for error propagation
if (out instanceof java.io.PrintStream) {
psOut = (PrintStream) out;
}
}
需要注意的是,为了提高数据传输的效率,Socket类并没有在每次调用write
方法后都进行数据传输,而是将这些要传输的数据写到一个缓冲区里(默认是8192个字节),然后通过flush
方法将这个缓冲区里的数据一起发送出去,因此,out.flush();
是必须的。
二、源码解析
2.1 Flink执行环境
程序的启动,从这句开始。
final StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();
这行代码会返回一个可用的执行环境。执行环境是整个flink程序执行的上下文,记录了相关配置(如并行度等),并提供了一系列方法,如读取输入流的方法,以及真正开始运行整个代码的execute
方法等。对于分布式流处理程序来说,我们在代码中定义的flatMap
,keyBy
等等操作,事实上可以理解为一种声明,告诉整个程序我们采用了什么样的算子,而真正开启计算的代码不在此处。由于我们是在本地运行flink程序,因此这行代码会返回一个LocalStreamEnvironment
,最后我们要调用它的execute方法来开启真正的任务。我们先接着往下看。
2.2 算子(Operator)的注册(声明)
我们以org.apache.flink.streaming.api.datastream.DataStream#flatMap
为例, 跟踪源码进去是这样的:
/**
* 在{@link DataStream}上应用FlatMap转换。
* 该转换为DataStream的每个元素调用一次{@link FlatMapFunction}。
* 每个FlatMapFunction调用可以返回任意数量的元素,包括none。
* 用户还可以扩展{@link RichFlatMapFunction},以访问{@link org.apache.flink.api.common.functions.RichFunction}接口提供的其他功能。
*
* @param flatMapper
* The FlatMapFunction that is called for each element of the
* DataStream
*
* @param <R>
* output type
* @return The transformed {@link DataStream}.
*/
public <R> SingleOutputStreamOperator<R> flatMap(FlatMapFunction<T, R> flatMapper) {
TypeInformation<R> outType = TypeExtractor.getFlatMapReturnTypes(clean(flatMapper),
getType(), Utils.getCallLocationName(), true);
return transform("Flat Map", outType, new StreamFlatMap<>(clean(flatMapper)));
}
里面完成了两件事,一是用反射拿到了flatMap算子的输出类型,二是生成了一个Operator。 flink流式计算的核心概念,就是将数据从输入流一个个传递给Operator进行链式处理,最后交给输出流的过程。对数据的每一次处理在逻辑上成为一个operator,并且为了本地化处理的 效率起见,operator之间也可以串成一个chain一起处理(可以参考责任链模式帮助理解)。
1.3 整体变换过程
下面这张图表明了flink是如何看待用户的处理流程的:抽象化为一系列operator,以source开始,以sink结尾,中间的operator做的操作叫做transform,并且可以把几个操作串在一起执行。
你可能要问 env.socketTextStream("localhost", 8888);
有没有调用 addSource
啊?我们稍微跟踪一下 StreamExecutionEnvironment
源码:
public DataStreamSource<String> socketTextStream(String hostname, int port, String delimiter, long maxRetry) {
// 还是调用的 addSource 添加数据源
return addSource(new SocketTextStreamFunction(hostname, port, delimiter, maxRetry),
"Socket Stream");
}
同理,print
作为输出函数,也调用了 addSink
,跟踪一下 DataStream
源码:
public DataStreamSink<T> print() {
PrintSinkFunction<T> printFunction = new PrintSinkFunction<>();
// 还是调用了 addSink 输出结果
return addSink(printFunction).name("Print to Std. Out");
}