Question

I’m quite new to java programming, but I’ll try to use the correct terms and avoid misunderstandings as much as possible.

I’ve found some answers to topics quite similar to my problem but or I just cannot see how they really fit to my problem, or maybe they really just don’t fit. Some of them use mocked objects but I’m not sure it is the right option in my case.

General description

I need to have an array of objects which information is loaded from a random accessed binary files. The first bytes of the binary files are the header of the files which define how the data is stored in the files, basically says the length of some fields which help to compute the position of desired data in the files.

So now I want to test the method that will be called to load the desired data, which is specified by UnitListElement object, to the Unit object. For this I only focus on a single reading of a binary file.

More detailed view

I have a java class called Unit with some attributes, let’s say a,*b* and c. The value for this attributes is loaded with a method call getDataFromBinFile:

public class Unit{
    public double[] a;
    public double[] b;
    public double[] c;

getDataFromBinFile(UnitListElement element){
    <here loads the data from the binary file with random access>
}
}

The method for loading the data from the binary file, opens the binary file and access to the desired data in the binary file. The desired data to be read is specified in a UnitListElement object:

public class UnitListElement{
    public String pathOfFile;
    public int beginToReadAt;  // info related to where the desired data begins
    public int finishReading;  // info related to where the desired data ends
} 

The attributes beginToReadAt and finishReading time references which are used, along with the binary file’s header, to compute the first and last byte positions to read from the binary file.

So what I need to do is a test where I call the method getDataFromBinFile(unitListEl) and test whether the info returned is correct or not.

options for solutions

1st option

In some posts with similar problems propose to use mock objects. I’ve tried to find documentation about mocking objects but I haven’t found any easy beginners guide. So although not understanding mock objects very much, my impression is that the do not fit into this case since what I want to test is the reading of the binary file, not just the interaction with other objects.

2nd option

Another option is to create the binary file for the test inside the test with a helper method, f.i. with a @BeforeClass, and run the test with this temporary file and then delete it with a @AfterClass method.

Question

What do you think is the best practice considering a TDD approach? Do mock objects really fit in this case? If they do, is there any documentation with basic examples for total beginners?

or on the other hand, the creation of the file is more suitable for testing reading methods?

Thanks

Lots of thanks in advance.

Answer 1

Mocking can be applied to your case, but it is in fact not strictly necessary here. All you need is decouple the actual data processing logic in getDataFromBinFile from the code reading the bytes from files.

You can achieve this in (at least) two ways:

• With mocks: hide the file reading code behind an interface method which takes a UnitListElement and returns a byte array, then use this in getDataFromBinFile. Then you can mock this interface in your tests with a mock reader which just returns some predefined bytes without accessing any files. (Alternatively, you can move the file reading logic into UnitListElement itself, as for now it seems to be a POD class.)
• Without mocks: change the signature of getDataFromBinFile to take a byte array parameter instead of a UnitListElement. In your real production code, you can read the data from the file position described by the UnitListElement, then pass it to getDataFromBinFile. In your unit tests, you can just pass any binary data to it directly. (Note that in this case, it makes sense to rename your method to something like getDataFromBytes.)

For mocking, I have been using EasyMock so far. I find its documentation fairly easy to understand, hope that helps.