org.jboss.com.sun.corba.se.spi.transport

Interface 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 org.jboss.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

Method Summary

Methods

Modifier and Type	Method and Description
boolean	hasNext(ContactInfo primary, ContactInfo previous, List<ContactInfo> contactInfos)
ContactInfo	next(ContactInfo primary, ContactInfo previous, List<ContactInfo> contactInfos)
void	reset(ContactInfo primary)

Method Detail

reset

void reset(ContactInfo primary)

Parameters:

primary - - clear any state relating to primary.

hasNext

boolean hasNext(ContactInfo primary,
              ContactInfo previous,
              List<ContactInfo> contactInfos)

Parameters:

primary - - the key.

previous - - if null return true. Otherwise, find previous in contactInfos and if another ContactInfo follows it in the list then return true. Otherwise false.

contactInfos - - the list of replicas associated with the primary.

next

ContactInfo next(ContactInfo primary,
               ContactInfo previous,
               List<ContactInfo> contactInfos)

Parameters:

primary - - the key.

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.