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