Mercurial > projects > dwt-mac

comparison dwt/DWTException.d @ 0:380af2bdd8e5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Upload of whole dwt tree
author Jacob Carlborg <doob@me.com> <jacob.carlborg@gmail.com>
date Sat, 09 Aug 2008 17:00:02 +0200
parents
children 8b48be5454ce
comparison
equal deleted inserted replaced
-1:000000000000 0:380af2bdd8e5
1 /*******************************************************************************
2 * Copyright (c) 2000, 2005 IBM Corporation and others.
3 * All rights reserved. This program and the accompanying materials
4 * are made available under the terms of the Eclipse Public License v1.0
5 * which accompanies this distribution, and is available at
6 * http://www.eclipse.org/legal/epl-v10.html
7 *
8 * Contributors:
9 * IBM Corporation - initial API and implementation
10 *
11 * Port to the D Programming language:
12 * Jacob Carlborg <jacob.carlborg@gmail.com>
13 *******************************************************************************/
14 module dwt.DWTError;
15
16 import dwt.DWTError;
17 import dwt.DWT;
18
19 import dwt.internal.Library;
20
21 import dwt.dwthelper.utils;
22
23 /**
24 * This runtime exception is thrown whenever a recoverable error
25 * occurs internally in DWT. The message text and error code
26 * provide a further description of the problem. The exception
27 * has a <code>throwable</code> field which holds the underlying
28 * exception that caused the problem (if this information is
29 * available (i.e. it may be null)).
30 * <p>
31 * DWTExceptions are thrown when something fails internally,
32 * but DWT is left in a known stable state (eg. a widget call
33 * was made from a non-u/i thread, or there is failure while
34 * reading an Image because the source file was corrupt).
35 * </p>
36 *
37 * @see DWTError
38 */
39
40 public class DWTException : Exception {
41 /**
42 * The DWT error code, one of DWT.ERROR_*.
43 */
44 public int code;
45
46 /**
47 * The underlying throwable that caused the problem,
48 * or null if this information is not available.
49 */
50 public Exception throwable (Exception e) {
51 this.next = e;
52 return this.next;
53 }
54
55 public Exception throwable () {
56 return this.next;
57 }
58
59 static final long serialVersionUID = 3257282552304842547L;
60
61 /**
62 * Constructs a new instance of this class with its
63 * stack trace filled in. The error code is set to an
64 * unspecified value.
65 */
66 public this () {
67 this(DWT.ERROR_UNSPECIFIED);
68 }
69
70 /**
71 * Constructs a new instance of this class with its
72 * stack trace and message filled in. The error code is
73 * set to an unspecified value. Specifying <code>null</code>
74 * as the message is equivalent to specifying an empty String.
75 *
76 * @param message the detail message for the exception
77 */
78 public this (String message) {
79 this(DWT.ERROR_UNSPECIFIED, message);
80 }
81
82 /**
83 * Constructs a new instance of this class with its
84 * stack trace and error code filled in.
85 *
86 * @param code the DWT error code
87 */
88 public this (int code) {
89 this(code, DWT.findErrorText(code));
90 }
91
92 /**
93 * Constructs a new instance of this class with its
94 * stack trace, error code and message filled in.
95 * Specifying <code>null</code> as the message is
96 * equivalent to specifying an empty String.
97 *
98 * @param code the DWT error code
99 * @param message the detail message for the exception
100 */
101 public this (int code, String message) {
102 super(message);
103 this.code = code;
104 }
105
106 /**
107 * Returns the underlying throwable that caused the problem,
108 * or null if this information is not available.
109 * <p>
110 * NOTE: This method overrides Throwable.getCause() that was
111 * added to JDK1.4. It is necessary to override this method
112 * in order for inherited printStackTrace() methods to work.
113 * </p>
114 * @return the underlying throwable
115 *
116 * @since 3.1
117 */
118 public Exception getCause () {
119 return throwable;
120 }
121
122 /**
123 * Returns the String describing this DWTException object.
124 * <p>
125 * It is combined with the message String of the Throwable
126 * which caused this DWTException (if this information is available).
127 * </p>
128 * @return the error message String of this DWTException object
129 */
130 public String getMessage () {
131 if (throwable is null)
132 return super.getMessage();
133 return super.getMessage() + " (" + throwable.toString() + ")"; //$NON-NLS-1$ //$NON-NLS-2$
134 }
135
136 /**
137 * Outputs a printable representation of this exception's
138 * stack trace on the standard error stream.
139 * <p>
140 * Note: printStackTrace(PrintStream) and printStackTrace(PrintWriter)
141 * are not provided in order to maintain compatibility with CLDC.
142 * </p>
143 */
144 public void printStackTrace () {
145 super.printStackTrace();
146 if (Library.JAVA_VERSION < Library.JAVA_VERSION(1, 4, 0) && throwable !is null) {
147 System.err.println("*** Stack trace of contained exception ***"); //$NON-NLS-1$
148 throwable.printStackTrace();
149 }
150 }
151
152 }