org.jacorb.orb.iiop

Class IIOPAddress

java.lang.Object

org.jacorb.orb.etf.ProtocolAddressBase

org.jacorb.orb.iiop.IIOPAddress

All Implemented Interfaces:

Cloneable, Configurable

public class IIOPAddress
extends ProtocolAddressBase

Author:

Andre Spiegel, Phil Mesnier

Field Summary

Fields inherited from class org.jacorb.orb.etf.ProtocolAddressBase

configuration

Constructor Summary

Constructors

Constructor and Description
IIOPAddress() Creates a new IIOPAddress that will be initialized later by a string
IIOPAddress(ServerSocket serverSocket) Method for use by the IIOPListener.
IIOPAddress(String hoststr, int port) Creates a new IIOPAddress for host and port.

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(Configuration configuration)
ProtocolAddressBase	copy() This function shall return an equivalent, copy of the profile.
boolean	equals(Object other)
boolean	fromString(String s)
InetAddress	getConfiguredHost() Returns the host as supplied to the constructor.
String	getHostName() Returns the host part of this IIOPAddress, as a DNS hostname.
String	getIP() Returns the host part of this IIOPAddress, as a numeric IP address in dotted decimal form.
static InetAddress	getLocalHost() Returns an address for the localhost that is reasonable to use in the IORs we produce.
static String	getLocalHostAddress(org.slf4j.Logger logger) Returns a string representation of the localhost address.
static LinkedList<InetAddress>	getNetworkInetAddresses() Returns an ordered list of InetAddresses.
String	getOriginalHost() Method for use by the PrintIOR utility.
int	getPort() Returns the port number of this address, represented as an integer in the range 0..65535.
ListenEndpoint.Protocol	getProtocol()
int	hashCode()
boolean	isWildcard()
static IIOPAddress	read(InputStream in)
void	setHostInetAddress(InetAddress hostInetAddr) Method for use by the IIOPListener to set host address for a wildcard listener after the server socket has been instantiated.
void	setHostname(String hn) Used by the ORB to configure just the hostname portion of a proxy IOR address
void	setPort(int p)
void	setProtocol(ListenEndpoint.Protocol proto)
void	setWildcardHost(boolean state) Method for use by the IIOPListener to set the wildcard state of a wildcard listener after the server socket has been instantiated.
String	toString()
void	write(CDROutputStream cdr)

Methods inherited from class org.jacorb.orb.etf.ProtocolAddressBase

toCDR

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

IIOPAddress

public IIOPAddress()

Creates a new IIOPAddress that will be initialized later by a string

IIOPAddress

public IIOPAddress(String hoststr,
           int port)

Creates a new IIOPAddress for host and port.

Parameters:

hoststr - either a DNS name, or a textual representation of a numeric IP address (dotted decimal)

port - the port number represented as an integer, in the range 0..65535. As a special convenience, a negative number is converted by adding 65536 to it; this helps using values that were previously stored in a Java short.

IIOPAddress

public IIOPAddress(ServerSocket serverSocket)

Method for use by the IIOPListener. Create a new IIOPAddress for serverSocket which has already been instantiated.

Parameters:

serverSocket -

Method Detail

configure

public void configure(Configuration configuration)
               throws ConfigurationException

Specified by:

configure in interface Configurable

Overrides:

configure in class ProtocolAddressBase

Throws:

ConfigurationException

read

public static IIOPAddress read(InputStream in)

setProtocol

public void setProtocol(ListenEndpoint.Protocol proto)

getProtocol

public ListenEndpoint.Protocol getProtocol()

getIP

public String getIP()

Returns the host part of this IIOPAddress, as a numeric IP address in dotted decimal form. If the numeric IP address was specified when this object was created, then that address is returned. Otherwise, this method performs a DNS lookup on the hostname.

getHostName

public String getHostName()

Returns the host part of this IIOPAddress, as a DNS hostname. If the DNS name was specified when this IIOPAddress was created, then that name is returned. Otherwise, this method performs a reverse DNS lookup on the IP address.

setHostname

public void setHostname(String hn)

Used by the ORB to configure just the hostname portion of a proxy IOR address

getConfiguredHost

public InetAddress getConfiguredHost()

Returns the host as supplied to the constructor. This replaces IIOPListener.getConfiguredHost(). Used by the IIOPListener to retrieve the host address for a wildcard listener after the server socket has been instantiated.

getPort

public int getPort()

Returns the port number of this address, represented as an integer in the range 0..65535.

setPort

public void setPort(int p)

setHostInetAddress

public void setHostInetAddress(InetAddress hostInetAddr)

Method for use by the IIOPListener to set host address for a wildcard listener after the server socket has been instantiated. The flag isWildcard and the source_name will be updated to reflect the current state of the wildcard listener.

Parameters:

hostInetAddr -

isWildcard

public boolean isWildcard()

Returns:

the boolean state of the wildcard listener. A true state indicates a wildcard listener.

setWildcardHost

public void setWildcardHost(boolean state)

Method for use by the IIOPListener to set the wildcard state of a wildcard listener after the server socket has been instantiated.

Parameters:

state -

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Specified by:

toString in class ProtocolAddressBase

fromString

public boolean fromString(String s)

Specified by:

fromString in class ProtocolAddressBase

write

public void write(CDROutputStream cdr)

Specified by:

write in class ProtocolAddressBase

getOriginalHost

public String getOriginalHost()

Method for use by the PrintIOR utility. Previously it called getHostname() which may or may not have returned what was actually encoded in the IOR. This is of limited use for debugging purposes. This method attempts to return the string that this address was actually constructed with (i.e. what the IOR actually contains as its host string).

Returns:

Host name or IP address or both if the original host string cannot be determined.

getLocalHostAddress

public static String getLocalHostAddress(org.slf4j.Logger logger)

Returns a string representation of the localhost address.

getLocalHost

public static InetAddress getLocalHost()

Returns an address for the localhost that is reasonable to use in the IORs we produce.

getNetworkInetAddresses

public static LinkedList<InetAddress> getNetworkInetAddresses()

Returns an ordered list of InetAddresses. Order is: IPv4/IPv6 routable address Point-to-point address Fallback to link-local and finally loopback.

copy

public ProtocolAddressBase copy()

Description copied from class: ProtocolAddressBase

This function shall return an equivalent, copy of the profile.

Specified by:

copy in class ProtocolAddressBase