Interface UDPAccessor


  • public interface UDPAccessor

    Allows sending of UDP commands, and adding or removal of UDP command listeners.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void addUDPCommandListener​(java.lang.String command, UDPCommandListener udpCommandListener)
      Adds the command listener for the specified command.
      boolean removeUDPCommandListener​(java.lang.String command, UDPCommandListener udpCommandListener)
      Removes the command listener for the specified command.
      void send​(java.lang.String commandAndArguments)
      Sends the specified command and arguments string to the default destination.
      void send​(java.lang.String commandAndArguments, java.net.InetAddress address, int port)
      Sends the specified command and arguments string to the specified address and port.
    • Method Detail

      • addUDPCommandListener

        void addUDPCommandListener​(java.lang.String command,
                                   UDPCommandListener udpCommandListener)

        Adds the command listener for the specified command. The listener will now be informed each time that command is executed.

        If a particular listener is added mulitple times for the same command, then it will be informed of a single execution of that command multiple times.

        A particular listener can be used to listen to multiple commands. If this is the case, then the listener can identify which command was executed from the first command argument - this is always the name of the command itself.

        Parameters:
        command - The command that the listener is being added for.
        udpCommandListener - The listener that should be informed when the command is executed.
      • removeUDPCommandListener

        boolean removeUDPCommandListener​(java.lang.String command,
                                         UDPCommandListener udpCommandListener)
                                  throws UDPCommandRemovalException

        Removes the command listener for the specified command. If the listener is successfully removed it will no longer be informed whenever that command is executed.

        If a listener has been added multiple times for the same command, only the first occurrence will be removed.

        Parameters:
        command - The command that the listener is being added for.
        udpCommandListener - The listener that should be informed when the command is executed.
        Returns:
        true if the command was successfully removed, otherwise false.
        Throws:
        UDPCommandRemovalException - If the last listener for a particular command is removed, and the implementation is unable to find the command to remove.
        UDPCommandRemovalException - If either the command or udpCommandListener arguments are null.
      • send

        void send​(java.lang.String commandAndArguments)
           throws UDPSendException

        Sends the specified command and arguments string to the default destination. The string should begin with the command, with the arguments included afterwards, separated with spaces.

        For example:

        send("memory_write")

        send("symbol_publish LON* NY* JPN*")

        Parameters:
        commandAndArguments - The command to send and its arguments, in a space separated list.
        Throws:
        UDPSendException - If the commandAndArguments argument is null.
      • send

        void send​(java.lang.String commandAndArguments,
                  java.net.InetAddress address,
                  int port)
           throws UDPSendException

        Sends the specified command and arguments string to the specified address and port. The string should begin with the command, with the arguments included afterwards, separated with spaces.

        For example:

        send("memory_write")

        send("symbol_publish LON* NY* JPN*")

        Parameters:
        commandAndArguments - The command to send and its arguments, in a space separated list.
        address - The address to send the command to
        port - The prot to send the command to
        Throws:
        UDPSendException - If the commandAndArguments argument is null.