js.lang

Interface AsyncExceptionListener

public interface AsyncExceptionListener

Asynchronous exception listener. When asynchronous logic is executed from threads, loops, timers or tasks, caller has no chance to catch exceptions, of course because are thrown in a separated execution thread. This listener is used just for that; its hook method is invoked when asynchronous logic fails. It is asynchronous logic responsibility to trigger asynchronous exception event.

It is implementation detail if exception listener is global per application or create new instance for every asynchronous logic. Here is an example of using exception lister with looper thread. LooperThread takes care to trigger onAsyncException(Throwable).

 class DemoLooper implements Looper, AsyncExceptionListener {
        private LooperThread thread;
 
        DemoLooper() {
                tread = new LooperThread(this);
                ...
        }
 
        void onAsyncException(Throwable throwable) {
                // handle loop iteration exception
        }
 }
 

If user code creates its own thread is recommended to invoke this listener like in sample code below.

        public void run() {
                try {
                        ...
                } catch (Throwable throwable) {
                        listener.onAsyncException(throwable);
                }
        }
 

Version:

final

Author:

Iulian Rotaru

Method Summary

Modifier and Type	Method and Description
void	onAsyncException(Throwable throwable) Hook method executed when an asynchronous logic fails.

Method Detail

onAsyncException

void onAsyncException(Throwable throwable)

Hook method executed when an asynchronous logic fails.

Parameters:

throwable - exception generated by an asynchronous logic.