org.jacorb.orb.portableInterceptor
Interface IORInfoExt

All Superinterfaces:

IDLEntity, IORInfo, IORInfoOperations, Object, java.io.Serializable

All Known Implementing Classes:

IORInfoImpl

public interface IORInfoExt

extends IORInfo

This class extends the standard defined interface of the IORInfo object given to each IORInterceptor during creation of new IORs. It provides convenience methods to modify the newly created IOR.

Version:

$Id: IORInfoExt.java,v 1.3 2004/05/06 12:40:00 nicolas Exp $

Author:

Marc Heide

Method Summary

void	add_profile(Profile profile) This method adds a further profile to an IOR.
int	get_number_of_profiles(int tag) This method returns the number of profiles of the given type.
Profile	get_profile(int tag) Returns the first profile with the given tag (position == 0).
Profile	get_profile(int tag, int position) Returns the profile with the given tag at the given position.

Methods inherited from interface org.omg.PortableInterceptor.IORInfoOperations

add_ior_component_to_profile, add_ior_component, get_effective_policy

Methods inherited from interface org.omg.CORBA.Object

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

Method Detail

add_profile

public void add_profile(Profile profile)

This method adds a further profile to an IOR. By using this method it is possible to append e.g. further IIOP profiles. The added profile is marshalled after all profiles already existing in profile list.

Parameters:

profile - the profile to add

get_number_of_profiles

public int get_number_of_profiles(int tag)

This method returns the number of profiles of the given type. The returned value can be used to iterate over the existing profiles of given type (get_profile()).

Parameters:

tag - profile tag, e.g. TAG_INTERNET_IOP.value

Returns:

number of profiles of given tag

get_profile

public Profile get_profile(int tag,
                           int position)

Returns the profile with the given tag at the given position. Following rule must apply to parameter position:

0 <= position < get_number_of_profiles(tag)

Parameters:

tag - tag of profile, e.g. TAG_INTERNET_IOP.value

position - position in IOR

Returns:

profile

Throws:

java.lang.ArrayIndexOutOfBoundsException - if position is out of range

get_profile

public Profile get_profile(int tag)

Returns the first profile with the given tag (position == 0). If no profile with given tag exists, null is returned.

Parameters:

tag - tag of profile, e.g. TAG_INTERNET_IOP.value

Returns:

first profile or null if no profile with given tag exists