Package javax.xml.xquery
Interface XQConnectionEventListener
-
public interface XQConnectionEventListenerAn object that registers to be notified of events generated by aPooledXQConnectionobject. TheXQConnectionEventListenerinterface 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 anXQConnectionEventListenerobject when an application is finished using a pooled connection with which the listener has registered. The notification occurs after the application calls the methodcloseon its representation of aPooledXQConnectionobject. AnXQConnectionEventListeneris also notified when a connection error occurs due to the fact that thePooledXQConnectionis 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 anXQExceptionto the application using thePooledXQConnectionobject.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidconnectionClosed(XQConnectionEvent event)Notifies thisXQConnectionEventListenerthat the application has called the methodcloseon its representation of a pooled connection.voidconnectionErrorOccurred(XQConnectionEvent event)Notifies thisXQConnectionEventListenerthat a fatal error has occurred and the pooled connection can no longer be used.
-
-
-
Method Detail
-
connectionClosed
void connectionClosed(XQConnectionEvent event)
Notifies thisXQConnectionEventListenerthat the application has called the methodcloseon its representation of a pooled connection.- Parameters:
event- an event object describing the source of the event
-
connectionErrorOccurred
void connectionErrorOccurred(XQConnectionEvent event)
Notifies thisXQConnectionEventListenerthat 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 theXQExceptioncontained in the givenXQConnectionEventobject.- Parameters:
event- an event object describing the source of the event and containing theXQExceptionthat the XQJ implementation will throw
-
-