net.rim.plazmic.mediaengine
Class MediaException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          net.rim.plazmic.mediaengine.MediaException

Deprecated. Use javax.microedition.m2g instead of MediaEngine.

public class MediaException
extends Exception

Contains the functionality for all exceptions thrown when an exceptional condition occurs during playback or loading of media.

Since:

BlackBerry API 3.7.0

Field Summary
static int	CHECKSUM_MISMATCH Deprecated. Represents an error that occurs when the checksum fails.
static int	INTERRUPTED_DOWNLOAD Deprecated. Represents an error that occurs when the requested download operation was cancelled.
static int	INVALID_HEADER Deprecated. Represents an error that occurs when the requested media format is supported but the header is corrupted or invalid
static int	OUT_OF_BOUNDS Deprecated. Represents an error that occurs when an array index is out of bounds or when reading from an input stream after EOF.
static int	REQUEST_TIMED_OUT Deprecated. Represents an error that occurs when the request timed out.
static int	UNSUPPORTED_MEDIA Deprecated. Represents an error that occurs when the current version of the media engine is not compatible with a requested feature.
static int	UNSUPPORTED_TYPE Deprecated. Represents an error that occurs when the requested format is not supported.
static int	UPGRADE_MEDIA Deprecated. Represents an error that occurs when the current version of the media engine no longer supports a requested feature.
static int	UPGRADE_PLAYER Deprecated. Represents an error that occurs when the current version of the media engine is not compatible with a requested feature.

Constructor Summary

MediaException()
Deprecated. Constructs a MediaException with no specified detail message or error code.

MediaException(int code)
Deprecated. Constructs a MediaException given an error code.

MediaException(int code, String msg)
Deprecated. Constructs a MediaException given both an error code and detailed message describing the cause of the exception.

MediaException(String msg)
Deprecated. Constructs a MediaException with a detailed message describing the circumstances of the exception.

Method Summary
int	getCode() Deprecated. Returns the current error code.

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

UPGRADE_PLAYER

public static final int UPGRADE_PLAYER

Deprecated.

Represents an error that occurs when the current version of the media engine is not compatible with a requested feature. Occurs when the version of the media is too high for the Media Player to play back the media.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

UPGRADE_MEDIA

public static final int UPGRADE_MEDIA

Deprecated.

Represents an error that occurs when the current version of the media engine no longer supports a requested feature. Occurs when the version of the media is too low for the Media Player to play back the media.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

UNSUPPORTED_MEDIA

public static final int UNSUPPORTED_MEDIA

Deprecated.

Represents an error that occurs when the current version of the media engine is not compatible with a requested feature. Occurs when the version of the media is not supported by the Media Player to play back the media.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.0

INVALID_HEADER

public static final int INVALID_HEADER

Deprecated.

Represents an error that occurs when the requested media format is supported but the header is corrupted or invalid

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

OUT_OF_BOUNDS

public static final int OUT_OF_BOUNDS

Deprecated.

Represents an error that occurs when an array index is out of bounds or when reading from an input stream after EOF.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

INTERRUPTED_DOWNLOAD

public static final int INTERRUPTED_DOWNLOAD

Deprecated.

Represents an error that occurs when the requested download operation was cancelled.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

REQUEST_TIMED_OUT

public static final int REQUEST_TIMED_OUT

Deprecated.

Represents an error that occurs when the request timed out.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

UNSUPPORTED_TYPE

public static final int UNSUPPORTED_TYPE

Deprecated.

Represents an error that occurs when the requested format is not supported.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

CHECKSUM_MISMATCH

public static final int CHECKSUM_MISMATCH

Deprecated.

Represents an error that occurs when the checksum fails.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

Constructor Detail

MediaException

public MediaException()

Deprecated.

Constructs a MediaException with no specified detail message or error code.

This is the default exception constructor.

Since:

BlackBerry API 3.7.0

MediaException

public MediaException(String msg)

Deprecated.

Constructs a MediaException with a detailed message describing the circumstances of the exception.

Parameters:

msg - A description of the cause of the exception.

Since:

BlackBerry API 3.7.0

MediaException

public MediaException(int code)

Deprecated.

Constructs a MediaException given an error code.

Parameters:

code - An integer representing the error code that caused the exception.

Since:

BlackBerry API 3.7.0

MediaException

public MediaException(int code,
                      String msg)

Deprecated.

Constructs a MediaException given both an error code and detailed message describing the cause of the exception.

Parameters:

code - A message describing the cause of the exception.

msg - A message describing the cause of the exception.

Since:

BlackBerry API 3.7.0

Method Detail

getCode

public int getCode()

Deprecated.

Returns the current error code.

If the returned code is >= 200, the code represents a standard HTTP response code.

Returns:

An integer representing the error code.

Since:

BlackBerry API 3.7.0