javax.telephony.media
Class DisconnectedException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--javax.telephony.media.MediaRuntimeException
                          |
                          +--javax.telephony.media.DisconnectedException

All Implemented Interfaces:

java.io.Serializable

public class DisconnectedException

extends MediaRuntimeException

Thrown by any resource method if the operation stops because the associated Terminal is in the Connection.DISCONNECTED state.

Resource operations are stopped or disallowed if the Connection to the Terminal associated with the MediaService is DISCONNECTED.

If the Connection is disconnected, then the resource method throws a DisconnectedException with
getResourceEvent().getError() equals e_Disconnected.

If the Connection becomes disconnected after the method has started, then the ResourceEvent may contain additional information.

Since:

JTAPI-1.3

See Also:

Serialized Form

Constructor Summary

DisconnectedException(ResourceEvent event)
Construct a DisconnectedException with the ResourceEvent and no detail message.

DisconnectedException(java.lang.String str, ResourceEvent event)
Construct a DisconnectedException with the specified detail message and ResourceEvent.

Method Summary

ResourceEvent

getResourceEvent() Extract the underlying ResourceEvent from this DisconnectedException.

Methods inherited from class javax.telephony.media.MediaRuntimeException

getEvent

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DisconnectedException

public DisconnectedException(ResourceEvent event)

Construct a DisconnectedException with the ResourceEvent and no detail message.

Parameters:

event - a ResourceEvent that indicates DISCONNECTED.

DisconnectedException

public DisconnectedException(java.lang.String str,
                             ResourceEvent event)

Construct a DisconnectedException with the specified detail message and ResourceEvent.

Parameters:

str - the detail message.

event - a ResourceEvent that indicates DISCONNECTED.

Method Detail

getResourceEvent

public ResourceEvent getResourceEvent()

Extract the underlying ResourceEvent from this DisconnectedException. Application uses standard ResourceEvent accessors on the event.

If an ongoing media operation was terminated, this ResourceEvent contains getQualifier() = q_Disconnected. If a new media operation can not be started, this ResourceEvent contains getError() equals e_Disconnected.

Returns:

a ResourceEvent that indicates DISCONNECTED.