javafx.scene.media

Class MediaException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

javafx.scene.media.MediaException

All Implemented Interfaces:

java.io.Serializable

public final class MediaException
extends java.lang.RuntimeException

A MediaException describes a runtime error condition in a Media, MediaPlayer or MediaView.

Since:

JavaFX 2.0

See Also:

Media.onErrorProperty(), MediaView.onErrorProperty(), Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaException.Type Enumeration describing categories of errors.

Field Summary

Fields

Modifier and Type	Field and Description
private MediaException.Type	type What caused this error.

Constructor Summary

Constructors

Constructor and Description
MediaException(MediaException.Type type, java.lang.String message)
MediaException(MediaException.Type type, java.lang.String message, java.lang.Throwable t)
MediaException(MediaException.Type type, java.lang.Throwable t)

Method Summary

Modifier and Type	Method and Description
(package private) static MediaException.Type	errorCodeToType(int errorCode) Map MediaError codes to MediaException.Types.
(package private) static MediaException	exceptionToMediaException(java.lang.Exception e) converts Java exceptions into mediaErrors
(package private) static MediaException	getMediaException(java.lang.Object source, int errorCode, java.lang.String message)
MediaException.Type	getType() Retrieves the category into which this error falls.
(package private) static MediaException	haltException(java.lang.String message)
java.lang.String	toString() Returns a string representation of this MediaException object.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Field Detail

type

private final MediaException.Type type

What caused this error.

Constructor Detail

MediaException

MediaException(MediaException.Type type,
               java.lang.Throwable t)

MediaException

MediaException(MediaException.Type type,
               java.lang.String message,
               java.lang.Throwable t)

MediaException

MediaException(MediaException.Type type,
               java.lang.String message)

Method Detail

errorCodeToType

static MediaException.Type errorCodeToType(int errorCode)

Map MediaError codes to MediaException.Types.

Parameters:

errorCode - Error code from implementation layer.

Returns:

API level error type.

exceptionToMediaException

static MediaException exceptionToMediaException(java.lang.Exception e)

converts Java exceptions into mediaErrors

haltException

static MediaException haltException(java.lang.String message)

getMediaException

static MediaException getMediaException(java.lang.Object source,
                                        int errorCode,
                                        java.lang.String message)

getType

public MediaException.Type getType()

Retrieves the category into which this error falls.

Returns:

The type of this error

toString

public java.lang.String toString()

Returns a string representation of this MediaException object.

Overrides:

toString in class java.lang.Throwable

Returns:

a string representation of this MediaException object.