Package tlschannel

Class NeedsReadException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

tlschannel.TlsChannelFlowControlException

tlschannel.WouldBlockException

tlschannel.NeedsReadException

All Implemented Interfaces:

Serializable

public class NeedsReadException
extends WouldBlockException

This exception signals the caller that the operation cannot continue because bytesProduced need to be read from the underlying ByteChannel, the channel is non-blocking and there are no bytesProduced available. The caller should try the operation again, either with the channel in blocking mode of after ensuring that bytesProduced are ready.

For SocketChannels, a Selector can be used to find out when the method should be retried.

Caveat: Any TlsChannel I/O method can throw this exception. In particular, write may want to read data. This is because TLS handshakes may occur at any time (initiated by either the client or the server).

This exception is akin to the SSL_ERROR_WANT_READ error code used by OpenSSL.

See Also:

• OpenSSL error documentation
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
NeedsReadException()

Method Summary

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

NeedsReadException

public NeedsReadException()