net.tomp2p.connection

Class Bindings

java.lang.Object

net.tomp2p.connection.Bindings

public class Bindings
extends Object

Gathers information about interface bindings. Here a user can set the preferences to which addresses to bind the socket. This class contains two types of information: 1.) the interface/address to listen for incoming connections and 2.) how other peers see us. The default is to listen to all interfaces and our outside address is set to the first interface it finds. If more than one search hint is used, then the combination operation will be "and"

Author:

Thomas Bocek

Constructor Summary

Constructors

Constructor and Description
Bindings()

Method Summary

Methods

Modifier and Type	Method and Description
Bindings	add(Bindings other) Adds the results from an other binding.
Bindings	addAddress(InetAddress address) Adds an address that we want to listen to.
Bindings	addInterface(String interfaceHint) Adds an interface that will be searched for.
Bindings	addProtocol(StandardProtocolFamily protocolFamily)
List<InetAddress>	addresses()
boolean	anyAddresses()
boolean	anyInterfaces()
boolean	anyProtocols()
List<InetAddress>	broadcastAddresses()
void	clear() Clears all lists: listenInterfaceHints, listenAddresses, broadcastAddresses.
boolean	containsInterface(String name) Checks if the user provided an interface hint.
InetAddress	foundAddress()
List<InetAddress>	foundAddresses() Returns a list of InetAddresses to listen to.
List<String>	interfaceHints()
boolean	isIPv4()
boolean	isIPv6()
boolean	isListenAll()
List<StandardProtocolFamily>	protocolHint()
SocketAddress	wildCardSocket()

Methods inherited from class java.lang.Object

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

Constructor Detail

Bindings

public Bindings()

Method Detail

foundAddresses

public List<InetAddress> foundAddresses()

Returns a list of InetAddresses to listen to. First Inet4Addresses, then Inet6Addresses are present in the list. This returns the matching addresses from DiscoverNetworks.

Returns:

A list of InetAddresses to listen to

foundAddress

public InetAddress foundAddress()

broadcastAddresses

public List<InetAddress> broadcastAddresses()

Returns:

A list of broadcast addresses.

addAddress

public Bindings addAddress(InetAddress address)

Adds an address that we want to listen to. If the address is not found, it will be ignored

Parameters:

address - The current class

Returns:

this instance

addresses

public List<InetAddress> addresses()

Returns:

A list of the addresses provided by the user

addInterface

public Bindings addInterface(String interfaceHint)

Adds an interface that will be searched for. If the interface is not found, it will be ignored

Parameters:

interfaceHint - The interface, e.g. eth0

Returns:

The same instance

addProtocol

public Bindings addProtocol(StandardProtocolFamily protocolFamily)

interfaceHints

public List<String> interfaceHints()

Returns:

A list of interfaces to listen to

protocolHint

public List<StandardProtocolFamily> protocolHint()

Returns:

The protocol to listen to

clear

public void clear()

Clears all lists: listenInterfaceHints, listenAddresses, broadcastAddresses.

anyAddresses

public boolean anyAddresses()

Returns:

Checks if the user sets any addresses

anyInterfaces

public boolean anyInterfaces()

Returns:

Checks if the user sets any interfaces

anyProtocols

public boolean anyProtocols()

Returns:

Checks if the user sets any protocols

isIPv4

public boolean isIPv4()

Returns:

Checks if the user sets protocol to anything or IPv4

isIPv6

public boolean isIPv6()

Returns:

Checks if the user sets protocol to anything or IPv6

isListenAll

public boolean isListenAll()

Returns:

Checks if the user sets anything at all

containsInterface

public boolean containsInterface(String name)

Checks if the user provided an interface hint.

Parameters:

name - The name of the interface reported by the system

Returns:

True if the user added the interface

add

public Bindings add(Bindings other)

Adds the results from an other binding. This is useful because you can add within one Bindings hints only with "and", with add() you have the option "or" as well. E.g., Bindings b1 = new Bindings(IPv4, eth0); Bindings b2 = new Bindings(IPv6, eth1); b2.add(b1) -> this will bind to all IPv4 addresses on eth0 and all IPv6 addresses on eth1

Parameters:

other - The other instance to get the results from

Returns:

The same instance

wildCardSocket

public SocketAddress wildCardSocket()