Bug 1134 - Add ASTLocationTag, locating source of [semantic] errors while parsing / analyzing

New GlueGenException supports ASTLocationTag,
which will be throws in case of semantic and/or parsing errors.

1 files changed, 95 insertions, 0 deletions

diff --git a/src/java/com/jogamp/gluegen/GlueGenException.java b/src/java/com/jogamp/gluegen/GlueGenException.java
new file mode 100644
index 0000000..3c52104
--- /dev/null
+++ b/src/java/com/jogamp/gluegen/GlueGenException.java
@@ -0,0 +1,95 @@
+/**
+ * Copyright 2010 JogAmp Community. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification, are
+ * permitted provided that the following conditions are met:
+ *
+ *    1. Redistributions of source code must retain the above copyright notice, this list of
+ *       conditions and the following disclaimer.
+ *
+ *    2. Redistributions in binary form must reproduce the above copyright notice, this list
+ *       of conditions and the following disclaimer in the documentation and/or other materials
+ *       provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+ * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * The views and conclusions contained in the software and documentation are those of the
+ * authors and should not be interpreted as representing official policies, either expressed
+ * or implied, of JogAmp Community.
+ */
+
+package com.jogamp.gluegen;
+
+import com.jogamp.common.JogampRuntimeException;
+
+/** A generic exception for Jogamp errors used throughout the binding
+    as a substitute for {@link RuntimeException}. */
+
+@SuppressWarnings("serial")
+public class GlueGenException extends JogampRuntimeException {
+  final ASTLocusTag locus;
+
+  public ASTLocusTag getASTLocusTag() { return locus; }
+
+  /** Constructs a GlueGenException object. */
+  public GlueGenException() {
+    super();
+    locus = null;
+  }
+
+  /** Constructs a GlueGenException object with the specified detail
+      message. */
+  public GlueGenException(final String message) {
+    super(message);
+    locus = null;
+  }
+
+  /** Constructs a GlueGenException object with the specified detail
+      message and root cause. */
+  public GlueGenException(final String message, final Throwable cause) {
+    super(message, cause);
+    locus = null;
+  }
+
+  /** Constructs a GlueGenException object with the specified root
+      cause. */
+  public GlueGenException(final Throwable cause) {
+    super(cause);
+    locus = null;
+  }
+
+  /** Constructs a GlueGenException object with the specified detail
+      message and root cause. */
+  public GlueGenException(final String message, final ASTLocusTag locusTag) {
+    super(message);
+    this.locus = locusTag;
+  }
+
+  /** Constructs a GlueGenException object with the specified detail
+      message and root cause. */
+  public GlueGenException(final String message, final ASTLocusTag locusTag, final Throwable cause) {
+    super(message, cause);
+    this.locus = locusTag;
+  }
+
+  public String toString() {
+      final StringBuffer buf = new StringBuffer();
+      if (null != locus) {
+          buf.append(locus).append(": ");
+      }
+      buf.append(getLocalizedMessage());
+      final String message = buf.toString();
+
+      final String className = getClass().getSimpleName();
+      return null != message ? className + ": " + message : className;
+  }
+
+}