Sunday, 12 April 2015

Java Package


java package is a group of similar types of classes, interfaces and sub-packages.
Package in java can be categorized in two form, built-in package and user-defined package.
There are many built-in packages such as java, lang, awt, javax, swing, net, io, util, sql etc.
Here, we will have the detailed learning of creating and using user-defined packages.

Advantage of Java Package

1) Java package is used to categorize the classes and interfaces so that they can be easily maintained.
2) Java package provides access protection.
3) Java package removes naming collision.
package in java


Simple example of java package

The package keyword is used to create a package in java.
  1. //save as Simple.java  
  2. package mypack;  
  3. public class Simple{  
  4.  public static void main(String args[]){  
  5.     System.out.println("Welcome to package");  
  6.    }  
  7. }  

How to compile java package

If you are not using any IDE, you need to follow the syntax given below:
  1. javac -d directory javafilename  
For example
  1. javac -d . Simple.java  
The -d switch specifies the destination where to put the generated class file. You can use any directory name like /home (in case of Linux), d:/abc (in case of windows) etc. If you want to keep the package within the same directory, you can use . (dot).

How to run java package program

You need to use fully qualified name e.g. mypack.Simple etc to run the class.

To Compile: javac -d . Simple.java
To Run: java mypack.Simple
Output:Welcome to package
The -d is a switch that tells the compiler where to put the class file i.e. it represents destination. The . represents the current folder.


How to access package from another package?

There are three ways to access the package from outside the package.
  1. import package.*;
  2. import package.classname;
  3. fully qualified name.

1) Using packagename.*

If you use package.* then all the classes and interfaces of this package will be accessible but not subpackages.
The import keyword is used to make the classes and interface of another package accessible to the current package.

Example of package that import the packagename.*

  1. //save by A.java  
  2.   
  3. package pack;  
  4. public class A{  
  5.   public void msg(){System.out.println("Hello");}  
  6. }  
  1. //save by B.java  
  2.   
  3. package mypack;  
  4. import pack.*;  
  5.   
  6. class B{  
  7.   public static void main(String args[]){  
  8.    A obj = new A();  
  9.    obj.msg();  
  10.   }  
  11. }  
Output:Hello


2) Using packagename.classname

If you import package.classname then only declared class of this package will be accessible.

Example of package by import package.classname

  1. //save by A.java  
  2.   
  3. package pack;  
  4. public class A{  
  5.   public void msg(){System.out.println("Hello");}  
  6. }  
  1. //save by B.java  
  2.   
  3. package mypack;  
  4. import pack.A;  
  5.   
  6. class B{  
  7.   public static void main(String args[]){  
  8.    A obj = new A();  
  9.    obj.msg();  
  10.   }  
  11. }  
Output:Hello


3) Using fully qualified name

If you use fully qualified name then only declared class of this package will be accessible. Now there is no need to import. But you need to use fully qualified name every time when you are accessing the class or interface.
It is generally used when two packages have same class name e.g. java.util and java.sql packages contain Date class.

Example of package by import fully qualified name

  1. //save by A.java  
  2.   
  3. package pack;  
  4. public class A{  
  5.   public void msg(){System.out.println("Hello");}  
  6. }  
  1. //save by B.java  
  2.   
  3. package mypack;  
  4. class B{  
  5.   public static void main(String args[]){  
  6.    pack.A obj = new pack.A();//using fully qualified name  
  7.    obj.msg();  
  8.   }  
  9. }  
Output:Hello

Note: If you import a package, subpackages will not be imported.

If you import a package, all the classes and interface of that package will be imported excluding the classes and interfaces of the subpackages. Hence, you need to import the subpackage as well.

Note: Sequence of the program must be package then import then class.

sequence of package


Subpackage in java

Package inside the package is called the subpackage. It should be created to categorize the package further.
Let's take an example, Sun Microsystem has definded a package named java that contains many classes like System, String, Reader, Writer, Socket etc. These classes represent a particular group e.g. Reader and Writer classes are for Input/Output operation, Socket and ServerSocket classes are for networking etc and so on. So, Sun has subcategorized the java package into subpackages such as lang, net, io etc. and put the Input/Output related classes in io package, Server and ServerSocket classes in net packages and so on.

The standard of defining package is domain.company.package e.g. com.javatpoint.bean or org.sssit.dao.

Example of Subpackage

  1. package com.javatpoint.core;  
  2. class Simple{  
  3.   public static void main(String args[]){  
  4.    System.out.println("Hello subpackage");  
  5.   }  
  6. }  
To Compile: javac -d . Simple.java
To Run: java com.javatpoint.core.Simple
Output:Hello subpackage


How to send the class file to another directory or drive?

There is a scenario, I want to put the class file of A.java source file in classes folder of c: drive. For example:
how to put class file in another package
  1. //save as Simple.java  
  2.   
  3. package mypack;  
  4. public class Simple{  
  5.  public static void main(String args[]){  
  6.     System.out.println("Welcome to package");  
  7.    }  
  8. }  

To Compile:

e:\sources> javac -d c:\classes Simple.java

To Run:

To run this program from e:\source directory, you need to set classpath of the directory where the class file resides.
e:\sources> set classpath=c:\classes;.;
e:\sources> java mypack.Simple

Another way to run this program by -classpath switch of java:

The -classpath switch can be used with javac and java tool.
To run this program from e:\source directory, you can use -classpath switch of java that tells where to look for class file. For example:
e:\sources> java -classpath c:\classes mypack.Simple
Output:Welcome to package


Ways to load the class files or jar files

There are two ways to load the class files temporary and permanent.
  • Temporary
    • By setting the classpath in the command prompt
    • By -classpath switch
  • Permanent
    • By setting the classpath in the environment variables
    • By creating the jar file, that contains all the class files, and copying the jar file in the jre/lib/ext folder.

Rule: There can be only one public class in a java source file and it must be saved by the public class name.

  1. //save as C.java otherwise Compilte Time Error  
  2.   
  3. class A{}  
  4. class B{}  
  5. public class C{}  


How to put two public classes in a package?

If you want to put two public classes in a package, have two java source files containing one public class, but keep the package name same. For example:
  1. //save as A.java  
  2.   
  3. package javatpoint;  
  4. public class A{}  
  1. //save as B.java  
  2.   
  3. package javatpoint;  
  4. public class B{}  


What is static import feature of Java5?

Click Static Import feature of Java5.

What about package class?

Click for Package class

Static Import


The static import feature of Java 5 facilitate the java programmer to access any static member of a class directly. There is no need to qualify it by the class name.

Advantage of static import:

  • Less coding is required if you have access any static member of a class oftenly.

Disadvantage of static import:

  • If you overuse the static import feature, it makes the program unreadable and unmaintainable.

Simple Example of static import

  1. import static java.lang.System.*;    
  2. class StaticImportExample{  
  3.   public static void main(String args[]){  
  4.      
  5.    out.println("Hello");//Now no need of System.out  
  6.    out.println("Java");  
  7.   
  8.  }   
  9. }  
  10.       

Output:Hello
       Java
  

What is the difference between import and static import?

The import allows the java programmer to access classes of a package without package qualification whereas the static import feature allows to access the static members of a class without the class qualification. The import provides accessibility to classes and interface whereas static import provides accessibility to static members of the class.

Package class


The package class provides methods to get information about the specification and implementation of a package. It provides methods such as getName(), getImplementationTitle(), getImplementationVendor(), getImplementationVersion() etc.

Example of Package class

In this example, we are printing the details of java.lang package by invoking the methods of package class.




  1. class PackageInfo{  
  2. public static void main(String args[]){  
  3.    
  4. Package p=Package.getPackage("java.lang");  
  5.   
  6. System.out.println("package name: "+p.getName());  
  7.   
  8. System.out.println("Specification Title: "+p.getSpecificationTitle());  
  9. System.out.println("Specification Vendor: "+p.getSpecificationVendor());  
  10. System.out.println("Specification Version: "+p.getSpecificationVersion());  
  11.   
  12. System.out.println("Implementaion Title: "+p.getImplementationTitle());  
  13. System.out.println("Implementation Vendor: "+p.getImplementationVendor());  
  14. System.out.println("Implementation Version: "+p.getImplementationVersion());  
  15. System.out.println("Is sealed: "+p.isSealed());  
  16.   
  17.   
  18.  }  
  19. }  
Output:package name: java.lang
       Specification Title: Java Plateform API Specification
       Specification Vendor: Sun Microsystems, Inc.
       Specification Version: 1.6
       Implemenation Title: Java Runtime Environment
       Implemenation Vendor: Sun Microsystems, Inc.
       Implemenation Version: 1.6.0_30
       IS sealed: false