All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.ibm.beans.samples.dips.sessauth.SAInstantiationListener

java.lang.Object
   |
   +----com.ibm.beans.samples.dips.sessauth.SAInstantiationListener

public class SAInstantiationListener
extends Object
implements DipMethodCallListener
This object intercepts calls to instantiate a dippable bean that has been dipped in the Session Authentication dip. For example, when a dippable bean's readObject method is called. When the dippable bean is instantiated, this dip attempts to authenticate the principal by first querying for the principal's information, such as a User ID and Password, and then attempting to authenticate that principal.

This is the object that the Session Authentication dip registers with the dip framework for each method in the dippable bean that instantiates the bean.

See Also:
SessionAuthenticationDip, createMethodCallListener, SAPrincipal, SAPrincipalQuery, SAAuthenticator

Constructor Index

 o SAInstantiationListener(SAImpl)
Constructs an SAInstantiationListener.

Method Index

 o handleMethodCall(MethodCallEvent)
Handles calls to the dippable beans methods by authenicating the principal.
 o needsArguments()
Indicates whether this listener needs arguments.
 o retrieveDip()
Retrieves a pointer to the Dip that created the listener.

Constructors

 o SAInstantiationListener
 public SAInstantiationListener(SAImpl implementation)
Constructs an SAInstantiationListener.

Parameters:
implementation - A reference to this dip's implementation.

Methods

 o handleMethodCall
 public void handleMethodCall(MethodCallEvent evt)
Handles calls to the dippable beans methods by authenicating the principal. This method is invoked when a dippable bean is instantiated and the principal should be validated. The dippable bean's instantiation from a serialized object using a call to it's readObject method is intercepted. The dippable bean's constructors are not intercepted.

Parameters:
evt - A MethodCallEvent object describing the method.
 o needsArguments
 public boolean needsArguments()
Indicates whether this listener needs arguments. By not needing arguments, performance is improved because the dipping framework does not need to do any marshaling.

Returns:
true if the listener requires arguments, false otherwise.
 o retrieveDip
 public Dip retrieveDip()
Retrieves a pointer to the Dip that created the listener.

Returns:
A reference to the dip that created this listener.

All Packages  Class Hierarchy  This Package  Previous  Next  Index