File Doc Category Size Date Package
IIOPPrimaryToContactInfo.java API Doc Java SE 5 API 2271 Fri Aug 26 14:54:40 BST 2005 com.sun.corba.se.spi.transport

IIOPPrimaryToContactInfo

public interface IIOPPrimaryToContactInfo

This interface is the "sticky manager" for IIOP failover. The default ORB does NOT contain a sticky manager. One is registered by supplying a class via the com.sun.CORBA.transport.ORBIIOPPrimaryToContactInfoClass. It uses the IIOP primary host/port (with a SocketInfo.IIOP_CLEAR_TEXT type) as a key to map to the last ContactInfo that resulted in successful' communication. It mainly prevents "fallback" - if a previously failed replica comes back up we do NOT want to switch back to using it - particularly in the case of statefull session beans. Note: This assumes static lists of replicas (e.g., AS 8.1 EE). This does NOT work well with LOCATION_FORWARD.

author: Harold Carr

Fields Summary
Constructors Summary
Methods Summary
public boolean hasNext(com.sun.corba.se.pept.transport.ContactInfo primary, com.sun.corba.se.pept.transport.ContactInfo previous, java.util.List contactInfos)
param
primary - the key.
param
previous - if null return true. Otherwise, find previous in contactInfos and if another ContactInfo follows it in the list then return true. Otherwise false.
param
contactInfos - the list of replicas associated with the primary.
public com.sun.corba.se.pept.transport.ContactInfo next(com.sun.corba.se.pept.transport.ContactInfo primary, com.sun.corba.se.pept.transport.ContactInfo previous, java.util.List contactInfos)
param
primary - the key.
param
previous - if null then map primary to failover. If failover is empty then map primary to primary and return primary. If failover is non-empty then return failover. If previous is non-null that indicates that the previous failed. Therefore, find previous in contactInfos. Map the ContactInfo following previous to primary and return that ContactInfo.
public void reset(com.sun.corba.se.pept.transport.ContactInfo primary)
param
primary - clear any state relating to primary.