Class not found exception java ошибка

A classpath is a list of locations to load classes from.

These ‘locations’ can either be directories, or jar files.

For directories, the JVM will follow an expected pattern for loading a class. If I have the directory C:/myproject/classes in my classpath, and I attempt to load a class com.mycompany.Foo, it will look under the classes directory for a directory called com, then under that a directory called mycompany, and finally it will look for a file called Foo.class in that directory.

In the second instance, for jar files, it will search the jar file for that class. A jar file is in reality just a zipped collection of directories like the above. If you unzip a jar file, you’ll get a bunch of directories and class files following the pattern above.

So the JVM traverses a classpath from start to finish looking for the definition of the class when it attempts to load the class definition. For example, in the classpath :

C:/myproject/classes;C:/myproject/lib/stuff.jar;C:/myproject/lib/otherstuff.jar

The JVM will attempt to look in the directory classes first, then in stuff.jar and finally in otherstuff.jar.

When you get a ClassNotFoundException, it means the JVM has traversed the entire classpath and not found the class you’ve attempted to reference. The solution, as so often in the Java world, is to check your classpath.

You define a classpath on the command line by saying java -cp and then your classpath. In an IDE such as Eclipse, you’ll have a menu option to specify your classpath.

ClassNotFoundException is a checked exception and occurs when the Java Virtual Machine (JVM) tries to load a particular class and the specified class cannot be found in the classpath.

In older days, there are no editors like Eclipse are available. Even in Notepad, people have done java coding and by using the “javac” command to compile the java files, and they will create a ‘.class’ file. Sometimes accidentally the generated class files might be lost or set in different locations and hence there are a lot of chances of “ClassNotFoundException” occurs. After the existence of editors like Eclipse, Netbeans, etc., IDE creates a “ClassPath” file kind of entries.

From the above image, we can see that many jar files are present. They are absolutely necessary if the java code wants to interact with MySQL, MongoDB, etc., kind of databases, and also few functionalities need these jar files to be present in the build path. If they are not added, first editors show the errors themselves and provide the option of corrections too.

Implementation: Sample program of connecting to MySQL database and get the contents

Example

Java

import java.sql.*;

public class MySQLConnectivityCheck {

    public static void main(String[] args)

    {

        System.out.println(

            "---------------------------------------------");

        Connection con = null;

        ResultSet res = null;

        try {

            Class.forName("com.mysql.cj.jdbc.Driver");

            con = DriverManager.getConnection(

                "root", "");

            try {

            }

            catch (SQLException s) {

                System.out.println(

                    "SQL statement is not executed!");

            }

        }

        catch (Exception e) {

            e.printStackTrace();

        }

        finally {

            res = null;

            con = null;

        }

    }

}

Output:

Case 1: In the above code, we are using com.mysql.cj.jdbc.Driver and in that case if we are not having mysql-connector-java-8.0.22.jar, then we will be getting ClassNotFoundException.

Case 2: So, keep the jar in the build path as shown below.

Note: Similarly for any database connectivity, we need to have the respective jars for connecting to that database. The list of database driver jars required by java to overcome ClassNotFoundException is given below in a tabular format 

Database  Command Line
MySQL mysql-connector-java-8.0.22.jar
MongoDB mongo-java-driver-3.12.7.jar
SQL Server sqljdbc4.jar
MYSQL sqljdbc.jar
Oracle oracle.jdbc.driver.oracledriver

Note: 

  • When we are developing Web based applications, the jars must be present in ‘WEB-INF/lib directory’.
  • In Maven projects, jar dependency should be present in pom.xml
  • Sample snippet of pom.xml for spring boot

Example 1 With Spring boot

XML

<dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-data-mongodb</artifactId>

</dependency>

Example 2 Without spring boot

XML

<dependency>

    <groupId>org.mongodb</groupId>

    <artifactId>mongodb-driver</artifactId>

    <version>3.6.3</version>

</dependency>

Example 3 Gradle based dependencies (MongoDB) 

XML

dependencies {

      compile 'org.mongodb:mongodb-driver:3.2.2'

  }

Similarly, other DB drivers can be specified in this way. It depends upon the project nature, the dependencies has to be fixed. For ordinary class level projects, all the classes i.e parent class, child class, etc should be available in the classpath. If there are errors, then also .class file will not be created which leads to ClassNotFoundException, and hence in order to get the whole code working, one should correct the errors first by fixing the dependencies. IDE is much helpful to overcome such sort scenarios such as when the program throws ClassNotFoundException, it will provide suggestions to users about the necessity of inclusion of jar files(which contains necessary functionalities like connecting to database.

Last Updated :
30 Sep, 2021

Like Article

Save Article

The java.lang.ClassNotFoundException is a checked exception in Java that occurs when the JVM tries to load a particular class but does not find it in the classpath.

Since the ClassNotFoundException is a checked exception, it must be explicitly handled in methods which can throw this exception — either by using a try-catch block or by throwing it using the throws clause.

Install the Java SDK to identify and fix exceptions

What Causes ClassNotFoundException in Java

Common causes of the java.lang.ClassNotFoundException are using the following methods to load a class:

  • Class.forName()
  • ClassLoader.findSystemClass()
  • ClassLoader.loadClass()

In all the above cases, the class attempted to be loaded is not found on the classpath, leading to the ClassNotFoundException in Java.

ClassNotFoundException in Java Example

A very common example of ClassNotFoundException is when a JDBC driver is attempted to be loaded using Class.forName() and the driver’s JAR file is not present in the classpath:

public class ClassNotFoundExceptionExample {
    private static final String DRIVER_CLASS = "com.mysql.jdbc.Driver";

        public static void main(String[]  args) throws Exception {
                System.out.println("Loading MySQL JDBC driver");
                Class.forName(DRIVER_CLASS);
        }
            }

Since the MySQL JDBC driver JAR file is not present in the classpath, running the above code leads to a java.lang.ClassNotFoundException:

Loading MySQL JDBC driver
Exception in thread "main" java.lang.ClassNotFoundException: com.mysql.jdbc.Driver
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:602)
    at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:522)
    at java.base/java.lang.Class.forName0(Native Method)
    at java.base/java.lang.Class.forName(Class.java:340)
    at ClassNotFoundExceptionExample.main(ClassNotFoundExceptionExample.java:6)

To fix the Java exception, the mysql-connector JAR should be included in the application classpath.

How to Resolve ClassNotFoundException in Java

The following steps should be followed to resolve a ClassNotFoundException in Java:

  1. Find out which JAR file contains the problematic Java class. For example, in the case of com.mysql.jdbc.driver, the JAR file that contains it is mysql-connector-java.jar.
  2. Check whether this JAR is present in the application classpath. If not, the JAR should be added to the classpath in Java and the application should be recompiled.
  3. If that JAR is already present in the classpath, make sure the classpath is not overridden (e.g. by a start-up script). After finding out the exact Java classpath used by the application, the JAR file should be added to it.

To fix the Java exception, the mysql-connector JAR should be included in the application classpath.

Track, Analyze and Manage Java Errors With Rollbar

Managing errors and exceptions in your code is challenging. It can make deploying production code an unnerving experience. Being able to track, analyze, and manage errors in real-time can help you to proceed with more confidence. Rollbar automates Java error monitoring and triaging, making fixing errors easier than ever. Try it today.


Эта статья предназначена для начинающих Java, которые в настоящее время сталкиваются с проблемами java.lang.ClassNotFoundException.
Он предоставит вам обзор этого распространенного исключения 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-программу, которая имитирует 2 наиболее распространенных сценария ClassNotFoundException с помощью Class.forName () и ClassLoader.loadClass ().
Пожалуйста, просто скопируйте / вставьте и запустите программу с 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 Simulator - Training 5
Author: Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com

** Problem scenario #1: Class.forName() **

Class loading of class org.ph.javaee.training5.ClassA from ClassLoader 'sun.misc.Launcher$AppClassLoader@bfbdb0' in progress...
Class class org.ph.javaee.training5.ClassA found successfully!

Simulator done!

Вывод сценария 2 (базовый уровень)

java.lang.ClassNotFoundException Simulator - Training 5
Author: Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com

** Problem scenario #2: ClassLoader.loadClass() **

Class loading of class org.ph.javaee.training5.ClassA from ClassLoader 'sun.misc.Launcher$AppClassLoader@2a340e' in progress...
Creating a new instance of org.ph.javaee.training5.ClassA...
SUCCESS!: org.ph.javaee.training5.ClassA@6eb38a

Simulator done!


Для «базового» запуска Java-программа может успешно загрузить ClassA.


Теперь давайте добровольно изменим полное имя ClassA и повторно запустим программу для каждого сценария.
Может быть получен следующий вывод:

#ClassA изменен на
ClassB

 private static final String CLASS_TO_LOAD = "org.ph.javaee.training5.ClassB";

# Вывод сценария 1 (проблема репликации)

java.lang.ClassNotFoundException Simulator - Training 5
Author: Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com

** Problem scenario #1: Class.forName() **

java.lang.ClassNotFoundException: org.ph.javaee.training5.ClassB
       at java.net.URLClassLoader$1.run(URLClassLoader.java:366)
       at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
       at java.security.AccessController.doPrivileged(Native Method)
       at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
       at java.lang.ClassLoader.loadClass(ClassLoader.java:423)
       at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
       at java.lang.ClassLoader.loadClass(ClassLoader.java:356)
       at java.lang.Class.forName0(Native Method)
       at java.lang.Class.forName(Class.java:186)
       at org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main(ClassNotFoundExceptionSimulator.java:29)
Class org.ph.javaee.training5.ClassB not found!

Simulator done!

Вывод сценария 2 (проблема репликации)

java.lang.ClassNotFoundException Simulator - Training 5
Author: Pierre-Hugues Charbonneau
http://javaeesupportpatterns.blogspot.com

** Problem scenario #2: ClassLoader.loadClass() **

java.lang.ClassNotFoundException: org.ph.javaee.training5.ClassB
       at java.net.URLClassLoader$1.run(URLClassLoader.java:366)
       at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
       at java.security.AccessController.doPrivileged(Native Method)
       at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
       at java.lang.ClassLoader.loadClass(ClassLoader.java:423)
       at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
       at java.lang.ClassLoader.loadClass(ClassLoader.java:356)
       at org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main(ClassNotFoundExceptionSimulator.java:51)
Class org.ph.javaee.training5.ClassB not found!

Simulator done!


Что произошло?
Итак, поскольку мы изменили полное имя класса на org.ph.javaee.training5.ClassB, такой класс не был найден во время выполнения (не существует), что привело к сбою вызовов Class.forName () и ClassLoader.loadClass ().


Вы также можете повторить эту проблему, упаковав каждый класс этой программы в свой собственный JAR-файл, а затем пропустите jar-файл, содержащий ClassA.class, из основного пути к классу. Попробуйте это и посмотрите сами результаты… (подсказка: NoClassDefFoundError)


Теперь давайте перейдем к стратегии разрешения.

java.lang.ClassNotFoundException: стратегии разрешения


Теперь, когда вы понимаете эту проблему, пришло время решить ее.
Разрешение может быть довольно простым или очень сложным в зависимости от первопричины.

  • Не спешите со сложными первопричинами слишком быстро, сначала исключите самые простые причины.
  • Сначала просмотрите трассировку стека java.lang.ClassNotFoundException согласно приведенному выше и определите, какой класс Java не был загружен должным образом во время выполнения, например, код приложения, сторонний API, сам контейнер Java EE и т. Д.
  • Определите вызывающего, например, Java-класс, который вы видите по трассировке стека непосредственно перед вызовами Class.forName () или ClassLoader.loadClass (). Это поможет вам понять, является ли код вашего приложения ошибочным по сравнению с API стороннего производителя.
  • Определите, правильно ли упакован код вашего приложения, например, отсутствуют файлы JAR из вашего classpath
  • Если отсутствующий класс Java отсутствует в коде вашего приложения, то определите, принадлежит ли он стороннему API, который вы используете в соответствии с вашим приложением Java. Как только вы определите его, вам нужно будет добавить отсутствующие JAR-файлы в ваш путь к классам во время выполнения или файл WAR / EAR веб-приложения.
  • Если после нескольких попыток разрешения проблемы все еще не решены, это может означать более сложную проблему иерархии загрузчиков классов. В этом случае, пожалуйста, просмотрите мою серию  статей NoClassDefFoundError для большего количества примеров и стратегий разрешения


Я надеюсь, что эта статья помогла вам понять и вернуться к этому распространенному исключению Java.


Пожалуйста, не стесняйтесь оставлять комментарии или вопросы, если вы все еще боретесь с проблемой java.lang.ClassNotFoundException.

Java ClassNotFoundException

Introduction to Java ClassNotFoundException

As it goes by the name, ClassNotFoundException occurs in Java when a specific class is tried to load by a Java Virtual Machine(JVM). The requested class is not found in the path of the class specified by you, meaning that the path of the class specified by you is broken, which problem is really common in the world of Java. Hence, ClassNotFoundException is also common in Java. This problem is very confusing for those who are beginners in Java, and ClassNotFoundException must be catch or thrown to the caller ClassNotFoundException is a checked exception.

The syntax ofClassNotFoundException in Java is as follows: 

java.lang.ClassNotFoundException:Class_name at location

Working of ClassNotFoundException in Java

  • When a class loader is not able to find the class in the path of the class specified while the application is trying to load the class, that is when the ClassNotFoundExceptionoccurs in Java.
  • Making use of Class.forName and ClassLoader.loadClass for loading the class while passing string name of the class as the parameter which is not found in the path of the class that is specified is one of the common causes for java.lang.ClassNotFoundException in Java.
  • ClassNotFoundException in Java must be catch or thrown to the caller because it is a checked exception.
  • The class is indirectly loading using the Classloader. As a result, ClassNotFoundException in Java occurs at runtime. There is no way that a Java compiler can know if a class is present in the path of the class specified or not at runtime.
  • Trying to load the JDBC drivers using Class.forName and not adding the jar file in the path of the class is one of the common examples of ClassNotFoundExceptionin Java.
  • Consider the below program to demonstrate ClassNotFoundException in Java:
//a class called program is defined
public class Program
{
//main method is called
public static void main(String args[])
{
//class not found exception is defined using try and catch block
try
{
// the forname method in class class looks for the mentioned class
Class.forName("The Class do not Exist");
}
catch (ClassNotFoundException e)
{
e.printStackTrace();
}
}
}

The output of the above program is as shown in the snapshot below:

Java ClassNotFoundException output 1

In the above program, a class called Program is defined. Then the main method is called. Then class not found exception is defined using try and catch block. There is noThe class does not exist.java class which the class loader is trying to find andtheforname method in class looks for the mentioned class, which it fails to find; hence the ClassNotFoundException is thrown. The output of the program is as shown in the snapshot above.

Constructors

There are several constructors for ClassNotFoundException in Java. They are:

  • ClassNotFoundException(): A new ClassNotFoundException is constructed which includes the current trace of the stack.
  • ClassNotFoundException(String): A new ClassNotFoundException is constructed, which includes the current trace of the stack and the message in detail, specified.
  • ClassNotFoundException(IntPtr, JniHandleOwnership): During the creation of JNI objects, while managing their representations, this constructor is used, and the runtime calls it.
  • ClassNotFoundException(String, Throwable): A new ClassNotFoundException is constructed, which includes the current trace of the stack along with the message in detail that is specified and the exception that occurs when trying to load the class.

Examples of Java ClassNotFoundException

Here are the following examples mention below:

Example #1

Java program to demonstrate ClassNotFoundException:

 Code:

//a class called exceptiondemo is defined
public class Exceptiondemo
{
//a string variable is defined
private static final String DRIVE_CLASS = "com.mysql.jdbc.Driver";
//main method is called including the exception
public static void main(String[]  args) throws Exception
{
System.out.println("MySQL JDBC driver loading attempt");
//the forname method in class class looks for the mentioned class
Class.forName(DRIVE_CLASS);
}
}

The output of the above program is as shown in the snapshot below:

Java ClassNotFoundException output 2

In the above program, a class called Exception demo is defined. Then the main method is called. Then a string variable is defined to which the JDBC driver path is assigned. Then the main method is called, which throws the exception. The class loader is trying to find the JDBC driver path of the class specified and the forname method in class looks for the mentioned class, which it fails to find; hence the ClassNotFoundException is thrown. The output of the program is as shown in the snapshot above.

Example #2

Java program to demonstrate ClassNotFoundException(String)

Code:

//a class called check is defined
public class Check
{
//main method is called
public static void main(String args[])
{
//class not found exception is defined using try catch block
try
{
//the forname method in class class looks for the mentioned class
Class.forName("Demonstrating class not found exception");
}
catch(ClassNotFoundException e)
{
//the string specified along with the class not found exception is displayed.
System.out.println("There is no class as specified in the path " + e);
}
}
}

The output of the above program is as shown in the snapshot below:

output 3

In the above program, a class called check is defined. Then the main method is called. Then the main method is called. Then class not found exception is defined by using try and catch block.  Then the forename method in class looks for the mentioned class, which it fails to find; hence the ClassNotFoundException is thrown and the string specified as a detailed message along with the class not found exception is displayed. The output of the program is as shown in the snapshot above.

How to Avoid ClassNotFoundException?

Steps to avoid ClassNotFoundException:

  • The file of the class causing the problem on which the jar file is present must be found out.
  • We should check if the path of the class or classpath consists of that jar. If the jar is not present in the classpath or path of the class, the class must be added in the class or classpath path.
  • If the class is present in the class or classpath path, then the chances are that there is an overriding of classpath or path of the class or the path specified in the jar file or the script used for starting up is being used by the application. To solve this problem, we need to find the exact path of the class that is being used by the application.

Conclusion

In this tutorial, we understand the concept of Class Not Found Exception in Java through definition, the syntax of Class Not Found Exception in Java, working of Class Not Found Exception in Java, and their constructors through examples and their outputs.

Recommended Articles

This is a guide to Java ClassNotFoundException. Here we discuss the working of ClassNotFoundException in Java along with programming examples. You may also have a look at the following articles to learn more –

  1. Finally in Java
  2. Java min()
  3. copy() in Java
  4. EJB in Java

  • Class jformfieldlist not found ошибка джумла
  • Clash royale ошибка подключения к серверу
  • Clas 24ff ошибка 302
  • Clack ws1tc ошибка e4
  • Clack ws1ci ошибка 102