Class ChannelException

  • All Implemented Interfaces:
    Serializable

    public class ChannelException
    extends Exception
    A channel exception is thrown when an internal error happens somewhere in the channel.

    When a global error happens, the cause can be retrieved using getCause()

    If an application is sending a message and some of the recipients fail to receive it, the application can retrieve what recipients failed by using the getFaultyMembers() method. This way, an application will always know if a message was delivered successfully or not.

    See Also:
    Serialized Form
    • Constructor Detail

      • ChannelException

        public ChannelException()
        Constructor, creates a ChannelException
        See Also:
        Exception()
      • ChannelException

        public ChannelException​(String message)
        Constructor, creates a ChannelException with an error message
        Parameters:
        message - The error message
        See Also:
        Exception(String)
      • ChannelException

        public ChannelException​(String message,
                                Throwable cause)
        Constructor, creates a ChannelException with an error message and a cause
        Parameters:
        message - The error message
        cause - Throwable
        See Also:
        Exception(String,Throwable)
      • ChannelException

        public ChannelException​(Throwable cause)
        Constructor, creates a ChannelException with a cause
        Parameters:
        cause - Throwable
        See Also:
        Exception(Throwable)
    • Method Detail

      • addFaultyMember

        public boolean addFaultyMember​(Member mbr,
                                       Exception x)
        Adds a faulty member, and the reason the member failed.
        Parameters:
        mbr - Member
        x - Exception
        Returns:
        true if the member was added
      • addFaultyMember

        public int addFaultyMember​(ChannelException.FaultyMember[] mbrs)
        Adds a list of faulty members
        Parameters:
        mbrs - FaultyMember[]
        Returns:
        the number of members added
      • addFaultyMember

        public boolean addFaultyMember​(ChannelException.FaultyMember mbr)
        Adds a faulty member
        Parameters:
        mbr - FaultyMember
        Returns:
        true if the member was added
      • getFaultyMembers

        public ChannelException.FaultyMember[] getFaultyMembers()
        Returns an array of members that failed and the reason they failed.
        Returns:
        FaultyMember[]