diff src/main/gov/nasa/jpf/vm/ClassInfoException.java @ 0:61d41facf527

initial v8 import (history reset)
author Peter Mehlitz <Peter.C.Mehlitz@nasa.gov>
date Fri, 23 Jan 2015 10:14:01 -0800
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/main/gov/nasa/jpf/vm/ClassInfoException.java	Fri Jan 23 10:14:01 2015 -0800
@@ -0,0 +1,89 @@
+/*
+ * Copyright (C) 2014, United States Government, as represented by the
+ * Administrator of the National Aeronautics and Space Administration.
+ * All rights reserved.
+ *
+ * The Java Pathfinder core (jpf-core) platform is licensed under the
+ * Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ * 
+ *        http://www.apache.org/licenses/LICENSE-2.0. 
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+package gov.nasa.jpf.vm;
+
+/**
+ * @author Nastaran Shafiei <nastaran.shafiei@gmail.com>
+ *
+ * This unchecked exception is thrown by the host VM. It captures all errors
+ * and exceptions that can occur at the load of a JPF class, which includes 
+ * defining, and resolving it. Here are some of the scenarios that this 
+ * exception is thrown and captures the corresponding exception:
+ *
+ *    * if the representation does not represent a class with the requested 
+ *      name, loading throws an instance of NoClassDefFoundError
+ *
+ *    * if any of the superclasses of a class, is the class itself, or if 
+ *      any of the superinterfaces of an interface, is the interface itself, 
+ *      loading throws an instance of ClassCircularityError
+ *
+ *    * if the representation is not a ClassFile structure, loading throws an
+ *      instance of ClassFormatError
+ * 
+ * If this exception is thrown during the initialization of VM, and the failed
+ * class is a system class, or creating of the main thread in not successful, we 
+ * immediately bail out by throwing JPFException.
+ * 
+ * While JPF is running, this error is handled by throwing an exception at the 
+ * SUT level. This exception is handled if it is thrown by 
+ * 
+ *    1. a native peer method,  
+ *    2. Intruction.execute(),
+ *    3. ThreadInfo.creatAndThrowException()
+ *    4. VM.initialize() // here it is handled only if it a non-system class
+ * 
+ * If this exception is thrown by a Listener, the host VM throws JPFListenerException.
+ * 
+ */
+public class ClassInfoException extends RuntimeException{
+
+  ClassLoaderInfo classLoader;
+  String exceptionClass; // how we map this into the SUT (i.e. the JPF side)
+  String failedClass;
+
+  public ClassInfoException(String details, ClassLoaderInfo cl, String exceptionClass, String faildClass) {
+    super(details);
+    this.classLoader = cl;
+    this.exceptionClass = exceptionClass;
+    this.failedClass = faildClass;
+  }
+
+  public ClassInfoException (String details, ClassLoaderInfo cl, String exceptionClass, String faildClass, Throwable cause) {
+    super(details, cause);
+    this.classLoader = cl;
+    this.exceptionClass = exceptionClass;
+    this.failedClass = faildClass;
+  }
+
+  
+  public boolean checkSystemClassFailure() {
+    return (failedClass.startsWith("java."));
+  }
+
+  public ClassLoaderInfo getClassLoaderInfo() {
+    return classLoader;
+  }
+
+  public String getFailedClass() {
+    return failedClass;
+  }
+
+  public String getExceptionClass() {
+    return exceptionClass;
+  }
+}