Package tlschannel

Class NeedsTaskException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

tlschannel.TlsChannelFlowControlException

tlschannel.NeedsTaskException

All Implemented Interfaces:

Serializable

public class NeedsTaskException
extends TlsChannelFlowControlException

This exception signals the caller that the operation could not continue because a CPU-intensive operation (typically a TLS handshaking) needs to be executed and the TlsChannel is configured to not run tasks. This allows the application to run these tasks in some other threads, in order to not slow the selection loop. The method that threw the exception should be retried once the task supplied by getTask() is executed and finished.

This exception is akin to the SSL_ERROR_WANT_ASYNC error code used by OpenSSL (but note that in OpenSSL, the task is executed by the library, while with the TlsChannel, the calling code is responsible for the execution).

See Also:

• OpenSSL error documentation
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
NeedsTaskException(Runnable task)

Method Summary

Modifier and Type	Method	Description
Runnable	getTask()

Methods inherited from class tlschannel.TlsChannelFlowControlException

fillInStackTrace

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

NeedsTaskException

public NeedsTaskException(Runnable task)

Method Details

getTask

public Runnable getTask()