Oracle Coherence for C++ API


PortableException Class Reference

#include <coherence/io/pof/PortableException.hpp>

Inherits RuntimeException.

Inherited by RequestTimeoutException.

List of all members.

Detailed Description

A PortableException is an exception that allows information about a remote exception or error to be serialized and deserialized to/from a POF stream.

jh,mf 2008.01.23

Public Types

typedef spec::Handle Handle
 PortableException Handle definition.
typedef spec::View View
 PortableException View definition.
typedef spec::Holder Holder
 PortableException Holder definition.

Public Member Functions

virtual void readExternal (PofReader::Handle hIn)
virtual void writeExternal (PofWriter::Handle hOut) const
virtual String::View getName () const
 Return the name of the exception.
virtual ObjectArray::View getStackTrace () const
 Return the stack trace for the exception.

an array of StackTraceElements.

Protected Member Functions

 PortableException (String::View vsMessage=String::null_string, Exception::View ve=NULL)
 Construct a PortableException from a Throwable object and an additional description.
virtual void onInit ()
 {Event called once the Object has finished being constructed.

Specifically when the first attachment is made. This provides a safe point at which Handles/Views to "this" can be created. It is not safe to create Handles/Views to an Object from within its constructor, thus any operations which rely upon this should be deferred until the onInit event is triggered.

As with all event methods any derived implementation should include a call to the super class's implementation. Specifically delegation to Object::onInit() must eventually occur or an IllegalStateException will result.

The default implementation calls the onInit() method of each of the Object's SmartMembers.}

Protected Attributes

MemberView< Stringm_vsName
 The exception's name.
MemberView< ObjectArraym_vaStackRemote
 A raw representaion of the remote stack trace for this exception.

Constructor & Destructor Documentation

PortableException ( String::View  vsMessage = String::null_string,
    Exception::View  ve = NULL 
  )    [protected]

Construct a PortableException from a Throwable object and an additional description.

 vsMessage the additional description
 ve the cause exception

The documentation for this class was generated from the following file:
Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.