2/26/2018 Java: Packages and Import

Java Notes

Packages and Import

Package = directory. Java classes can be grouped together in packages. A package name is the same as the
directory (folder) name which contains the .java files. You declare packages when you define your Java program,
and you name the packages you want to use from other libraries in an import statement.

Package declaration
The first statement, other than comments, in a Java source file, must be the package declaration.
Following the optional package declaration, you can have import statements, which allow you to specify classes from
other packages that can be referenced without qualifying them with their package.
Default package. Altho all Java classes are in a directory, it's possible to omit the package declaration. For small
programs it's common to omit it, in which case Java creates what it calls a default package. Sun recommends that
you do not use default packages.

Package declaration syntax

The statement order is as follows. Comments can go anywhere.
1. Package statment (optional).
2. Imports (optional).
3. Class or interface definitions.

// This source file must be Drawing.java in the illustration directory.

package illustration;

import java.awt.*;

public class Drawing {

. . .
}

Imports: three options

The JOptionPane class is in the swing package, which is located in the javax package. The wildcard character (*) is
used to specify that all classes with that package are available to your program. This is the most common
programming style.

import javax.swing.*; // Make all classes visible altho only one is used.

class ImportTest {
public static void main(String[] args) {
JOptionPane.showMessageDialog(null, "Hi");
System.exit(0);
}
}

Classes can be specified explicitly on import instead of using the wildcard character.

import javax.swing.JOptionPane; // Make a single class visible.

class ImportTest {
public static void main(String[] args) {
JOptionPane.showMessageDialog(null, "Hi");
System.exit(0); Width: 1366
https://www.leepoint.net/language/10basics/import.html 1/3
2/26/2018 Java: Packages and Import

}
}

Alternately we can the fully qualified class name without an import.

class ImportTest {
public static void main(String[] args) {
javax.swing.JOptionPane.showMessageDialog(null, "Hi");
System.exit(0);
}
}

Common imports
There are 166 packages containing 3279 classes and interfaces in Java 5. However, only a few packages are used in
most programming. GUI programs typically use at least the first three imports.

import java.awt.*; Common GUI elements.

import java.awt.event.*; The most common GUI event listeners.
import javax.swing.*; More common GUI elements. Note "javax".
import java.util.*; Data structures (Collections), time, Scanner, etc classes.
import java.io.*; Input-output classes.
import java.text.*; Some formatting classes.
import java.util.regex.*; Regular expression classes.

import FAQ
1. Q: Does importing all classes in a package make my object file (.class or .jar) larger?
A: No, import only tells the compiler where to look for symbols.
2. Q: Is it less efficient to import all classes than only the classes I need?
A: No. The search for names is very efficient so there is no effective difference.
3. Q: Doesn't it provide better documentation to import each class explicitly?
A: This shows good intentions, but ...
It's hard to remember to remove classes when they are no longer used, so the import list is
surprisingly often wrong. It can seriously slow down reading because unusual or unexpected class
imports make me look for that class, only to discover that it must have been used in an earlier
version.
Explicit class imports permit accidentally defining classes with names that conflict with the standard
library names. This is very bad. Using "*" to import all classes prevents this dangerous naming
accident.
It's annoying to always update this list, altho if you use NetBeans, fixing the list is only a click away
(see below).
4. Q: I've imported java.awt.*, why do I also need java.awt.event.*?
A: The wildcard "*" only makes the classes in this package visible, not any of the subpackages.
5. Q: Why don't I need an import to use String, System, etc?
A: All classes in the java.lang package are visible without an import.
6. Q: Is the order of the imports important?
A: No. Group them for readability.

NetBeans creates packages by default

The project name is used as the default package name, but you can change it.
A directory / folder is created with this project name. This directory name is the name of your package.
Width:
A package declaration is automatically inserted 1366
into each new source file it creates.

https://www.leepoint.net/language/10basics/import.html 2/3
2/26/2018 Java: Packages and Import

When you build a main project, the double-clickable .jar file uses this project/package/directory name.

NetBeans will create your imports

If you forgot to write import statements, or don't remember which package a class is in, no problem. Just right click
on the source file and choose Fix Imports. It will add all necessary import statements.

Static imports in Java 5

Java 5 added an import static option that allows static variables (typically constants) to be referenced without
qualifying them with a class name. For example, after

import static java.awt.Color;

It would then be possible to write

Color background = RED;

instead of

Color background = Color.RED;

Adding this "feature" wasn't the best idea because it leads to name pollution and confusion about which class
constants come from. Even Sun (see References below) basically advises not to use it!

References
Static Import, http://java.sun.com/j2se/1.5.0/docs/guide/language/static-import.html.

Copyleft 2006 Fred Swartz MIT License

https://www.leepoint.net/language/10basics/import.html 3/3