I'm taking a stab at setting up unit tests for some utility classes in a project I'm working on, and one of the classes (contains licensing info) has a method that does some determination based on the current time.
i.e. the license contains an expiry date, and the license string validates that date, but the actual logic to see if the license is expired is based on the current time.
public boolean isValid()
{
return isLicenseStringValid() && !isExpired();
}
public boolean isExpired()
{
Date expiry = getExpiryDate();
if( expiry == null ) {
return false;
}
Date now = new Date();
return now.after( expiry );
}
So, I'm not sure what to do, since the 'new Date()' thing isn't a static criterion.
- Should I not bother to test 'isValid', and just test 'isLicenseStringValid()' and the 'getExpiryDate()' function separately?
- Do I just use a license key in the test with a crazy long expiry such that I'll have switched jobs by the time it expires?
- Do I try to mock out 'new Date()' to some 'getCurrentTime()' method such that I can fake what time it is now?
What do others normally do with tests that are time-conditional?
Use dependency injection and inject a
TimeProvider
that provides agetExpiryDate()
method.Definitely mock out
new Date()
.Create a
Clock
interface with agetCurrentTime()
method or something similar. That way you can have aFakeClock
for testing and aSystemClock
which usesSystem.currentTimeMillis()
or whatever.I've done this a number of times - it's worked extremely well. It's logical too - effectively you require a "current time service" so that should be injected like any other dependency.
All three approaches are possible:
I'd go for a comprimise: I'd add the current date as a parameter to the isExpired method, and the isValid method. For your live production code, add a simple
isValid()
no-arg override that callsisValid(new Date())
. Your test code uses the version that takes the current date as the parameter.I usually inject a date provider into the tested code. This also helps if you need to switch conventions or otherwise "fix" the time testing code.
If you feel the TimeProvider/Clock abstraction is too overboard perfectionist (which may very well be the case), consider this instead
Make getCurrentType protected virtual, then create a TestingProductionType decendant of the ProductionType that contains the code you posted. In that type, override the getCurrentType() method to return some deterministic result. In your unit test, create an instance of this TestingProductionType instead.
Viola, the dependency of current time is now removed from your unit tests. The only production code that is now not unit tested is a method with a single line returning new Date(). I could live with that.
If you can check out Mole at http://research.microsoft.com/en-us/projects/pex/
Moles allows to replace any .NET method with a delegate
Just use it to replace Date and have it return what ever you need. Then you don't need to do anything crazy.-Raul