-
- All Superinterfaces:
- EventListener
public interface AsyncListener extends EventListener
Listener that will be notified in the event that an asynchronous operation initiated on a ServletRequest to which the listener had been added has completed, timed out, or resulted in an error.- Since:
- Servlet 3.0
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description voidonComplete(AsyncEvent event)Notifies this AsyncListener that an asynchronous operation has been completed.voidonError(AsyncEvent event)Notifies this AsyncListener that an asynchronous operation has failed to complete.voidonStartAsync(AsyncEvent event)Notifies this AsyncListener that a new asynchronous cycle is being initiated via a call to one of theServletRequest.startAsync()methods.voidonTimeout(AsyncEvent event)Notifies this AsyncListener that an asynchronous operation has timed out.
-
-
-
Method Detail
-
onComplete
void onComplete(AsyncEvent event) throws IOException
Notifies this AsyncListener that an asynchronous operation has been completed.The
AsyncContextcorresponding to the asynchronous operation that has been completed may be obtained by callinggetAsyncContexton the given event.In addition, if this AsyncListener had been registered via a call to
AsyncContext.addListener(AsyncListener, ServletRequest, ServletResponse), the supplied ServletRequest and ServletResponse objects may be retrieved by callinggetSuppliedRequestandgetSuppliedResponse, respectively, on the given event.- Parameters:
event- the AsyncEvent indicating that an asynchronous operation has been completed- Throws:
IOException- if an I/O related error has occurred during the processing of the given AsyncEvent
-
onTimeout
void onTimeout(AsyncEvent event) throws IOException
Notifies this AsyncListener that an asynchronous operation has timed out.The
AsyncContextcorresponding to the asynchronous operation that has timed out may be obtained by callinggetAsyncContexton the given event.In addition, if this AsyncListener had been registered via a call to
AsyncContext.addListener(AsyncListener, ServletRequest, ServletResponse), the supplied ServletRequest and ServletResponse objects may be retrieved by callinggetSuppliedRequestandgetSuppliedResponse, respectively, on the given event.- Parameters:
event- the AsyncEvent indicating that an asynchronous operation has timed out- Throws:
IOException- if an I/O related error has occurred during the processing of the given AsyncEvent
-
onError
void onError(AsyncEvent event) throws IOException
Notifies this AsyncListener that an asynchronous operation has failed to complete.The
AsyncContextcorresponding to the asynchronous operation that failed to complete may be obtained by callinggetAsyncContexton the given event.In addition, if this AsyncListener had been registered via a call to
AsyncContext.addListener(AsyncListener, ServletRequest, ServletResponse), the supplied ServletRequest and ServletResponse objects may be retrieved by callinggetSuppliedRequestandgetSuppliedResponse, respectively, on the given event.- Parameters:
event- the AsyncEvent indicating that an asynchronous operation has failed to complete- Throws:
IOException- if an I/O related error has occurred during the processing of the given AsyncEvent
-
onStartAsync
void onStartAsync(AsyncEvent event) throws IOException
Notifies this AsyncListener that a new asynchronous cycle is being initiated via a call to one of theServletRequest.startAsync()methods.The
AsyncContextcorresponding to the asynchronous operation that is being reinitialized may be obtained by callinggetAsyncContexton the given event.In addition, if this AsyncListener had been registered via a call to
AsyncContext.addListener(AsyncListener, ServletRequest, ServletResponse), the supplied ServletRequest and ServletResponse objects may be retrieved by callinggetSuppliedRequestandgetSuppliedResponse, respectively, on the given event.This AsyncListener will not receive any events related to the new asynchronous cycle unless it registers itself (via a call to
AsyncContext.addListener(javax.servlet.AsyncListener)) with the AsyncContext that is delivered as part of the given AsyncEvent.- Parameters:
event- the AsyncEvent indicating that a new asynchronous cycle is being initiated- Throws:
IOException- if an I/O related error has occurred during the processing of the given AsyncEvent
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/servlet/AsyncListener.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.