org.jacorb.orb.iiop

Class IIOPProfile

java.lang.Object

org.omg.CORBA.LocalObject

org.omg.ETF._ProfileLocalBase

org.jacorb.orb.etf.ProfileBase

org.jacorb.orb.iiop.IIOPProfile

All Implemented Interfaces:

Serializable, Cloneable, Configurable, LocalInterface, Object, IDLEntity, org.omg.ETF.Profile, org.omg.ETF.ProfileOperations

public class IIOPProfile
extends ProfileBase
implements Cloneable

Author:

Andre Spiegel

See Also:

Serialized Form

Field Summary

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

components, configuration, corbalocStr, logger, objectKey, version

Constructor Summary

Constructors

Constructor and Description
IIOPProfile()
IIOPProfile(byte[] data)
IIOPProfile(IIOPAddress address, byte[] objectKey, int minor)
IIOPProfile(String corbaloc) Constructs an IIOPProfile from a corbaloc URL.

Method Summary

Methods

Modifier and Type	Method and Description
void	addAllWildcardAddresses(Configuration config) Method for use by IIOPListener to add all possible network addresses that are listened on by a wildcard listener.
Collection<org.omg.IIOP.ListenPoint>	asListenPoints()
Object	clone()
void	configure(Configuration config)
boolean	equals(Object other)
ProtocolAddressBase	getAddress()
List<IIOPAddress>	getAlternateAddresses()
org.omg.SSLIOP.SSL	getSSL()
int	getSSLPort() Returns the port on which SSL is available according to this profile, or -1 if SSL is not supported.
int	hash() To improve the management of a large set of profile instances, the author may provide a hash function using the data in a Profile instance.
int	hashCode()
boolean	is_match(org.omg.ETF.Profile prof) This function shall determine if the passed profile, prof, is a match to this profile.
void	patchPrimaryAddress(ProtocolAddressBase replacement) Replaces the host in this profile's primary address with newHost (if it is not null), and the port with newPort (if it is not -1).
void	readAddressProfile(CDRInputStream addressProfileStream) Reads the bytes that make up the ETF::AddressProfile bytes (new spec) from a stream.
void	setAlternateAddresses(List<IIOPAddress> alternates)
int	tag() ETF defined read-only accessor for the GIOP tag.
IIOPProfile	to_GIOP_1_0() Returns a copy of this profile that is compatible with GIOP 1.0.
IIOPProfile	toNonSSL() copy this (ssl) IIOPProfile.
String	toString()
void	writeAddressProfile(CDROutputStream addressProfileStream) Writes the bytes that would make up the ETF::AddressProfile bytes (new spec) to a stream.

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

addComponent, addComponent, asTaggedProfile, copy, demarshal, encapsulation, get_object_key, getComponent, getComponents, initFromProfileData, marshal, removeComponents, set_object_key, version

Methods inherited from class org.omg.ETF._ProfileLocalBase

_ids

Methods inherited from class org.omg.CORBA.LocalObject

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Constructor Detail

IIOPProfile

public IIOPProfile()

IIOPProfile

public IIOPProfile(byte[] data)

IIOPProfile

public IIOPProfile(IIOPAddress address,
           byte[] objectKey,
           int minor)

IIOPProfile

public IIOPProfile(String corbaloc)

Constructs an IIOPProfile from a corbaloc URL. Only to be used from the corbaloc parser.

Method Detail

configure

public void configure(Configuration config)
               throws ConfigurationException

Specified by:

configure in interface Configurable

Overrides:

configure in class ProfileBase

Throws:

ConfigurationException

setAlternateAddresses

public void setAlternateAddresses(List<IIOPAddress> alternates)

addAllWildcardAddresses

public void addAllWildcardAddresses(Configuration config)
                             throws ConfigurationException

Method for use by IIOPListener to add all possible network addresses that are listened on by a wildcard listener.

Parameters:

config -

Throws:

ConfigurationException

writeAddressProfile

public void writeAddressProfile(CDROutputStream addressProfileStream)

Writes the bytes that would make up the ETF::AddressProfile bytes (new spec) to a stream.

Writes GIOP version, host string, and port.

Specified by:

writeAddressProfile in class ProfileBase

readAddressProfile

public void readAddressProfile(CDRInputStream addressProfileStream)

Reads the bytes that make up the ETF::AddressProfile bytes (new spec) from a stream.

Writes GIOP version, host string, and port.

Specified by:

readAddressProfile in class ProfileBase

hash

public int hash()

To improve the management of a large set of profile instances, the author may provide a hash function using the data in a Profile instance. The Profile shall always implement this function and either return a hash number, or 0 (zero) if no hashing is supported.

Specified by:

hash in interface org.omg.ETF.ProfileOperations

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException

is_match

public boolean is_match(org.omg.ETF.Profile prof)

This function shall determine if the passed profile, prof, is a match to this profile. The specifics of the match are left to the details of the underlying transport, however profiles shall be considered a match, if they would create connections that share the same attributes relevant to the transport setup. Among others, this could include address information (eg. host address) and transport layer characteristics (eg. encryption levels). If a match is found, it shall return true, or false otherwise.

Specified by:

is_match in interface org.omg.ETF.ProfileOperations

tag

public int tag()

Description copied from class: ProfileBase

ETF defined read-only accessor for the GIOP tag.

Specified by:

tag in interface org.omg.ETF.ProfileOperations

Specified by:

tag in class ProfileBase

getAddress

public ProtocolAddressBase getAddress()

patchPrimaryAddress

public void patchPrimaryAddress(ProtocolAddressBase replacement)

Replaces the host in this profile's primary address with newHost (if it is not null), and the port with newPort (if it is not -1).

Overrides:

patchPrimaryAddress in class ProfileBase

getAlternateAddresses

public List<IIOPAddress> getAlternateAddresses()

getSSL

public org.omg.SSLIOP.SSL getSSL()

getSSLPort

public int getSSLPort()

Returns the port on which SSL is available according to this profile, or -1 if SSL is not supported.

to_GIOP_1_0

public IIOPProfile to_GIOP_1_0()

Returns a copy of this profile that is compatible with GIOP 1.0.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

asListenPoints

public Collection<org.omg.IIOP.ListenPoint> asListenPoints()

Overrides:

asListenPoints in class ProfileBase

Returns:

a Collection of ListenPoints that represent the endpoints contained in this IIOPProfile.

toNonSSL

public IIOPProfile toNonSSL()

copy this (ssl) IIOPProfile. thereby replace the port of the primaryAddress with the SSL port from the tagged components.