Visit Platform at http://www.platform.com

Main Page   Class Hierarchy   Compound List   Compound Members  

FatalException Class Reference

Thrown to indicate a fatal error has occurred in the service. More...

Inheritance diagram for FatalException:

SoamException List of all members.

Public Methods

 FatalException (void) throw ()
 Creates an exception with no error message.

 FatalException (const char *errorDescription, int errorCode=0) throw ()
 Creates an exception with an error message.

FatalException & operator= (const FatalException &rhs)
 The assignment operator.

void applyCustomizedDebugAction (bool shouldApply)
 Specifies whether to apply the customizedDebugAction when this exception is thrown.


Detailed Description

Thrown to indicate a fatal error has occurred in the service.

After a FatalException has occurred, the service request will not be retried on other compute hosts.

For more details, please refer to the Application Development Guide.

If a pointer to a FatalException object is thrown within the service, the memory it is pointing to will be freed automatically using the delete operator.

If your exception must be created on the heap then it is recommended that a smart pointer be thrown instead of a raw pointer to prevent any ambiguity.

eg.

FatalExceptionPtr ex = new FatalException("A fatal exception has occured ...");
...
throw ex;

NOTE :

See also:
FatalExceptionPtr , SoamException


Constructor & Destructor Documentation

FatalException void    throw ()
 

Creates an exception with no error message.

FatalException const char *    errorDescription,
int    errorCode = 0
throw ()
 

Creates an exception with an error message.


Member Function Documentation

FatalException& operator= const FatalException &    rhs
 

The assignment operator.

This method will safely assign the exception being passed to the current exception.

Returns:
a reference to the current object.

void applyCustomizedDebugAction bool    shouldApply [virtual]
 

Specifies whether to apply the customizedDebugAction when this exception is thrown.

This method can be used to specify whether to apply the customizedDebugAction, specified in the Service > Control > Method > Exception section of the application profile, when this exception is thrown. This behavior is applicable only if debugSetting="customized" in the Service section of the application profile. By default, if you do not call this method, the customizedDebugAction is applied when this exception is thrown.

You can use this method when you are throwing an expected exception and do not need to debug it. For example, if the customizedDebugAction="writeServiceEventReplayFiles" then you can avoid the overhead of creating unnecessary SERL files by calling applyCustomizedDebugAction(false) on the exception before throwing it.

Parameters:
shouldApply  [IN] -- Flag to indicate whether to apply customizedDebugAction.

Reimplemented from SoamException.



     
Date Modified: 3 Nov 2008
Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Platform Computing. Accelerating Intelligence(TM).
Copyright © 2001-2008 Platform Computing Corporation. All rights reserved.