org.asteriskjava.manager

Class EventTimeoutException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.asteriskjava.manager.TimeoutException

org.asteriskjava.manager.EventTimeoutException

All Implemented Interfaces:

Serializable

public class EventTimeoutException
extends TimeoutException

An EventTimeoutException is thrown if a ManagerResponse or some ResponseEvents are not completely received within the expected time period.

This exception allows you to retrieve the partial result, that is the events that have been successfully received before the timeout occured.

Since:

0.2

Version:

$Id$

Author:

srt

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EventTimeoutException(String message, ResponseEvents partialResult) Creates a new EventTimeoutException with the given message and partial result.

Method Summary

Modifier and Type	Method and Description
ResponseEvents	getPartialResult() Returns the partial result that has been received before the timeout occured.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

EventTimeoutException

public EventTimeoutException(String message,
                             ResponseEvents partialResult)

Creates a new EventTimeoutException with the given message and partial result.

Parameters:

message - message with details about the timeout.

partialResult - the ResponseEvents object filled with the parts that have been received before the timeout occured.

Method Detail

getPartialResult

public ResponseEvents getPartialResult()

Returns the partial result that has been received before the timeout occured.

Note: Using the partial result in your application should be avoided wherever possible. This is only a hack to handle those versions of Asterisk that don't follow the Manager API conventions, for example by not sending the correct ActionCompleteEvent.

Returns:

the ResponseEvents object filled with the parts that have been received before the timeout occured. Note: The response attribute may be null when no response has been received.