net.rim.plazmic.mediaengine
Class MediaException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by 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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.