Nov 18, 2014

UDP Server with Spring Boot and Reactor

UDP support was added to the 1.1.0 release of project Reactor, but the web has been pretty quiet about it since. There are some good existing technologies out there if you need to write a UDP server, but those aren’t part of the sweet Reactor project… or integrate seamlessly with Spring Boot!

I have created a very simple, starter server on Github and will run through the pieces:

Reactor Spring Support
If you open the build.gradle file in the project you will notice the “org.projectreactor.spring:reactor-spring-context” dependency. This project implicitly creates the Environment and puts it into your application context when you use the @EnableReactor annotation on the configuration class. It makes wiring everything together very easy by providing annotations for specifying consumers, selectors, and etc. when you’re ready to start doing something with the incoming packets. Of course, it also does the lifecycle stuff you would expect with a Spring project, so check out their documentation for more.

The Datagram Server
Much like the Reactor TCP server, you shouldn’t instantiate an implementation of DatagramServer directly. Instead use the DatagramServerSpec to build the server and configure it. We aren’t doing anything interesting with the incoming packets for this example, just logging them when they arrive.

The CountDownLatch
As noted in this example from Spring, the TCP and UDP servers are non-blocking so this is necessary so the main thread doesn’t exit.

Give It a Run
Use the Gradle wrapper to build, and then run the jar (also be sure you are using JDK 8):

Spring boot will start up and you should see logging from the framework. Look for a statement that looks something like:

r.net.netty.udp.NettyDatagramServer      : BIND /0:0:0:0:0:0:0:0:{SOME_PORT_NUMBER}

This will tell you what port number the server is listening, keep this in mind for the next step.

Test It Out
Netcat is very convenient for sending simple UDP packets for situations like this. In a separate shell type:

Where $UDP_SERVER_PORT is the port we collected from the log output in the previous step.

About the Author

Object Partners profile.

One thought on “UDP Server with Spring Boot and Reactor

Leave a Reply

Your email address will not be published. Required fields are marked *

Related Blog Posts
Rewriting files in Google Cloud Storage
Rewriting Files in GCP Note: even though this code is in Python, this should be the same idea in JavaScript, Go, etc. I wrote the following to copy a file from one Google Cloud Storage […]
Interpreting Spatial Data in the Age of COVID-19
As 2020 has come to an end, many are eager to leave the mess of COVID-19 behind with the new year and gain a fresh start. Unfortunately, new cases are still soaring across the United […]
Building a Better Mousetrap
Recently, my daughter (age 6) was into building “mousetraps” out of shoe boxes. These were more or less comfortable cardboard mouse houses complete with beds, rooms, everything a mouse could want or need and not […]
ARM Wrestling Its Way Into Mainstream Software Development
Nearly all smart phones have been running ARM-based processors for years. They provide superior power for the amount of power consumed, and thus extend battery life. With Apple’s recent release of the Apple Silicon M1 […]