org.zeromq

Class ZBeacon

java.lang.Object

org.zeromq.ZBeacon

public class ZBeacon
extends Object

This class implements a peer-to-peer discovery service for local networks. A beacon can broadcast and/or capture service announcements using UDP messages on the local area network. This implementation uses IPv4 UDP broadcasts. You can define the format of your outgoing beacons, and set a filter that validates incoming beacons. Beacons are sent and received asynchronously in the background.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ZBeacon.Builder
static interface	ZBeacon.Listener All beacons with matching prefix are passed to a listener.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_BROADCAST_HOST
static long	DEFAULT_BROADCAST_INTERVAL

Constructor Summary

Constructors

Constructor and Description
ZBeacon(InetAddress broadcastAddress, InetAddress serverAddress, int port, byte[] beacon, long broadcastInterval, boolean ignoreLocalAddress, boolean blocking)
ZBeacon(int port, byte[] beacon)
ZBeacon(String broadcastAddress, byte[] serverAddress, int port, byte[] beacon, long broadcastInterval, boolean ignoreLocalAddress, boolean blocking) Deprecated.
ZBeacon(String host, int port, byte[] beacon)
ZBeacon(String host, int port, byte[] beacon, boolean ignoreLocalAddress)
ZBeacon(String host, int port, byte[] beacon, boolean ignoreLocalAddress, boolean blocking)

Method Summary

Modifier and Type	Method and Description
byte[]	getBeacon()
long	getBroadcastInterval()
ZBeacon.Listener	getListener()
byte[]	getPrefix()
void	setBeacon(byte[] beacon) Deprecated. use the builder
void	setBroadcastInterval(long broadcastInterval)
void	setListener(ZBeacon.Listener listener) Deprecated. use the builder
void	setPrefix(byte[] prefix) Deprecated. use the builder
void	setUncaughtExceptionHandlers(Thread.UncaughtExceptionHandler clientExHandler, Thread.UncaughtExceptionHandler serverExHandler) Deprecated. use the builder
void	start()
void	startClient()
void	startServer()
void	stop()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_BROADCAST_INTERVAL

public static final long DEFAULT_BROADCAST_INTERVAL

See Also:

Constant Field Values

DEFAULT_BROADCAST_HOST

public static final String DEFAULT_BROADCAST_HOST

See Also:

Constant Field Values

Constructor Detail

ZBeacon

public ZBeacon(int port,
               byte[] beacon)

ZBeacon

public ZBeacon(String host,
               int port,
               byte[] beacon)

ZBeacon

public ZBeacon(String host,
               int port,
               byte[] beacon,
               boolean ignoreLocalAddress)

ZBeacon

public ZBeacon(String host,
               int port,
               byte[] beacon,
               boolean ignoreLocalAddress,
               boolean blocking)

ZBeacon

public ZBeacon(InetAddress broadcastAddress,
               InetAddress serverAddress,
               int port,
               byte[] beacon,
               long broadcastInterval,
               boolean ignoreLocalAddress,
               boolean blocking)

ZBeacon

@Deprecated
public ZBeacon(String broadcastAddress,
                           byte[] serverAddress,
                           int port,
                           byte[] beacon,
                           long broadcastInterval,
                           boolean ignoreLocalAddress,
                           boolean blocking)

Deprecated.

Method Detail

setUncaughtExceptionHandlers

@Deprecated
public void setUncaughtExceptionHandlers(Thread.UncaughtExceptionHandler clientExHandler,
                                                     Thread.UncaughtExceptionHandler serverExHandler)

Deprecated. use the builder

Parameters:

clientExHandler -

serverExHandler -

startClient

public void startClient()

startServer

public void startServer()

start

public void start()

stop

public void stop()
          throws InterruptedException

Throws:

InterruptedException

setBeacon

@Deprecated
public void setBeacon(byte[] beacon)

Deprecated. use the builder

Parameters:

beacon -

getBeacon

public byte[] getBeacon()

setPrefix

@Deprecated
public void setPrefix(byte[] prefix)

Deprecated. use the builder

Parameters:

prefix -

getPrefix

public byte[] getPrefix()

setListener

@Deprecated
public void setListener(ZBeacon.Listener listener)

Deprecated. use the builder

Parameters:

listener -

getListener

public ZBeacon.Listener getListener()

getBroadcastInterval

public long getBroadcastInterval()

setBroadcastInterval

public void setBroadcastInterval(long broadcastInterval)