javax.microedition.content
Class ContentHandlerException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.io.IOException
              javax.microedition.content.ContentHandlerException

public class ContentHandlerException
extends IOException

A ContentHandlerException is thrown to report errors specific to registration and invocation of content handlers. Instances are immutable and thread safe.

Since:

BlackBerry API 4.3.0

Field Summary
static int	AMBIGUOUS The reason is AMBIGUOUS in a ContentHandlerException when an ID does not uniquely identify a single content handler application.
static int	CAPACITY_EXCEEDED The reason is CAPACITY_EXCEEDED in a ContentHandlerException when the implementation does not support longer IDs, or more actions, more types, or more suffixes than the minimums and the application exceeds the minimums.
static int	NO_REGISTERED_HANDLER The reason is NO_REGISTERED_HANDLER in a ContentHandlerException when there is no content handler registered of the requested combination of ID, type, suffix, and action.
static int	TYPE_UNKNOWN The reason is TYPE_UNKNOWN in a ContentHandlerException when the type is not available.

Constructor Summary

ContentHandlerException(String reason, int errcode)
Constructs a ContentHandlerException with a reason and error code.

Method Summary
int	getErrorCode() Returns the error code for the exception.

Methods inherited from class java.lang.Throwable

getMessage, printStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NO_REGISTERED_HANDLER

public static final int NO_REGISTERED_HANDLER

The reason is NO_REGISTERED_HANDLER in a ContentHandlerException when there is no content handler registered of the requested combination of ID, type, suffix, and action.

See Also:

Constant Field Values

Since:

BlackBerry API 4.3.0

TYPE_UNKNOWN

public static final int TYPE_UNKNOWN

The reason is TYPE_UNKNOWN in a ContentHandlerException when the type is not available.

See Also:

Constant Field Values

Since:

BlackBerry API 4.3.0

AMBIGUOUS

public static final int AMBIGUOUS

The reason is AMBIGUOUS in a ContentHandlerException when an ID does not uniquely identify a single content handler application.

See Also:

Constant Field Values

Since:

BlackBerry API 4.3.0

CAPACITY_EXCEEDED

public static final int CAPACITY_EXCEEDED

The reason is CAPACITY_EXCEEDED in a ContentHandlerException when the implementation does not support longer IDs, or more actions, more types, or more suffixes than the minimums and the application exceeds the minimums.

See Also:

Constant Field Values

Since:

BlackBerry API 7.0.0

Constructor Detail

ContentHandlerException

public ContentHandlerException(String reason,
                               int errcode)

Constructs a ContentHandlerException with a reason and error code. The error message string reason can later be retrieved by the java.lang.Throwable.getMessage method.

Parameters:

reason - the reason for the exception

errcode - the error code; one of ContentHandlerException.NO_REGISTERED_HANDLER, ContentHandlerException.AMBIGUOUS, ContentHandlerException.CAPACITY_EXCEEDED, or ContentHandlerException.TYPE_UNKNOWN

Throws:

IllegalArgumentException - if errcode is not one of ContentHandlerException.NO_REGISTERED_HANDLER, ContentHandlerException.AMBIGUOUS, @link #CAPACITY_EXCEEDED}, or ContentHandlerException.TYPE_UNKNOWN

Since:

BlackBerry API 4.3.0

Method Detail

getErrorCode

public int getErrorCode()

Returns the error code for the exception.

Returns:

the error code; one of ContentHandlerException.NO_REGISTERED_HANDLER, ContentHandlerException.AMBIGUOUS, ContentHandlerException.CAPACITY_EXCEEDED, or ContentHandlerException.TYPE_UNKNOWN

Since:

BlackBerry API 4.3.0