Course – LS – All

Get started with Spring and Spring Boot, through the Learn Spring course:


1. Introduction

In Java, we can use the hashCode() method to generate a hash code value for an object. This value is typically used for various purposes, such as storing objects in collections like HashMap or HashSet, where efficient retrieval and storage are essential.

Besides, writing unit tests for the hashCode() method ensures that it produces consistent and correct hash codes, which is crucial for properly functioning hash-based data structures.

In this article, we’ll delve into the importance of unit testing for the hashCode() method in Java.

2. Understanding the hashCode() Method

In Java, every object inherits the hashCode() method from the Object class, which generates a unique integer hash code value for the object based on its internal state. Typically, this hash code is computed using the memory address or certain object attributes, aiming to provide a fast and efficient way to identify objects:

public class MyClass {
    private String value;
    public MyClass(String value) {
        this.value = value;
    public int hashCode() {
        return value != null ? value.hashCode() : 0;

Here, we define a simple MyClass class with a value field. The hashCode() method is overridden to calculate the hash code based on the value of this field.

This implementation ensures that objects with the same value produce the same hash code, a fundamental requirement for hash-based data structures.

3. Testing Consistency

One fundamental requirement for the hashCode() method is consistency. An object’s hash code should remain constant across multiple invocations as long as its state remains unchanged. Here’s an example of how to test for consistency:

public void givenObject_whenTestingHashCodeConsistency_thenConsistentHashCodeReturned() {
    MyClass obj = new MyClass("value");
    int hashCode1 = obj.hashCode();
    int hashCode2 = obj.hashCode();
    assertEquals(hashCode1, hashCode2);

Here, we create an instance of the MyClass object named obj with a specific value. We then retrieve the hash code of obj twice, storing the results in variables hashCode1 and hashCode2.

Finally, we use the assertEquals() method to assert that both hash codes are equal, confirming that the hash code remains consistent across multiple invocations for an object with an unchanged state.

4. Testing Equality

Objects with equal states should produce the same hash code. Therefore, it’s essential to verify that objects with identical states generate identical hash codes. Here’s how we can test for equality:

public void givenTwoEqualObjects_whenTestingHashCodeEquality_thenEqualHashCodesReturned() {
    MyClass obj1 = new MyClass("value");
    MyClass obj2 = new MyClass("value");
    assertEquals(obj1.hashCode(), obj2.hashCode());

This test validates that the hashCode() method produces consistent hash codes for objects with identical states. By confirming the equality of hash codes for equal objects, we ensure that hash-based collections can correctly identify and manage objects with the same state.

5. Testing Distribution

A good hash function should produce hash codes that are evenly distributed across the range of possible values. To test for distribution, we can analyze the distribution of hash codes generated for a large number of objects:

public void givenMultipleObjects_whenTestingHashCodeDistribution_thenEvenDistributionOfHashCodes() {
    List<MyClass> objects = new ArrayList<>();
    for (int i = 0; i < 1000; i++) {
        objects.add(new MyClass("value" + i));
    Set<Integer> hashCodes = new HashSet<>();
    for (MyClass obj : objects) {
    assertEquals(objects.size(), hashCodes.size(), 10);

In this test, we create a list of MyClass objects named objects containing 1000 elements. In addition, each object is initialized with a unique value derived from the iteration index. We then iterate over the list and add the hash codes of each object to a set.

Since a set can’t contain duplicate elements, we expect the size of the set (hashCodes.size()) to be equal to the number of objects (objects.size()). The tolerance value of 10 allows for minor variations in hash code distribution.

By comparing the size of the set to the number of objects, we verify that the hash codes generated for the objects exhibit an even distribution.

6. Conclusion

Unit testing the hashCode() method is essential to ensure its correctness, consistency, and distribution. By following effective testing strategies like testing for consistency, equality, and distribution, we can validate the behavior of the hashCode() method and ensure the reliability of hash-based data structures in Java applications.

As usual, the accompanying source code can be found over on GitHub.

Course – LS – All

Get started with Spring and Spring Boot, through the Learn Spring course:

res – REST with Spring (eBook) (everywhere)
Notify of
Inline Feedbacks
View all comments