EventObject

AI-generated Key Takeaways

• EventObject is the root class for all event state objects in Java and provides information about the event source.

• It includes a constructor to initialize the event with its source object and methods to retrieve the source and generate a string representation of the event.

• EventObject is serializable, allowing it to be persisted and transmitted across networks.

• Several direct and indirect subclasses, such as ConnectionEvent and PropertyChangeEvent, extend EventObject for specific event types.

public class EventObject extends Object
implements Serializable

Known Direct Subclasses ConnectionEvent, HandshakeCompletedEvent, PropertyChangeEvent, RowSetEvent, SSLSessionBindingEvent, StatementEvent ConnectionEvent An Event object that provides information about the source of a connection-related event.  HandshakeCompletedEvent This event indicates that an SSL handshake completed on a given SSL connection.  PropertyChangeEvent A "PropertyChange" event gets delivered whenever a bean changes a "bound" or "constrained" property.  RowSetEvent An Event object generated when an event occurs to a RowSet object.  SSLSessionBindingEvent This event is propagated to a SSLSessionBindingListener.  StatementEvent A StatementEvent is sent to all StatementEventListeners which were registered with a PooledConnection.

Known Indirect Subclasses IndexedPropertyChangeEvent IndexedPropertyChangeEvent An "IndexedPropertyChange" event gets delivered whenever a component that conforms to the JavaBeans™ specification (a "bean") changes a bound indexed property.

The root class from which all event state objects shall be derived.

All Events are constructed with a reference to the object, the "source", that is logically deemed to be the object upon which the Event in question initially occurred upon.

Field Summary

protected Object

source

The object on which the Event initially occurred.

Public Constructor Summary

EventObject(Object source) Constructs a prototypical Event.

Public Method Summary

Object	getSource() The object on which the Event initially occurred.
String	toString() Returns a String representation of this EventObject.

Inherited Method Summary

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Fields

protected Object source

The object on which the Event initially occurred.

Public Constructors

public EventObject (Object source)

Constructs a prototypical Event.

Parameters

source	The object on which the Event initially occurred.

Throws

IllegalArgumentException	if source is null.

Public Methods

public Object getSource ()

The object on which the Event initially occurred.

Returns

• The object on which the Event initially occurred.

public String toString ()

Returns a String representation of this EventObject.

Returns

• A a String representation of this EventObject.