Common gotchas in Java

Overview

Java is a minimalist language with deliberately less features than other languages, never the less it has edge cases which strange effects, and even some common cases with surprising effects to trip up the unwary. If you are used to reading another language you can easily read Java the wrong way leaving to confusion.

Variables are only references or primitives

That’s right, variables are not Objects. This means when you see the following, s is not an object, it is not a String, it is a reference to a String

String s = "Hello";

This answers many areas of confusion such as;

  • Q: If String is immutable how can I change it. e g. s += “!”;
  • A: You can’t in normal Java, you can only change a reference to a String.

== compares references, not their contents.

To add to the confusion, using == some times works. If you have two immutable values which are the same, the JVM can try to make the references the same too. e.g.

     String s1 = "Hi", s2 = "Hi";
    Integer a = 12, b = 12;

In both these case, an object pool is used so the references end up being the same. s1 == s2 and a == b are both true as the JVM has made the references to the same object. However, vary the code a little so the JVM doesn’t pool the objects, and == returns false, perhaps unexpectedly. In this case you need to use equals.

 String s3 = new String(s1);
    Integer c = -222, d = -222;
  s1 == s2      // is true
    s1 == s3      // is false
    s1.equals(s3) // is true
    a == b        // is true
    c == d        // is false (different objects were created)
    c.equals(d)   // is true

For Integer, the object pool starts at -128 up to at least 127 (possibly higher)

Java passes references by value

All variables are passed by value, even references. This means when you have a variable which is a reference to an object, this reference is copied, but not the object. e.g.

 public static void addAWord(StringBuilder sb) {
     sb.append(" word");
     sb = null;
}
 StringBuilder sb = new StringBuilder("first ");
addWord(sb);
addWord(sb);
System.out.println(sb); // prints "first word word"

The object referenced can be changed, but changes to the copied reference have no effect on the caller.

In most JVMs, the Object.hashCode() doesn’t have anything to do with memory location

A hashCode() has to remain constant. Without this fact hash collections like HashSet or ConcurrentHashMap wouldn’t work. However, the object can be anywhere in memory and can change location without your program being aware this has happened. Using the location for a hashCode wouldn’t work (unless you have a JVM where objects are not moved)

For OpenJDK and the HotSpot JVM, the hashCode() generated on demand and stored in the object’s header. Using Unsafe you can see whether the hashCode() has been set and even change it by over

Object.toString() does something surprising rather than useful

The default behaviour of toString() is to print an internal name for a class and a hashCode().

As mentioned the hashCode is not the memory location, even though it is printed in hexi-decimal. Also the class name, especially for arrays is confusing. For example; a String[] is printed as [Ljava.lang.String; The [ signifies that it is an array, the L signifies it is a "language" created class, not a primitive like byte which BTW has a code of B. and the ; signifies the end of the class. For example say you have an array like

 String[] words = { “Hello”, “World” };
System.out.println(words);

print something like

[Ljava.lang.String;@45ee12a7

Unfortunately you have to know that the class is an object array, e.g. if you have just Object words, you have a problem and you have to know to call Arrays.toString(words) instead. This break encapsulation in a rather bad way and a common source of confusion on StackOverflow.

I have asked different developers at Oracle about this and the impression I got is that it's too hard to fix it now.
 

Reference: Common gotchas in Java from our JCG partner Peter Lawrey at the Vanilla Java blog.
Related Whitepaper:

Bulletproof Java Code: A Practical Strategy for Developing Functional, Reliable, and Secure Java Code

Use Java? If you do, you know that Java software can be used to drive application logic of Web services or Web applications. Perhaps you use it for desktop applications? Or, embedded devices? Whatever your use of Java code, functional errors are the enemy!

To combat this enemy, your team might already perform functional testing. Even so, you're taking significant risks if you have not yet implemented a comprehensive team-wide quality management strategy. Such a strategy alleviates reliability, security, and performance problems to ensure that your code is free of functionality errors.Read this article to learn about this simple four-step strategy that is proven to make Java code more reliable, more secure, and easier to maintain.

Get it Now!  

One Response to "Common gotchas in Java"

  1. tamerlan says:

    your method is public static void addAWord(StringBuilder sb)

    and you are using addWord(sb); where is letter “A” in your method?

Leave a Reply


6 − one =



Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use | Privacy Policy
All trademarks and registered trademarks appearing on Java Code Geeks are the property of their respective owners.
Java is a trademark or registered trademark of Oracle Corporation in the United States and other countries.
Java Code Geeks is not connected to Oracle Corporation and is not sponsored by Oracle Corporation.

Sign up for our Newsletter

20,709 insiders are already enjoying weekly updates and complimentary whitepapers! Join them now to gain exclusive access to the latest news in the Java world, as well as insights about Android, Scala, Groovy and other related technologies.

As an extra bonus, by joining you will get our brand new e-books, published by Java Code Geeks and their JCG partners for your reading pleasure! Enter your info and stay on top of things,

  • Fresh trends
  • Cases and examples
  • Research and insights
  • Two complimentary e-books