Java Tutorial

Java Control Statements

Object Oriented Programming

Java Built-in Classes

Java File Handling

Java Error & Exceptions

Java Multithreading

Java Synchronization

Java Networking

Java Collections

Java List Interface

Java Queue Interface

Java Map Interface

Java Set Interface

Java Data Structures

Java Collections Algorithms

Java Miscellaneous

Advanced Java

Java APIs & Frameworks

Java Useful Resources

Java - Wrapper Classes

Why Java Wrapper Classes Required?

Normally, when we work with Numbers, we use primitive data types such as byte, int, long, double, etc.


int i = 5000;
float gpa = 13.65f;
double mask = 125;

However, in development, we come across situations where we need to use objects instead of primitive data types. In order to achieve this, Java provides wrapper classes.

Java Wrapper Classes

  • Wrapper classes are those whose objects wraps a primitive data type within them.

  • In the java.lang package java provides a separate class for each of the primitive data types namely Byte, Character, Double, Integer, Float, Long, Short.

  • At the time of instantiation, these classes accept a primitive datatype directly, or in the form of String.

  • Wrapper classes provide methods to, convert primitive datatypes within them to String objects and, to compare them with other objects etc.

  • Using wrapper classes, you can also add primitive datatypes to various Collection objects such as ArrayList, HashMap etc. You can also pass primitive values over a network using wrapper classes.

All the wrapper classes (Integer, Long, Byte, Double, Float, Short) are subclasses of the abstract class Number.

Number Classes

Object of Java Wrapper Class

The object of the wrapper class contains or wraps its respective primitive data type. Converting primitive data types into object is called boxing, and this is taken care by the compiler. Therefore, while using a wrapper class you just need to pass the value of the primitive data type to the constructor of the Wrapper class.

And the Wrapper object will be converted back to a primitive data type, and this process is called unboxing. The Number class is part of the java.lang package.

Creating Java Wrapper Class Objects

In Java, to create a wrapper object, you have to use the wrapper class instead of the primitive data type.

If you want to print the values of these objects, just print the object.

Consider the below syntax:

wrapper_class object_name = value;

Example of Java Wrapper Class

Following is an example of boxing and unboxing −

In this example, we've showcase use of primitives and their operations using a wrapper class. In first statement we've assigned an int to an Integer object x which is termed as boxing. In second statment, we're adding 10 to x which requires x to be unboxed as int and addition is performed and result is assigned back to the variable x and printed.

public class Test {

   public static void main(String args[]) {
      Integer x = 5; // boxes int to an Integer object
      x =  x + 10;   // unboxes the Integer to a int



When x is assigned an integer value, the compiler boxes the integer because x is integer object. Later, x is unboxed so that they can be added as an integer.

List of Java Wrapper Classes

Following is the list of the wrapper classes that all the subclasses of the Number class −

Sr.No. Class & Description


The Java Boolean class wraps a value of the primitive type boolean in an object.



The Java Byte class wraps a value of the primitive type byte in an object.



The Java Character class wraps a value of the primitive type char in an object.



The Java Double class wraps a value of the primitive type double in an object.



The Java Float class wraps a value of the primitive type float in an object.



The Java Float class wraps a value of the primitive type float in an object.



The Java Long class wraps a value of the primitive type long in an object.



The Java Short class wraps a value of the primitive type short in an object.