Quick introduction to EasyRandom

BOUFATAH Amine — Tue, 18 Apr 2023 22:55:33 +0000

Hey Folks ,

Today I'd like to give some words about an interesting library that I have recently discovered and which I'd wish I had known before. This library called EasyRandom is useful when writing test code/sample code.

EasyRandom simply put

EasyRandom is a library that generates Java beans. It is mainly used to help create example objects that you use for testing.

Sometimes while we are writing test code, we find ourselves writing a lot of sample data to test our components, it may be tedious to write such data especially if the object tree is way too big, think of a Person object having one address object, a List of Employers, a Department and so on.. Writing sample data for this scenario is tiresome and uninteresting, this is exactly when EasyRandom comes in handy.

Let's dive into a simple example, suppose we have a java object representing an Employee as follows:

This is a simple POJO, that has no nested objects/dependencies.

Single object

Generating a single object will be done through the nextObject method:

A list of objects

What if we wanted a list of Employees to be generated ? simple, use the objects method which will return a Stream of the desired objects:

This method will generate a list of 10 employees.

Complex object

Great!!! now let's put more complexity in our model:

The object generated after calling nextObject looks like the following:

[Employee(firstName=eOMtThyhVNLWUZNRcBaQKxI, lastName=yedUsFwdkelQbxeTeQOvaScfqIOOmaa, hiringDate=2024-06-18, contactNumber=JxkyvRnL, department=Department(name=RYtGKbgicZaHCBRQDSx), manager=Manager(managerLevel=VLhpfQGTMDYpsBZxvfBoeygjb), position=Position(positionCode=oDLDPR), previousEmployers=[Employer(employerName=IQrWtYnHcO, contactNumber=XgLyqkDjxtCDIj), Employer(employerName=zQeAydAJIwkGuKWiVZLRcElhreuxvw, contactNumber=YVeSelxWdEtYtJHV), Employer(employerName=VIhYOTAybWXyBzGqRe, contactNumber=wKkOqxJSqDjAtcDF), Employer(employerName=hXJISTd, contactNumber=cdpW), Employer(employerName=hXJISTd, contactNumber=cdpW), Employer(employerName=hXJISTd, contactNumber=cdpW), Employer(employerName=GGiDYDmCRViOaAXNumPGEBX, contactNumber=O), Employer(employerName=bplgXS, contactNumber=PAgcjtZAOBahwMGwNikIaKuxYYVASJc), Employer(employerName=RRVabC, contactNumber=DwmrfUyJVSbdBFIyjTfpDItaXB), Employer(employerName=bplgXS, 
.................

We could see from the result shown above that the library created many Employer objects for our Employee, in my case it created 48, maybe we do not need that many employers for our tests, and that's where EasyParameters comes in. EasyParameters is an object which enables us customize the creation of our objects:

Through the EasyRandomParameters I've chosen to generate at max 3 items in a collection, I've also set the range of dates that should be picked when generating a random Date.

Run the program and this time the result is more convenient:

[Employee(firstName=eOMtThyhVNLWUZNRcBaQKxI, lastName=yedUsFwdkelQbxeTeQOvaScfqIOOmaa, hiringDate=2022-05-19, contactNumber=JxkyvRnL, department=Department(name=RYtGKbgicZaHCBRQDSx), manager=Manager(managerLevel=VLhpfQGTMDYpsBZxvfBoeygjb), position=Position(positionCode=GGiDYDmCRViOaAXNumPGEBX), previousEmployers=[Employer(employerName=JuhuUTlSCYdTVoSsJGyClHNnCWZGwZ, contactNumber=ImfitPVWqHXHNeZIUAYI)])]

That's it for this quick introduction to EasyRandom. For more details please refer to the official documentation.

Wrapper classes and caching pitfalls

BOUFATAH Amine — Mon, 02 Aug 2021 15:09:21 +0000

Wrapper Classes

As you all know, the Java language comes up with Primitive Wrapper classes (Integer for int, Double for double, Long for long, Character for char and so on).

Wrapper classes provide a way to use primitive data types (int, boolean, etc..) as objects.

Wrapper classes are immutable just like Strings and most Java Developers ignore that just like String objects these wrapper classes have also their own constant pool and that's tricky...

The problem

Consider the following method:

And now the main method:

Can you guess the program's output after launching the main method?

If your answer was:

1==1 ? true
1==2 ? false
127==127 ? true
128==128 ? true

Then unfortunately you got it wrong in the last one. Here's the right answer:

1==1 ? true
1==2 ? false
127==127 ? true
128==128 ? false

Surprise!!!

What happened?

The problem is that an Integer is an object and because we are using the == operator, we are comparing references in the heap here and not actual values.

You may reply: "Okay but then why does the program print out true in the case of 1==1?". Alright let me explain that for you in a simple way, when you write the following code:

The compiler transforms it to this code behind the scenes:

This is called Autoboxing.

Autoboxing/Unboxing

It's a mechanism used by the compiler to transform automatically wrapper classes to their primitive types (autoboxing) and the other way around (unboxing).

When we call the equals method like the following equals(1,1), the compiler is smart enough to notice that the equals method takes 2 Integer objects as parameters and not primitives, that's when Autoboxing happens, the compiler transforms your primitive data type (int) into a wrapper object (Integer) by calling the valueOf() method.

Okay, so there must be something going on under the valueOf() method. Let's have a look:

As you can see this method caches objects that have values between -128 and 127. This basically means that whenever we ask for an Integer between these values Java will always provide the same instance and that's the reason why 1==1 renders true and 128 == 128 renders false.

Best practice

The best practice here in order to test the equality of wrapper classes is to use the equals() method which compares object values rather than object references in the heap.

DEV Community: BOUFATAH Amine