Java EE 5 SDK

javax.servlet.http
Class HttpSessionBindingEvent

java.lang.Object
  extended by java.util.EventObject
      extended by javax.servlet.http.HttpSessionEvent
          extended by javax.servlet.http.HttpSessionBindingEvent
All Implemented Interfaces:
Serializable

public class HttpSessionBindingEvent
extends HttpSessionEvent

Events of this type are either sent to an object that implements HttpSessionBindingListener when it is bound or unbound from a session, or to a HttpSessionAttributeListener that has been configured in the deployment descriptor when any attribute is bound, unbound or replaced in a session.

The session binds the object by a call to HttpSession.setAttribute and unbinds the object by a call to HttpSession.removeAttribute.

Author:
Various
See Also:
HttpSession, HttpSessionBindingListener, HttpSessionAttributeListener, Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
HttpSessionBindingEvent(HttpSession session, String name)
          Constructs an event that notifies an object that it has been bound to or unbound from a session.
HttpSessionBindingEvent(HttpSession session, String name, Object value)
          Constructs an event that notifies an object that it has been bound to or unbound from a session.
 
Method Summary
 String getName()
          Returns the name with which the attribute is bound to or unbound from the session.
 HttpSession getSession()
          Return the session that changed.
 Object getValue()
          Returns the value of the attribute that has been added, removed or replaced.
 
Methods inherited from class java.util.EventObject
getSource, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

HttpSessionBindingEvent

public HttpSessionBindingEvent(HttpSession session,
                               String name)
Constructs an event that notifies an object that it has been bound to or unbound from a session. To receive the event, the object must implement HttpSessionBindingListener.

Parameters:
session - the session to which the object is bound or unbound
name - the name with which the object is bound or unbound
See Also:
getName(), getSession()

HttpSessionBindingEvent

public HttpSessionBindingEvent(HttpSession session,
                               String name,
                               Object value)
Constructs an event that notifies an object that it has been bound to or unbound from a session. To receive the event, the object must implement HttpSessionBindingListener.

Parameters:
session - the session to which the object is bound or unbound
name - the name with which the object is bound or unbound
See Also:
getName(), getSession()
Method Detail

getSession

public HttpSession getSession()
Return the session that changed.

Overrides:
getSession in class HttpSessionEvent

getName

public String getName()
Returns the name with which the attribute is bound to or unbound from the session.

Returns:
a string specifying the name with which the object is bound to or unbound from the session

getValue

public Object getValue()
Returns the value of the attribute that has been added, removed or replaced. If the attribute was added (or bound), this is the value of the attribute. If the attribute was removed (or unbound), this is the value of the removed attribute. If the attribute was replaced, this is the old value of the attribute.

Since:
2.3

Java EE 5 SDK

Submit a bug or feature

Copyright 2006 Sun Microsystems, Inc. All rights reserved.