Reader Level:

Understanding ClassPath in Java

By Sandeep Sharma on Sep 27, 2013
This article explains ClassPath in Java.


This article explains ClassPath in Java.

What is ClassPath

From the word we understand that classpath is a path of a class. Yeah, that is correct; a classpath is a path for the compiler to identify which class or which package we use in our defined class. It provides the compiler a way to find classes or packages that are used in our class.

In this definition we use the term "Package". Now understand what a package is.


It is a logical container of classes, interfaces and sub-packages. A packages provides a unique space for classes and provide a scope for classes and interfaces.

A class is associated with a package using the following.



To associate a class with a package the following procedure is required.

1. The package keyword is used as the first statement in the class definition to specify the package of the class as in the following:

package mypack:

2. The Source file and generated class file are saved in a folder of the same name as the package.

Let's assume that there are the two packages named P1 and P2. Both these packages contain A and B classes.

The classes of these packages can be uniquely identified as:

p1.A, p1.B and p2.A, p2.B


To assert that packages of two different projects have a different name the following convention may used in the naming of the packages.

Project-url                                                      Project-name

http://www.projectname.domainname/                       domainName.projectName.packageName


1. springFramework                                org.springfrmaework.web

2. strutsFramework                                      org.apache.struts.web

3. userDefined                                   com.c-sharpcorner.web


A package name is never associated with the Java file, in other words Java files are referred to independently.

Now understand what classpath is

1. How to access another package class

First understand a scenario; in this we create two Java files, the first one in is contained in "E:\Sandy\java programs\p1" and the other one is "" stored in the "D:\p2" folder.

Now we have used the file in the A class. So in that order we need to call the B class; that is done using classpath.

ClassPath is used to tell the compiler that we are using another class contained in the path we provided.

Define package p1 and class A as.

This class is saved in the "E:\Sandy\java programs\p1" folder.

package p1;

Public Class A


public static void main(String args[])


System.out.println("A of pi is invoked");

System.out.println("Instantiating B of p2....");

p2.B y=new p2.B();

System.out.println("Invoking display() of B of p2...");




Define package p2 and class B as.

This class is saved in the "D:\p2" folder.

package p2;

Public Class B




System.out.println("B of p2 loaded");


    Public B()


System.out.println("B of p2 instantiated");


public void display()


System.out.println("display() of B of p2 invoked");



Now compiling

When we compile this file directly without giving a path introduction to the Java compiler then see what happens:


As you can see, the compiler says that the p2 package does not exist. In other words, they are unable find package p2 itself so in this order we need to tell the compiler that you need to find package p2 in the given path.

The ClassPath environment variable is used by the compiler and JRE to locate user-defined classes.


1.0: Path of user defined packages are listed in the ClassPath variable.

2.0: References of classes are encountered during compilation execution.

2.1: The value of the classpath environment variable is read.

2.2: The folders listed in classpath are searched to locate the referenced classes.

2.3: If a referenced class is not found in a user defined package then it is searched for in the rt.jar file. If not found then a ClassNotFound exception is thrown.


The default value of the class environment variable is the current class.

The value of the classpath environment variable is set permanently or can be specified for compilation and execution for a class.

Complete syntax for compilation and execution

1. Compiling a source file


javac -cp FoldertoLocateReferencedPackage NameOrPathOfJavaFile

2. Executing a Java class


javac -cp FoldertoLocateReferencedPackage NameOfClass


A classpath is not applied to a Java file. A Java file is loaded at a given path.

Now compile our class A using a class path.


E:\Sandy\java program\p1> javac -cp D:\

Understand the command

1.  "-cp" is the syntax for the use classpath.

2. "D:\" tells the compiler that you need to find the package p2 in this folder. 


Now we see that there is no error generated because we are providing a path for package p2.

Execute class A


java -cp D:\;.. p1.A

The following explains what we wrote.

1. "D:\" is used to find package p2.

2. ".." is used to find the package p1. Since it is contained in the parent folder we use "..". If it exists in the current folder then we use "."

3. "p1.A" tells the compiler to execute class A in the p1 package.


Similarly we can compile and execute our class from any location.

Let's see an example.

The following are compilation commands for various locations.

1. E:\Sandy\java program\p1>

javac -cp D:\


2. D:\>

javac -cp D:\ E:\Sandy\javaprogram\p1\



javac E:\Sandy\javaprogram\p1\


3. C:\>

javac -cp D:\ E:\Sandy\javaprogram\p1\


The following are compilation commands for executing our Class A from various locations.

1. E:\Sandy\javaprogram\p1>

java -cp D:\;.. p1.A


2. D:\>

java -cp .;E:\Sandy\javaprogram\ p1.A


3. C:\>

java -cp D:\;E:\Sandy\javaprogram\ p1.A



Similarly we can compile and execute more than one referred class.

Sandeep Sharma
Sandeep Sharma

Working as a Senior Engineering Analyst having work experience in Core Java, Struts, Spring, Hibernate, Maven, JSP, AJAX, JQuery, JSON, WebService,Jasper-Report,Oracle,MySQL,SQL-Server-2012.