Class TransportException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
express.mvp.myra.transport.TransportException
All Implemented Interfaces:
Serializable
public class TransportException extends RuntimeException
Unchecked exception thrown when transport operations fail.

This exception wraps I/O errors, connection failures, and protocol violations that occur during transport operations. It extends RuntimeException to avoid cluttering method signatures with checked exceptions.

Common Causes

  • Connection failures (refused, timeout, reset)
  • I/O errors during send/receive operations
  • Buffer pool exhaustion
  • io_uring ring overflow or syscall failures
  • Invalid state transitions (e.g., send before connect)

Error Recovery

When catching this exception, examine the message and cause to determine the appropriate recovery action. For io_uring backends, the message often includes errno codes and recovery hints from ErrnoHandler.

See Also:

  • Constructor Details

    • TransportException

      public TransportException(String message)
      Constructs a new transport exception with the specified message.
      Parameters:
      message - the detail message describing the failure

    • TransportException

      public TransportException(String message, Throwable cause)
      Constructs a new transport exception with the specified message and cause.
      Parameters:
      message - the detail message describing the failure
      cause - the underlying cause of the failure

    • TransportException

      public TransportException(Throwable cause)
      Constructs a new transport exception with the specified cause.
      Parameters:
      cause - the underlying cause of the failure