org.jmythapi.protocol
Class UnsupportedCommandException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.io.IOException
              org.jmythapi.protocol.ProtocolException
                  org.jmythapi.protocol.UnsupportedCommandException

All Implemented Interfaces:

Serializable

public class UnsupportedCommandException
extends ProtocolException

This exception is thrown if a command is used outside of its valid protocol-version range.

If a given command is supported by at least known protocol version, but is going to be sent to a backend not supporting the command, the backend connection will throw this exception.

The following utility method can be used to determine the valid protocol-version range for a given command:

    // the following will return the version range [9,-1)
    ProtocolVersionRange versionRange = CommandUtils.getCommandVersionRange(IMythCommand.GET_FREE_RECORDER_COUNT);
    System.out.println(versionRange);
 

In the above example the command GET_FREE_RECORDER_COUNT was introduced in protocol version 09 and is supported up to the current protocol version.
If the command is going to be send to a backend with a version lower than 09, then this exception will be thrown.

See Also:

ProtocolVersionRange, CommandUtils.getCommandVersionRange(String), Serialized Form

Constructor Summary

UnsupportedCommandException()

UnsupportedCommandException(String message)

Method Summary

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UnsupportedCommandException

public UnsupportedCommandException()

UnsupportedCommandException

public UnsupportedCommandException(String message)