Oracle Coherence for C++ API
Release 3.7.1.0

E22845-01

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.

Author:
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.
Returns:
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< String m_vsName
  The exception's name.
MemberView< ObjectArray m_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.

Parameters:
  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.