Interface ProtocolListener

  • All Known Implementing Classes:
    ProtocolAdapter

    public interface ProtocolListener
    This listener interface is used in the Protocol class for error and exception reporting.

    The Protocol class provides an event for error reporting (see Protocol.addListener). The error event is only used when operating in asynchronous mode (see Protocol.isValidOption). When operating in normal blocking mode, the error event is never fired and exceptions are reported by throwing them.

    • Method Detail

      • onError

        void onError​(ErrorEvent e)
        This event is fired after an error occurred when operating in asynchronous mode.

        This event is fired when an error occurs in asynchronous mode (see Protocol.isValidOption(java.lang.String)). Instead of throwing exceptions when an operation has failed like in normal blocking mode, the asynchronous mode uses this error event for error reporting.

        Please note: Keep in mind that adding code to the event handlers which can lead to the error event can cause a presumably undesired recursive behavior.

        Parameters:
        e - The event argument for the event handler
        See Also:
        ErrorEvent