org.jvoicexml.event.error
Class BadFetchError

java.lang.Object
  java.lang.Throwable
      org.jvoicexml.event.JVoiceXMLEvent
          org.jvoicexml.event.ErrorEvent
              org.jvoicexml.event.error.BadFetchError

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BadFetchProtocolResponsecodeError

public class BadFetchError
extends ErrorEvent

The interpreter context throws this event when a fetch of a document has failed and the interpreter context has reached a place in the document interpretation where the fetch result is required. Fetch failures result from unsupported scheme references, malformed URIs, client aborts, communication errors, timeouts, security violations, unsupported resource types, resource type mismatches, document parse errors, and a variety of errors represented by scheme-specific error codes.

If the interpreter context has speculatively prefetched a document and that document turns out not to be needed, error.badfetch is not thrown. Likewise if the fetch of an <audio> document fails and if there is a nested alternate <audio> document whose fetch then succeeds, or if there is nested alternate text, no error.badfetch occurs.
When an interpreter context is transitioning to a new document, the interpreter context throws error.badfetch on an error until the interpreter is capable of executing the new document, but again only at the point in time where the new document is actually needed, not before. Whether or not variable initialization is considered part of executing the new document is platform-dependent.

Version:

$Revision: 2476 $

Author:

Dirk Schnelle

See Also:

Serialized Form

Field Summary

static String

EVENT_TYPE The detail message.

Constructor Summary

BadFetchError()
Constructs a new event with the event type as its detail message.

BadFetchError(String message)
Constructs a new event with the specified detail message. the given detail message is expanded to the form <EVENT_TYPE>>: <message>.

BadFetchError(String message, Throwable cause)
Constructs a new event with the specified detail message and cause.

BadFetchError(Throwable cause)
Constructs a new event with the specified cause and a detail message of (cause==null ?

Method Summary

protected void	appendSpecificationDetails(StringBuilder str) Appends detail information to the type information.
String	getEventType() Get the event type of this event.

Methods inherited from class org.jvoicexml.event.JVoiceXMLEvent

getMessage

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

EVENT_TYPE

public static final String EVENT_TYPE

The detail message.

See Also:

Constant Field Values

Constructor Detail

BadFetchError

public BadFetchError()

Constructs a new event with the event type as its detail message. The cause is not initialized.

See Also:

getEventType()

BadFetchError

public BadFetchError(String message)

Constructs a new event with the specified detail message. the given detail message is expanded to the form <EVENT_TYPE>>: <message>. The cause is not initialized.

Parameters:

message - The detail message.

See Also:

getEventType()

BadFetchError

public BadFetchError(Throwable cause)

Constructs a new event with the specified cause and a detail message of (cause==null ? getEventType() : cause.toString()) (which typically contains the class and detail message of cause).

Parameters:

cause - The cause.

See Also:

getEventType()

BadFetchError

public BadFetchError(String message,
                     Throwable cause)

Constructs a new event with the specified detail message and cause.

Parameters:

message - The detail message.

cause - The cause.

Method Detail

appendSpecificationDetails

protected void appendSpecificationDetails(StringBuilder str)

Appends detail information to the type information.

Parameters:

str - type prefix.

getEventType

public final String getEventType()

Get the event type of this event.

Specified by:

getEventType in class JVoiceXMLEvent

Returns:

Event type.