Java Packages - Java

What are Java Packages?

packages are used in Java with a view to prevent naming conflicts, to control access, to make searching/locating and usage of classes, interfaces, enumerations and annotations simpler, and so on.

A package can be defined as a grouping of related sorts (instructions, interfaces, enumerations and annotations ) providing access protection and namespace management.

a number of the present programs in Java are −

  • java.lang − bundles the fundamental lessons
  • − lessons for input , output features are bundled in this package

Programmers can define their own applications to package group of instructions/interfaces, etc. It is a great practice to group related classes implemented through you so that a programmer can without difficulty determine that the classes, interfaces, enumerations, and annotations are associated.

because the bundle creates a new namespace there might not be any name conflicts with names in different packages. the use of programs, it is easier to offer access control and it's also less complicated to locate the associated training.

Creating a Package

While creating a package, you must select a name for the package and contain a package statement beside with that name at the top of each source file that comprises the classes, interfaces, enumerations, and annotation types that you want to include in the package.

The package statement must be the first line in the source file. There can be only one package statement in each source file, and it applies to all types in the file.

If a package statement is not used then the class, interfaces, enumerations, and annotation types will be placed in the current default package.

To compile the Java programs with package statements, you have to use -d option as shown below.

Then a folder with the given package name is created in the specified destination, and the compiled class files will be placed in that folder.


Let us look at an example that creates a package called animals. It is a good practice to use names of packages with lower case letters to avoid any conflicts with the names of classes and interfaces.

Following package example contains interface named animals –

Now, let us implement the above interface in the same package animals –

Now compile the java files as shown below –

Now a package/folder with the name animals will be created in the current directory and these class files will be placed in it as shown below.


You can execute the class file within the package and get the result as shown below.

The import Keyword

If a class wants to use another class in the same package, the package name need not be used. Classes in the same package find each other without any special syntax.
Here, a class named Boss is added to the payroll package that already contains Employee. The Boss can then refer to the Employee class without using the payroll prefix, as demonstrated by the following Boss class.

What happens if the Employee class is not in the payroll package? The Boss class must then use one of the following techniques for referring to a class in a different package.

  • The fully qualified name of the class can be used. For example –
  • The package can be imported using the import keyword and the wild card (*). For example −

  • The class itself can be imported using the import keyword. For example –

Note − A class file can contain any number of import statements. The import statements must appear after the package statement and before the class declaration.

The Directory Structure of Packages

Two major results occur when a class is placed in a package −

  • The name of the package becomes a part of the name of the class, as we just discussed in the previous section.
  • The name of the package must match the directory structure where the corresponding bytecode resides.

Here is simple way of managing your files in Java −

Put the source code for a class, interface, enumeration, or annotation type in a text file whose name is the simple name of the type and whose extension is .java.

For example –

Now, put the source file in a directory whose name reflects the name of the package to which the class belongs –

Now, the qualified class name and pathname would be as follows −

  • Class name → vehicle.Car
  • Path name → vehicle\ (in windows)

In general, a company uses its reversed Internet domain name for its package names.

Example − A company's Internet domain name is, then all its package names would start with Each component of the package name corresponds to a subdirectory.

Example − The company had a package that contained a source file, it would be contained in a series of subdirectories like this –

At the time of compilation, the compiler creates a different output file for each class, interface and enumeration defined in it. The base name of the output file is the name of the type, and its extension is .class.
For example –

Now, compile this file as follows using -d option –

The files will be compiled as follows –

You can import all the classes or interfaces defined in \com\apple\computers\ as follows –

Like the .java source files, the compiled .class files should be in a series of directories that reflect the package name. However, the path to the .class files does not have to be the same as the path to the .java source files. You can arrange your source and class directories separately, as –

By doing this, it is possible to give access to the classes directory to other programmers without revealing your sources. You also need to manage source and class files in this manner so that the compiler and the Java Virtual Machine (JVM) can find all the types your program uses.

The full path to the classes directory, <path-two>\classes, is called the class path, and is set with the CLASSPATH system variable. Both the compiler and the JVM construct the path to your .class files by adding the package name to the class path.
Say <path-two>\classes is the class path, and the package name is, then the compiler and JVM will look for .class files in <path-two>\classes\com\apple\computers.

A class path may include several paths. Multiple paths should be separated by a semicolon (Windows) or colon (Unix). By default, the compiler and the JVM search the current directory and the JAR file containing the Java platform classes so that these directories are automatically in the class path.

Set CLASSPATH System Variable

To display the current CLASSPATH variable, use the following commands in Windows and UNIX (Bourne shell) −

  • In Windows → C:\> set CLASSPATH
  • In UNIX → % echo $CLASSPATH

To delete the current contents of the CLASSPATH variable, use −

  • In Windows → C:\> set CLASSPATH =
  • In UNIX → % unset CLASSPATH; export CLASSPATH

To set the CLASSPATH variable −

  • In Windows → set CLASSPATH = C:\users\jack\java\classes
  • In UNIX → % CLASSPATH = /home/jack/java/classes; export CLASSPATH

All rights reserved © 2020 Wisdom IT Services India Pvt. Ltd Protection Status

Java Topics