FoundationsException (gov.va.med.vistalink

Object
- Throwable
- - Exception
  - - FoundationsException

All Implemented Interfaces:

FoundationsExceptionInterface, Serializable

Direct Known Subclasses:

InstitutionMapNotInitializedException, InstitutionMappingNotFoundException, RpcResponseTypeIsNotXmlException, VistaKernelHashCountLimitExceededException, VistaLinkCacheException, VistaLinkConnectionFactoryNotFoundException, VistaLinkFaultException, VistaSocketException
```
public class FoundationsException
extends Exception
implements FoundationsExceptionInterface
```
FoundationsException provides adds nested exception functionality to standard exceptions. This functionality is no longer necessary starting in Java 1.4, whose java.lang.Throwable class introduces built-in support for nested exceptions. However, for backwards compatibility, VistALink exceptions still inherit from this class. Implements methods to return nested exception message as part of current exception message.
The nested exception, uses throwable so it can encapsulate all types of exceptions even Error exceptions.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`FoundationsException()` Default constructor.
`FoundationsException(String msg)` Constructor.
`FoundationsException(String msg, Throwable nestedException)` Constructor.
`FoundationsException(Throwable nestedException)` Constructor.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`String`	`getFullStackTrace()` Deprecated. Use Throwable.getStackTrace() instead.
`String`	`getMessage()` Returns the detail message, including nested messages from the nested exceptions.
`Throwable`	`getNestedException()` Deprecated. Use Throwable.getCause() instead.
`protected String`	`getOriginalMessage()` Returns oringal message that was passed into the exception constructor.
`void`	`printStackTrace()` Prints the composite message and full embedded stack trace to `System.err`.
`void`	`printStackTrace(PrintStream ps)` Prints the composite message and full embedded stack trace to the specified stream `ps`.
`void`	`printStackTrace(PrintWriter pw)` Prints the composite message and full embedded stack trace to the specified print writer `pw`

Methods inherited from class Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - FoundationsException
```
public FoundationsException()
```
    Default constructor.
  - FoundationsException
```
public FoundationsException(String msg)
```
    Constructor.
    
    Parameters:
    
    msg -
    
    See Also:
    
    Throwable.Throwable(java.lang.String)
  - FoundationsException
```
public FoundationsException(Throwable nestedException)
```
    Constructor.
    
    Parameters:
    
    nestedException - exception to nest in new FoundationsException
  - FoundationsException
```
public FoundationsException(String msg,
                            Throwable nestedException)
```
    Constructor.
    
    Parameters:
    
    msg - Exception message
    
    nestedException - exception to nest in new FoundationsException
- Method Detail
  - getNestedException
```
public Throwable getNestedException()
```
    Deprecated. Use Throwable.getCause() instead.
    
    Return nested exception that is wrapped within this exception.
    
    Specified by:
    
    getNestedException in interface FoundationsExceptionInterface
    
    Returns:
    
    nested exception
  - getOriginalMessage
```
protected String getOriginalMessage()
```
    Returns oringal message that was passed into the exception constructor. Does not perform message discovery from the nested exception. Only to be used by the descendants of this class.
    
    Returns:
    
    String
  - getMessage
```
public String getMessage()
```
    Returns the detail message, including nested messages from the nested exceptions.
    
    Overrides:
    
    getMessage in class Throwable
    
    See Also:
    
    Throwable.getMessage()
  - printStackTrace
```
public void printStackTrace(PrintStream ps)
```
    Prints the composite message and full embedded stack trace to the specified stream ps.
    
    Overrides:
    
    printStackTrace in class Throwable
    
    Parameters:
    
    ps - the print stream
    
    See Also:
    
    Throwable.printStackTrace(java.io.PrintStream)
  - printStackTrace
```
public void printStackTrace(PrintWriter pw)
```
    Prints the composite message and full embedded stack trace to the specified print writer pw
    
    Overrides:
    
    printStackTrace in class Throwable
    
    Parameters:
    
    pw - the print writer
    
    See Also:
    
    Throwable.printStackTrace(java.io.PrintWriter)
  - printStackTrace
```
public void printStackTrace()
```
    Prints the composite message and full embedded stack trace to System.err.
    
    Overrides:
    
    printStackTrace in class Throwable
    
    See Also:
    
    Throwable.printStackTrace()
  - getFullStackTrace
```
public String getFullStackTrace()
```
    Deprecated. Use Throwable.getStackTrace() instead.
    
    Returns the composite message and full embedded stack trace trace
    
    Specified by:
    
    getFullStackTrace in interface FoundationsExceptionInterface
    
    Returns:
    
    full stack trace String
    
    See Also:
    
    FoundationsExceptionInterface.getFullStackTrace()

Class FoundationsException

Constructor Summary

Method Summary

Methods inherited from class Throwable

Methods inherited from class Object

Constructor Detail

FoundationsException

FoundationsException

FoundationsException

FoundationsException

Method Detail

getNestedException

getOriginalMessage

getMessage

printStackTrace

printStackTrace

printStackTrace

getFullStackTrace