org.jvoicexml.event.error
Class BadFetchError

java.lang.Object
  extended by java.lang.Throwable
      extended by org.jvoicexml.event.JVoiceXMLEvent
          extended by org.jvoicexml.event.ErrorEvent
              extended by 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.


Copyright © 2005-2010JVoiceXML group.