本文适用于当前面临java.lang.ClassNotFoundException挑战的Java初学者。 它将为您提供此常见Java异常的概述,这是一个示例Java程序,可支持您的学习过程和解决策略。
如果您对与更高级的类加载器相关的问题感兴趣,我建议您复习有关java.lang.NoClassDefFoundError的文章系列,因为这些Java异常密切相关。
java.lang.ClassNotFoundException:概述
根据Oracle文档,在类加载调用失败后,将使用其字符串名称引发ClassNotFoundException ,如下所示:
- Class.forName方法
- ClassLoader.findSystemClass方法
- ClassLoader.loadClass方法
换句话说,这意味着一个特定的Java类找不到或无法从您的应用程序当前上下文类加载器“运行”加载。
对于Java初学者来说,这个问题可能特别令人困惑。 这就是为什么我始终建议Java开发人员学习和完善他们在Java类加载器方面的知识的原因。 除非您参与动态类加载和使用Java Reflection API,否则您遇到的ClassNotFoundException错误不是来自应用程序代码,而是来自引用API。 另一个常见的问题模式是错误包装您的应用程序代码。 我们将在本文结尾处回到解决策略。
java.lang。 ClassNotFoundException :示例Java程序
现在在下面找到一个非常简单的Java程序,该程序通过Class.forName()和ClassLoader.loadClass()模拟两种最常见的ClassNotFoundException方案。 请简单地复制/粘贴并使用您选择的IDE运行该程序( 此示例使用Eclipse IDE )。
Java程序允许您根据以下情况在问题场景1或问题场景2之间进行选择。 根据您要研究的场景,只需更改为1或2。
#Class.forName()
private static final int PROBLEM_SCENARIO = 1;
#ClassLoader.loadClass()
private static final int PROBLEM_SCENARIO = 2;
#ClassNotFoundExceptionSimulator
package org.ph.javaee.training5;/*** ClassNotFoundExceptionSimulator* @author Pierre-Hugues Charbonneau**/
public class ClassNotFoundExceptionSimulator {private static final String CLASS_TO_LOAD = "org.ph.javaee.training5.ClassA";private static final int PROBLEM_SCENARIO = 1;/*** @param args*/public static void main(String[] args) {System.out.println("java.lang.ClassNotFoundException Simulator - Training 5");System.out.println("Author: Pierre-Hugues Charbonneau");System.out.println("http://javaeesupportpatterns.blogspot.com");switch(PROBLEM_SCENARIO) {// Scenario #1 - Class.forName()case 1:System.out.println("\n** Problem scenario #1: Class.forName() **\n");try {Class<?> newClass = Class.forName(CLASS_TO_LOAD);System.out.println("Class "+newClass+" found successfully!");} catch (ClassNotFoundException ex) {ex.printStackTrace();System.out.println("Class "+CLASS_TO_LOAD+" not found!");} catch (Throwable any) { System.out.println("Unexpected error! "+any);}break;// Scenario #2 - ClassLoader.loadClass()case 2:System.out.println("\n** Problem scenario #2: ClassLoader.loadClass() **\n"); try {ClassLoader classLoader = Thread.currentThread().getContextClassLoader(); Class<?> callerClass = classLoader.loadClass(CLASS_TO_LOAD);Object newClassAInstance = callerClass.newInstance();System.out.println("SUCCESS!: "+newClassAInstance);} catch (ClassNotFoundException ex) {ex.printStackTrace();System.out.println("Class "+CLASS_TO_LOAD+" not found!");} catch (Throwable any) { System.out.println("Unexpected error! "+any);}break;}System.out.println("\nSimulator done!");}
}
#ClassA
package org.ph.javaee.training5;/*** ClassA* @author Pierre-Hugues Charbonneau**/
public class ClassA {private final static Class<ClassA> CLAZZ = ClassA.class;static {System.out.println("Class loading of "+CLAZZ+" from ClassLoader '"+CLAZZ.getClassLoader()+"' in progress...");}public ClassA() {System.out.println("Creating a new instance of "+ClassA.class.getName()+"...");doSomething();}private void doSomething() { // Nothing to do...}
}
如果按原样运行该程序,则每种情况的输出如下:
#方案1输出(基准)
java.lang.ClassNotFoundException
模拟器–训练5
作者:Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com
**问题场景1:Class.forName()**
正在从ClassLoader'sun.misc.Launcher$AppClassLoader@bfbdb0'加载org.ph.javaee.training5.ClassA类。
成功找到类org.ph.javaee.training5.ClassA类!
模拟器完成!
#方案2输出(基准)
java.lang.ClassNotFoundException
模拟器–训练5
作者:Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com
**问题场景2:ClassLoader.loadClass()**
正在从ClassLoader'sun.misc.Launcher$AppClassLoader@2a340e'加载org.ph.javaee.training5.ClassA类的类…
正在创建org.ph.javaee.training5.ClassA的新实例…
成功!:org.ph.javaee.training5.ClassA@6eb38a
模拟器完成!
对于“基准”运行,Java程序能够加载
A类
成功。
现在让我们自愿更改的全名
A类
并针对每种情况重新运行该程序。 可以观察到以下输出:
#ClassA更改为ClassB
private static final String CLASS_TO_LOAD = "org.ph.javaee.training5.ClassB";
#方案1输出(问题复制)
java.lang.ClassNotFoundException
模拟器–训练5
作者:Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com
**问题场景1:Class.forName()**
java.lang.ClassNotFoundException
:org.ph.javaee.training5.ClassB
在java.net.URLClassLoader $ 1.run(
URLClassLoader.java:366
)
在java.net.URLClassLoader $ 1.run(
URLClassLoader.java:355
)
在java.security.AccessController.doPrivileged(
本机方法
)
在java.net.URLClassLoader.findClass(
URLClassLoader.java:354
)
在java.lang.ClassLoader.loadClass(
ClassLoader.java:423
)
在sun.misc.Launcher $ AppClassLoader.loadClass(
Launcher.java:308
)
在java.lang.ClassLoader.loadClass(
ClassLoader.java:356
)
在java.lang.Class.forName0(
本机方法
)
在java.lang.Class.forName(
Class.java:186
)
在org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main(
ClassNotFoundExceptionSimulator.java:29
)
找不到org.ph.javaee.training5.ClassB类!
模拟器完成!
#方案2输出(问题复制)
java.lang.ClassNotFoundException
模拟器–训练5
作者:Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com
**问题场景2:ClassLoader.loadClass()**
java.lang.ClassNotFoundException
:org.ph.javaee.training5.ClassB
在java.net.URLClassLoader $ 1.run(
URLClassLoader.java:366
)
在java.net.URLClassLoader $ 1.run(
URLClassLoader.java:355
)
在java.security.AccessController.doPrivileged(
本机方法
)
在java.net.URLClassLoader.findClass(
URLClassLoader.java:354
)
在java.lang.ClassLoader.loadClass(
ClassLoader.java:423
)
在sun.misc.Launcher $ AppClassLoader.loadClass(
Launcher.java:308
)
在java.lang.ClassLoader.loadClass(
ClassLoader.java:356
)
在org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main(
ClassNotFoundExceptionSimulator.java:51
)
找不到org.ph.javaee.training5.ClassB类!
模拟器完成!
发生了什么? 好吧,因为我们将完整的类名更改为org.ph.javaee.training5.ClassB,所以在运行时找不到此类(不存在),从而导致Class.forName()和ClassLoader.loadClass()调用均失败。
您还可以通过将该程序的每个类打包到其自己的JAR文件中,然后从主类路径中省略包含ClassA.class的jar文件来复制此问题。请尝试一下并亲自查看结果…(提示:NoClassDefFoundError)
现在,让我们跳到解决策略。
java.lang。 ClassNotFoundException
:解决策略
现在您已经了解了这个问题,现在该解决它了。 解决方法可能非常简单,也可能非常复杂,具体取决于根本原因。
- 不要太过复杂的根本原因,首先要排除最简单的原因。
- 首先根据上述内容检查java.lang.ClassNotFoundException堆栈跟踪,并确定在运行时未正确加载哪个Java类,例如应用程序代码,第三方API,Java EE容器本身等。
- 确定调用者,例如您在调用Class.forName()或ClassLoader.loadClass()之前从堆栈跟踪中看到的Java类。 与第三方API相比,这将有助于您了解应用程序代码是否出错。
- 确定您的应用程序代码是否未正确打包,例如,类路径中缺少JAR文件
- 如果缺少的Java类不是来自您的应用程序代码,请确定它是否属于您正在按照Java应用程序使用的第三方API。 一旦识别出它,就需要将丢失的JAR文件添加到运行时类路径或Web应用程序WAR / EAR文件中。
- 如果在多次解析尝试后仍然挣扎,则可能意味着更复杂的类加载器层次结构问题。 在这种情况下,请查看我的NoClassDefFoundError文章系列,以获取更多示例和解决方案
我希望本文能帮助您理解和重新了解这种常见的Java异常。
如果您仍在努力解决java.lang.ClassNotFoundException问题,请随时发表任何评论或问题。
参考: java.lang.ClassNotFoundException:如何从Java EE支持模式和Java教程博客的JCG合作伙伴 Pierre-Hugues Charbonneau 解决 。
翻译自: https://www.javacodegeeks.com/2012/11/java-lang-classnotfoundexception-how-to-resolve.html