Interface XQConnectionEventListener
-
public interface XQConnectionEventListener
An object that registers to be notified of events generated by aPooledXQConnection
object.The
XQConnectionEventListener
interface is implemented by a connection pooling component. A connection pooling component will usually be provided by an XQJ vendor or by another system software vendor. An XQJ implementation notifies anXQConnectionEventListener
object when an application is finished using a pooled connection with which the listener has registered. The notification occurs after the application calls the methodclose
on its representation of aPooledXQConnection
object. AnXQConnectionEventListener
is also notified when a connection error occurs due to the fact that thePooledXQConnection
is unfit for future use - the network connection to the XML datasource died, for example. The listener is notified by the XQJ implementation just before it throws anXQException
to the application using thePooledXQConnection
object.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
connectionClosed(XQConnectionEvent event)
Notifies thisXQConnectionEventListener
that the application has called the methodclose
on its representation of a pooled connection.void
connectionErrorOccurred(XQConnectionEvent event)
Notifies thisXQConnectionEventListener
that a fatal error has occurred and the pooled connection can no longer be used.
-
-
-
Method Detail
-
connectionClosed
void connectionClosed(XQConnectionEvent event)
Notifies thisXQConnectionEventListener
that the application has called the methodclose
on its representation of a pooled connection.- Parameters:
event
- an event object describing the source of the event
-
connectionErrorOccurred
void connectionErrorOccurred(XQConnectionEvent event)
Notifies thisXQConnectionEventListener
that a fatal error has occurred and the pooled connection can no longer be used. The XQJ implementation makes this notification just before it throws the application theXQException
contained in the givenXQConnectionEvent
object.- Parameters:
event
- an event object describing the source of the event and containing theXQException
that the XQJ implementation will throw
-
-