Aditi Nawghare
Software Engineer at Siemens

Wrapper Classes in Java

Published in the Java Developer group
Hi! You are already well acquainted with primitive types, and have worked quite a bit with them. In programming (and Java in particular), primitives have many advantages: they use little memory (and thus make the program more efficient) and have a clearly delineated range of values. However, while learning Java, we've already often repeated the mantra "everything in Java is an object". But primitives directly contradict those words. They aren't objects. So, is our "everything is an object" principle false? Actually, it's not. In Java, every primitive type has a twin brother, a wrapper class.

What's a Wrapper Class?

A wrapper is a special class that stores a primitive internally. But because it's a class, you can create instances of it. They store the primitive values internally, but are still real objects. Wrapper class names are very similar to (or exactly the same as) the names of their corresponding primitives. So, they are easy to remember.
Wrapper Classes for Primitive Data Types
Primitive Data Types Wrapper Classes
int Integer
short Short
long Long
byte Byte
float Float
double Double
char Character
boolean Boolean
Wrapper objects are created the same way as any other object:

public static void main(String[] args) {

   Integer i = new Integer(682);
   Double d = new Double(2.33);
   Boolean b = new Boolean(false);
Wrapper classes let us mitigate the shortcomings of primitive types. The most obvious is that primitives don't have methods. For example, they don't have a toString() method, so you can't, for instance, convert an int to a String. But the Integer wrapper class makes this easy.

public static void main(String[] args) {

   Integer i = new Integer(432);
   String s = i.toString();
However, converting in the other direction can be trickier. Let's say we have a String, which we know for sure contains a number. Regardless, there's no native way to use a primitive int to extract the number from the String and convert it to a number. But, we can with the wrapper classes.

public static void main(String[] args) {

   String s = "1166628";

   Integer i = Integer.parseInt(s);

We successfully extracted a number from the String and assigned it to the Integer reference variable i. By the way, regarding references. You already know that arguments are passed to methods in different ways: primitives by value, and objects by reference. You can use this knowledge when creating your own methods: for example, if your method uses fractional numbers but you need logic to pass by reference, you can pass Double/Float arguments to the method instead of double/float. In addition to wrapper classes' methods, their static fields can also be very convenient. For example, imagine you have the following task: display the maximum possible int value, followed by the minimum possible value. This problem seems rather basic. But without Google, it's unlikely you could do it. But wrappers allow you to easily handle such "mundane tasks":

public class Main {
   public static void main(String[] args) {

These fields keep you from getting distracted from accomplishing more serious tasks. Not to mention the fact that typing in 2147483647 (which happens to be the value of MAX_VALUE) is no minor feat! :) Moreover, in a previous lesson, we pointed out that wrapper objects are immutable.

public static void main(String[] args) {

   Integer a = new Integer(0);
   Integer b = new Integer(0);

   b = a;
   a = 1;
The state of the object originally pointed to by a didn't change (because the value of b would have also changed). As with Strings, instead of changing the wrapper object's state, an entirely new object is created in memory. Wrapper Classes in Java - 2So, why did Java's creators ultimately decide to leave primitive types in the language? Since everything should be an object, and we've got wrapper classes that can express everything that primitives express, why not only keep the wrappers in the language and remove the primitives? The answer is simple: performance. Primitive types are called primitive because they lack many of the "heavyweight" features of objects. Yes, objects have many convenient methods, but you don't always need them. Sometimes, all you need is the number 33, or 2.62, or true/false. In situations where the advantages of objects don't matter and aren't required for the program to function, primitives are far better suited to the task.
Comments (11)
Damian Braś Level 11, Poland
19 April 2023
teraz rozumiem
Angel Li Level 18, Fremont, United States
26 June 2020
Say the Integer wrapper class is a box. The wrapper class contains int inside the box. Unwrapping is going from Integer to int, so basically unwrapping the box to get the int. Autowrapping is going from int to Integer, like a present is going to go inside the box. That's why it's auto.
Peter Schrijver Level 23, Hilversum, Netherlands
11 June 2020
Great material and good explanation
YSS Level 16, New York City, United States
8 December 2019
This article is technically wrong. Not everything in Java is an object. It's not because there are wrapper classes that all of a sudden primitives are objects. Therefore one should say 'Almost everything in Java is an Object' as some good books do these days.
Binesh Level 16, India
24 September 2019
Nice! Well Explained.
Renat Mukhametshin Level 16, Pervouralsk, Russain Federation
8 August 2019
ohh yeah!!
reka Level 19, Dunaujvaros, Hungary
11 March 2019
Boxing / autoboxing happens automatically and allows you to add an int to an ArrayList of Integers or add an Integer variable to an array of primitive int values: int i = 8; List<Integer> lst = new ArrayList<>(); lst.add(i); System.out.println(lst); // [8] System.out.println(lst.get(0) instanceof Integer); // true int[]arr = new int[1]; arr[0] = new Integer(5); System.out.println(Arrays.toString(arr)); // [5]
Fadi AlSaidi Level 13, Carrollton, United States
9 February 2019
Glad this was explained. I was wondering about this for a while.