ai.eloquent.data

Class UDPTransport

java.lang.Object

ai.eloquent.data.UDPTransport

All Implemented Interfaces:

Transport

public class UDPTransport
extends java.lang.Object
implements Transport

A class (usually instantiated as a singleton) to send and receive messages over UDP.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	allowJumboPackets If true, allow sending of "jumbo packets" (fragmented packets) larger than the MTU of the interface.
static Lazy<Transport>	DEFAULT The default UDP broadcast.
int	mtu The inferred MTU (Maximum Transmission Unit) of this transport
java.net.InetAddress	serverName The name we should assign ourselves on the transport.
boolean	thread If true, run the handling of messages on the transport in a new thread.
boolean	zip If true, zip packets on the network.

Fields inherited from interface ai.eloquent.data.Transport

POOL

Constructor Summary

Constructors

Constructor and Description
UDPTransport()

Method Summary

Modifier and Type	Method and Description
void	bind(UDPBroadcastProtos.MessageType channel, java.util.function.Consumer<byte[]> listener) Bind a consumer to this transport, to listen on incoming messages.
boolean	broadcastTransport(UDPBroadcastProtos.MessageType messageType, byte[] message) Send the given message to everyone on the network.
static void	main(java.lang.String[] args)
static java.net.InetAddress[]	readKubernetesState() Read the Kubernetes broadcast state from a file.
boolean	sendTransport(java.lang.String destination, UDPBroadcastProtos.MessageType messageType, byte[] message) Send a message over the transport to a destination.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface ai.eloquent.data.Transport

doAction

Field Detail

serverName

public final java.net.InetAddress serverName

The name we should assign ourselves on the transport.

thread

public final boolean thread

If true, run the handling of messages on the transport in a new thread.

zip

public final boolean zip

If true, zip packets on the network. This takes ~2x as much CPU, but lowers packet size.

mtu

public final int mtu

The inferred MTU (Maximum Transmission Unit) of this transport

allowJumboPackets

public final boolean allowJumboPackets

If true, allow sending of "jumbo packets" (fragmented packets) larger than the MTU of the interface. On one hand, this allows for UDP with larger packet sizes; on the other hand, this may be unstable / slower on the open internet, vs a known local area network.

DEFAULT

public static Lazy<Transport> DEFAULT

The default UDP broadcast.

Constructor Detail

UDPTransport

public UDPTransport()
             throws java.io.IOException

Throws:

java.io.IOException

See Also:

UDPTransport(int, int, boolean, boolean, boolean)

Method Detail

readKubernetesState

public static java.net.InetAddress[] readKubernetesState()
                                                  throws java.io.IOException

Read the Kubernetes broadcast state from a file.

Returns:

The addresses of all the nodes known to Kubernetes.

Throws:

java.io.IOException - Thrown if we could not read the Kubernetes state.

bind

public void bind(UDPBroadcastProtos.MessageType channel,
                 java.util.function.Consumer<byte[]> listener)

Bind a consumer to this transport, to listen on incoming messages.

Specified by:

bind in interface Transport

Parameters:

channel - The type of message we're listing for.

listener - The listener, taking as input a raw byte stream.

sendTransport

public boolean sendTransport(java.lang.String destination,
                             UDPBroadcastProtos.MessageType messageType,
                             byte[] message)

Send a message over the transport to a destination.

Specified by:

sendTransport in interface Transport

Parameters:

destination - The destination we're sending to.

messageType - The type of message we're sending.

message - The message we're sending.

Returns:

True if the message was sent; false if the message was too long.

broadcastTransport

public boolean broadcastTransport(UDPBroadcastProtos.MessageType messageType,
                                  byte[] message)

Send the given message to everyone on the network.

Specified by:

broadcastTransport in interface Transport

Parameters:

messageType - The type of message we're sending.

message - The messge to send

Returns:

True if the message was sent to everyone.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Throws:

java.io.IOException