Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.media.mn8.event
Class mn8Exception  view mn8Exception download mn8Exception.java

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byorg.media.mn8.event.mn8Exception
All Implemented Interfaces:
java.io.Serializable

public class mn8Exception
extends java.lang.RuntimeException

The basic mn8 exception class.

In mn8 all signaling of user messages is done through exceptions. All mn8 exceptions are derived from this class, and having separate exception types for different kind of exceptions (general system errors and warnings, mn8 interpretation specific errors). In this way a user can choose the amount of information wanted, and use it's custom message handling utilities. Ex: general errors go on screen, mn8 warning go to email. For normal interpretation, all exceptions are caught by the LogManager and displayed on the system console.

Version:
$Revision: 1.1 $ $Date: 2001/08/06 08:42:06 $

Nested Class Summary
 
Nested classes inherited from class java.lang.Throwable
 
Field Summary
private  java.lang.Exception _generatorException
           
private  java.lang.String _messageId
           
private  java.lang.String _messageTypeId
           
private  java.lang.String _optionalInfo
           
private  java.lang.String _suplementaryInfo
           
 
Fields inherited from class java.lang.RuntimeException
 
Fields inherited from class java.lang.Throwable
 
Constructor Summary
mn8Exception(java.lang.String message)
           
mn8Exception(java.lang.String type_id, java.lang.String message_id)
           
mn8Exception(java.lang.String type_id, java.lang.String message_id, java.lang.String optional)
           
mn8Exception(java.lang.String type_id, java.lang.String message_id, java.lang.String optional, java.lang.String suplement)
           
 
Method Summary
 java.lang.Exception getGeneratorException()
           
 java.lang.String getMessage()
          Get the message associated with this Throwable.
 java.lang.String getMessageId()
           
 java.lang.String getMessageTypeId()
           
 java.lang.String getOptionalInfo()
           
 java.lang.String getSuplementaryInfo()
           
 void printStackTrace()
          Print a stack trace to the standard error stream.
 void printStackTrace(java.io.PrintStream s)
          Print a stack trace to the specified PrintStream.
 void printStackTrace(java.io.PrintWriter w)
          Prints the exception, the detailed message and the stack trace associated with this Throwable to the given PrintWriter.
 void setGeneratorException(java.lang.Exception initialException)
           
 void setMessageId(java.lang.String messageId)
           
 void setMessageTypeId(java.lang.String messageTypeId)
           
 void setOptionalInfo(java.lang.String optionalInfo)
           
 void setSuplementaryInfo(java.lang.String suplemantaryInfo)
           
 java.lang.String toString()
          Get a human-readable representation of this Throwable.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, setStackTrace
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

_messageTypeId

private java.lang.String _messageTypeId

_messageId

private java.lang.String _messageId

_optionalInfo

private java.lang.String _optionalInfo

_suplementaryInfo

private java.lang.String _suplementaryInfo

_generatorException

private java.lang.Exception _generatorException
Constructor Detail

mn8Exception

public mn8Exception(java.lang.String message)

mn8Exception

public mn8Exception(java.lang.String type_id,
                    java.lang.String message_id)

mn8Exception

public mn8Exception(java.lang.String type_id,
                    java.lang.String message_id,
                    java.lang.String optional,
                    java.lang.String suplement)

mn8Exception

public mn8Exception(java.lang.String type_id,
                    java.lang.String message_id,
                    java.lang.String optional)
Method Detail

setGeneratorException

public void setGeneratorException(java.lang.Exception initialException)

getGeneratorException

public java.lang.Exception getGeneratorException()

getMessage

public java.lang.String getMessage()
Description copied from class: java.lang.Throwable
Get the message associated with this Throwable.


setMessageTypeId

public void setMessageTypeId(java.lang.String messageTypeId)

getMessageTypeId

public java.lang.String getMessageTypeId()

setMessageId

public void setMessageId(java.lang.String messageId)

getMessageId

public java.lang.String getMessageId()

setOptionalInfo

public void setOptionalInfo(java.lang.String optionalInfo)

getOptionalInfo

public java.lang.String getOptionalInfo()

setSuplementaryInfo

public void setSuplementaryInfo(java.lang.String suplemantaryInfo)

getSuplementaryInfo

public java.lang.String getSuplementaryInfo()

toString

public java.lang.String toString()
Description copied from class: java.lang.Throwable
Get a human-readable representation of this Throwable. The detail message is retrieved by getLocalizedMessage(). Then, with a null detail message, this string is simply the object's class name; otherwise the string is getClass().getName() + ": " + message.


printStackTrace

public void printStackTrace(java.io.PrintStream s)
Description copied from class: java.lang.Throwable
Print a stack trace to the specified PrintStream. See Throwable.printStackTrace()>Throwable.printStackTrace() 55 for the sample format.


printStackTrace

public void printStackTrace(java.io.PrintWriter w)
Description copied from class: java.lang.Throwable
Prints the exception, the detailed message and the stack trace associated with this Throwable to the given PrintWriter. The actual output written is implemention specific. Use the result of getStackTrace() when more precise information is needed.

This implementation first prints a line with the result of this object's toString() method.
Then for all elements given by getStackTrace it prints a line containing three spaces, the string "at " and the result of calling the toString() method on the StackTraceElement object. If getStackTrace() returns an empty array it prints a line containing three spaces and the string "<<No stacktrace available>>".
Then if getCause() doesn't return null it adds a line starting with "Caused by: " and the result of calling toString() on the cause.
Then for every cause (of a cause, etc) the stacktrace is printed the same as for the top level Throwable except that as soon as all the remaining stack frames of the cause are the same as the the last stack frames of the throwable that the cause is wrapped in then a line starting with three spaces and the string "... X more" is printed, where X is the number of remaining stackframes.


printStackTrace

public void printStackTrace()
Description copied from class: java.lang.Throwable
Print a stack trace to the standard error stream. This stream is the current contents of System.err. The first line of output is the result of Throwable.toString()>Throwable.toString() 55 , and the remaining lines represent the data created by Throwable.fillInStackTrace()>Throwable.fillInStackTrace() 55 . While the format is unspecified, this implementation uses the suggested format, demonstrated by this example:
 public class Junk
 {
   public static void main(String args[])
   {
     try
       {
         a();
       }
     catch(HighLevelException e)
       {
         e.printStackTrace();
       }
   }
   static void a() throws HighLevelException
   {
     try
       {
         b();
       }
     catch(MidLevelException e)
       {
         throw new HighLevelException(e);
       }
   }
   static void b() throws MidLevelException
   {
     c();
   }
   static void c() throws MidLevelException
   {
     try
       {
         d();
       }
     catch(LowLevelException e)
       {
         throw new MidLevelException(e);
       }
   }
   static void d() throws LowLevelException
   {
     e();
   }
   static void e() throws LowLevelException
   {
     throw new LowLevelException();
   }
 }
 class HighLevelException extends Exception
 {
   HighLevelException(Throwable cause) { super(cause); }
 }
 class MidLevelException extends Exception
 {
   MidLevelException(Throwable cause)  { super(cause); }
 }
 class LowLevelException extends Exception
 {
 }
 

  HighLevelException: MidLevelException: LowLevelException
          at Junk.a(Junk.java:13)
          at Junk.main(Junk.java:4)
  Caused by: MidLevelException: LowLevelException
          at Junk.c(Junk.java:23)
          at Junk.b(Junk.java:17)
          at Junk.a(Junk.java:11)
          ... 1 more
  Caused by: LowLevelException
          at Junk.e(Junk.java:30)
          at Junk.d(Junk.java:27)
          at Junk.c(Junk.java:21)
          ... 3 more