Posted in Software Development

My Java gets Clingy to UPnP (Using Java Cling for UPnP Communication)

I’m fairly new to Java programming but I don’t like to dance about with silly little projects, I’ve mastered my connection to mySQL and I’ve got a basic serial communications module. But this weeks task has been to gets some UPnP communications working, with the aim of being able to set up some port forwarding on a regular router from a basic linux (Debian) server with the settings editable in a simple web based GUI.

In a previous version I have scripted CLI calls to UPnPc from PERL but not only was this method going round the houses, it also was not the most reliable method of getting the port forwarding set up correctly. When I found Cling over the weekend I thought I had found the answer. Though so far I’ve found Cling an incredibly complicated API to use after a attempts of jumping in feet first I took a step back and re-read the manual implementing the first example:

package ...;

import org.teleal.cling.model.message.header.STAllHeader;
import org.teleal.cling.model.meta.LocalDevice;
import org.teleal.cling.model.meta.RemoteDevice;
import org.teleal.cling.registry.Registry;
import org.teleal.cling.registry.RegistryListener;

import org.teleal.cling.UpnpService;
import org.teleal.cling.UpnpServiceImpl;

* Runs a simple UPnP discovery procedure.
public class Main {

public static void main(String[] args) throws Exception {

// UPnP discovery is asynchronous, we need a callback
RegistryListener listener = new RegistryListener() {

public void remoteDeviceDiscoveryStarted(Registry registry,
RemoteDevice device) {
"Discovery started: " + device.getDisplayString()

public void remoteDeviceDiscoveryFailed(Registry registry,
RemoteDevice device,
Exception ex) {
"Discovery failed: " + device.getDisplayString() + " => " + ex

public void remoteDeviceAdded(Registry registry, RemoteDevice device) {
"Remote device available: " + device.getDisplayString()

public void remoteDeviceUpdated(Registry registry, RemoteDevice device) {
"Remote device updated: " + device.getDisplayString()

public void remoteDeviceRemoved(Registry registry, RemoteDevice device) {
"Remote device removed: " + device.getDisplayString()

public void localDeviceAdded(Registry registry, LocalDevice device) {
"Local device added: " + device.getDisplayString()

public void localDeviceRemoved(Registry registry, LocalDevice device) {
"Local device removed: " + device.getDisplayString()

public void beforeShutdown(Registry registry) {
"Before shutdown, the registry has devices: "
+ registry.getDevices().size()

public void afterShutdown() {
System.out.println("Shutdown of registry complete!");


// This will create necessary network resources for UPnP right away
System.out.println("Starting Cling...");
UpnpService upnpService = new UpnpServiceImpl(listener);

// Send a search message to all devices and services, they should respond soon
upnpService.getControlPoint().search(new STAllHeader());

// Let's wait 10 seconds for them to respond
System.out.println("Waiting 10 seconds before shutting down...");

// Release all resources and advertise BYEBYE to other UPnP devices
System.out.println("Stopping Cling...");

This gave me hope as it worked after adding only two missing import statements (included in the above). I’ve started picking it apart and working through understanding the code. 

When I have a next step to share I will add extra details. Maybe you can learn with me.

Edit: since this post I have given up with Cling and successfully finished the development using CyberLink for Java by Satoshi Konno it can be found at I will see about a post on this eventually.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s