kotlinx.coroutines

Class CoroutineExceptionHandlerKt

kotlinx.coroutines.CoroutineExceptionHandlerKt

public class CoroutineExceptionHandlerKt

Method Summary

Modifier and Type	Method and Description
static CoroutineExceptionHandler	CoroutineExceptionHandler(kotlin.jvm.functions.Function2<? super error.NonExistentClass,? super java.lang.Throwable,kotlin.Unit> handler) Creates new interface CoroutineExceptionHandler instance.
static void	handleCoroutineException(NonExistentClass context, java.lang.Throwable exception, Job caller) Helper function for coroutine builder implementations to handle uncaught exception in coroutines.

Method Detail

handleCoroutineException

public static void handleCoroutineException(NonExistentClass context,
                                            java.lang.Throwable exception,
                                            Job caller)

Helper function for coroutine builder implementations to handle uncaught exception in coroutines.

It tries to handle uncaught exception in the following way: If current exception is CancellationException, it's ignored: CancellationException is a normal way to cancel coroutine.

If there is a interface Job in the context and it's not a caller, then Job.cancel is invoked. If invocation returned true, method terminates: now interface Job is responsible for handling an exception. Otherwise, If there is interface CoroutineExceptionHandler in the context, it is used. If it throws an exception during handling or is absent, all instances of interface CoroutineExceptionHandler found via ServiceLoader and Thread.uncaughtExceptionHandler are invoked

See Also:

interface Job, Job.cancel, interface Job, interface CoroutineExceptionHandler, interface CoroutineExceptionHandler, ServiceLoader, Thread.uncaughtExceptionHandler

CoroutineExceptionHandler

public static CoroutineExceptionHandler CoroutineExceptionHandler(kotlin.jvm.functions.Function2<? super error.NonExistentClass,? super java.lang.Throwable,kotlin.Unit> handler)

Creates new interface CoroutineExceptionHandler instance.

Parameters:

handler - a function which handles exception thrown by a coroutine

See Also:

interface CoroutineExceptionHandler