< prev index next >

src/java.naming/share/classes/javax/naming/event/package.html

Print this page




 100 
 101 <h4>Exception Handling</h4>
 102 
 103 When a listener registers for events with a context, the context might
 104 need to do some internal processing in order to collect information
 105 required to generate the events.  The context, for example, might need
 106 to make a request to the server to register interest in changes
 107 on the server that will eventually be translated into events.
 108 If an exception occurs that prevents information about the events from
 109 being collected, the listener will never be notified of the events.
 110 When such an exception occurs, a <code>NamingExceptionEvent</code> is
 111 fired to notify the listener. The listener's
 112 <code>namingExceptionThrown()</code> method is invoked, as shown in the
 113 sample code above,
 114 and the listener is automatically deregistered.
 115 
 116 <h2>Package Specification</h2>
 117 
 118 
 119 The JNDI API Specification and related documents can be found in the
 120 <a href="../../../../technotes/guides/jndi/index.html">JNDI documentation</a>.
 121 
 122 @since 1.3
 123 
 124 </body>
 125 </html>


 100 
 101 <h4>Exception Handling</h4>
 102 
 103 When a listener registers for events with a context, the context might
 104 need to do some internal processing in order to collect information
 105 required to generate the events.  The context, for example, might need
 106 to make a request to the server to register interest in changes
 107 on the server that will eventually be translated into events.
 108 If an exception occurs that prevents information about the events from
 109 being collected, the listener will never be notified of the events.
 110 When such an exception occurs, a <code>NamingExceptionEvent</code> is
 111 fired to notify the listener. The listener's
 112 <code>namingExceptionThrown()</code> method is invoked, as shown in the
 113 sample code above,
 114 and the listener is automatically deregistered.
 115 
 116 <h2>Package Specification</h2>
 117 
 118 
 119 The JNDI API Specification and related documents can be found in the
 120 {@extLink jndi_overview JNDI documentation}.
 121 
 122 @since 1.3
 123 
 124 </body>
 125 </html>
< prev index next >