Tutorial - Spark Streaming, Plugging in a custom receiver.
A “Spark Streaming” receiver can be a simple network stream, streams of messages from a message queue, files etc. A receiver can also assume roles more than just receiving data like filtering, preprocessing, to name a few of the possibilities. The api to plug-in any user defined custom receiver is thus provided to encourage development of receivers which may be well suited to ones specific need.
This guide shows the programming model and features by walking through a simple sample receiver and corresponding Spark Streaming application.
A quick and naive walk-through
Write a simple receiver
This starts with implementing Actor
Following is a simple socket text-stream receiver, which is appearently overly simplified using Akka’s socket.io api.
class SocketTextStreamReceiver (host:String,
port:Int,
bytesToString: ByteString => String) extends Actor with Receiver {
override def preStart = IOManager(context.system).connect(host, port)
def receive = {
case IO.Read(socket, bytes) => pushBlock(bytesToString(bytes))
}
}
All we did here is mixed in trait Receiver and called pushBlock api method to push our blocks of data. Please refer to scala-docs of Receiver for more details.
A sample spark application
- First create a Spark streaming context with master url and batchduration.
val ssc = new StreamingContext(master, "WordCountCustomStreamSource",
Seconds(batchDuration))
- Plug-in the actor configuration into the spark streaming context and create a DStream.
val lines = ssc.actorStream[String](Props(new SocketTextStreamReceiver(
"localhost",8445, z => z.utf8String)),"SocketReceiver")
- Process it.
val words = lines.flatMap(_.split(" "))
val wordCounts = words.map(x => (x, 1)).reduceByKey(_ + _)
wordCounts.print()
ssc.start()
-
After processing it, stream can be tested using the netcat utility.
$ nc -l localhost 8445 hello world hello hello
Multiple homogeneous/heterogeneous receivers.
A DStream union operation is provided for taking union on multiple input streams.
val lines = ssc.actorStream[String](Props(new SocketTextStreamReceiver(
"localhost",8445, z => z.utf8String)),"SocketReceiver")
// Another socket stream receiver
val lines2 = ssc.actorStream[String](Props(new SocketTextStreamReceiver(
"localhost",8446, z => z.utf8String)),"SocketReceiver")
val union = lines.union(lines2)
Above stream can be easily process as described earlier.
A more comprehensive example is provided in the spark streaming examples