net.vattp.data
Class NetConfig

java.lang.Object
  |
  +--net.vattp.data.NetConfig

All Implemented Interfaces:

DeepPassByCopy, Marker, PassByConstruction, Persistent, Selfless, Serializable

public class NetConfig

extends Object

implements Persistent, DeepPassByCopy

Safe:

See Also:

Serialized Form

Field Summary

private ConstList	myListenAddrPath
private ConstList	mySearchPath
private ConstList	myVLSPath
static StaticMaker	NetConfigMaker Enabled:
private static long	serialVersionUID

Fields inherited from interface org.erights.e.elib.serial.Persistent

HONORARY, HONORED_NAMES

Fields inherited from interface org.erights.e.elib.serial.DeepPassByCopy

HONORARY, HONORED_NAMES

Constructor Summary

NetConfig()
Enabled:

NetConfig(ConstList vlsPath, ConstList searchPath, ConstList listenAddrPath)
Enabled:

Method Summary

void	__printOn(TextWriter out) Enabled:
ConstList	getListenAddrPath() Enabled: If we're on the air, this must be the TCP/IP addresses of our socket.
ConstList	getSearchPath() Enabled: Where others should look for me.
Object[]	getSpreadUncall() Enabled: Uses 'NetConfigMaker(vlsPath, searchPath, listenAddrPath)'.
ConstList	getVLSPath() Enabled: Where I register so others can find me.
static NetConfig	make(ConstMap optProps) Enabled: Make a NetConfig initialized from configuration propoerties (as might be provided by eprops.txt or "-D" on the command line).

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

NetConfigMaker

public static final StaticMaker NetConfigMaker

Enabled:

myVLSPath

private final ConstList myVLSPath

mySearchPath

private final ConstList mySearchPath

myListenAddrPath

private final ConstList myListenAddrPath

Constructor Detail

NetConfig

public NetConfig()

Enabled:

NetConfig

public NetConfig(ConstList vlsPath,
                 ConstList searchPath,
                 ConstList listenAddrPath)

Enabled:

Method Detail

make

public static NetConfig make(ConstMap optProps)

Enabled: Make a NetConfig initialized from configuration propoerties (as might be provided by eprops.txt or "-D" on the command line).

• e.VLSPath is an optional semicolon-separated list of TCP/IP addresses of VLSs this vat should register with. Defaults to "" -- the null list. Doesn't actually mean anything until the VLS code is revived.
• e.SearchPath is an optional semicolon-separated list of TCP/IP addresses for others to look for me. Defaults to the VLSPath. Once a vat knows its own ListenAddressPath, these should be added to the front of the list.
• e.ListenAddressPath is the optional TCP/IP addresses at which this vat should create the sockets it listens to. For each element of the path, if an IP address isn't given, the socket defaults to listening on all IP addresses of this host. If an IP address is given, it must be one of the IP addresses of this host. If the TCP port isn't given, it defaults to 0. A TCP port of 0 instructs the OS to pick any free TCP port.

getSpreadUncall

public Object[] getSpreadUncall()

Enabled: Uses 'NetConfigMaker(vlsPath, searchPath, listenAddrPath)'.

Specified by:

getSpreadUncall in interface Selfless

getVLSPath

public ConstList getVLSPath()

Enabled: Where I register so others can find me.

getSearchPath

public ConstList getSearchPath()

Enabled: Where others should look for me. This path is used in network designators I export (remote live refs, sturdy refs, URIs) that designate objects I host.

Usually the same as myVLSPath + myself, but may have further difference because of NAT (Network Address Translation -- a common bad firewall technique). Configuration parameter read as a JavaBeans property.

getListenAddrPath

public ConstList getListenAddrPath()

Enabled: If we're on the air, this must be the TCP/IP addresses of our socket.

(XXX in what format?)

If we're not yet on the air and this isn't empty, it says what socket addresses are preferred -- nothing more. Configuration parameter read as a JavaBeans property.

__printOn

public void __printOn(TextWriter out)
               throws IOException

Enabled:

IOException