Nelz' Blog

Ruminations on Development


Tuesday Nov 13, 2007

JECTU Version 0.2.1 Now Available

While using JECTU at my day job today, I realized that much of the benefit of JECTU is neutered by requiring the class-under-test to have a no-arg constructor. So, I added the ability to pass in concrete instances of the class-under-test.

You can find the artifact up for download both here and on the Google Project page. And the most recent version of the Maven generated documentation is hosted here on my site.

Monday Nov 12, 2007

JECTU Version 0.2.0 Now Available!

Over the past two weeks, I've been working hard on JECTU.

In addition to finding a new home repository, I have also been working on the code itself.

I believe I am at a point where JECTU can be generally useful, as I have updated it to handle reference types (i.e. Objects, not just primitives). There are still a couple of types that it doesn't cover, but classes extending Object are muy importante.

I have put the artifact up for download both here and on the Google Project page. And, the Maven generated documentation is still hosted here on my site.

I plan to flesh out a "How To" on using JECTU in your tests within the next couple of days.

Thursday Nov 01, 2007

JECTU's New Home

Since my last post, I decided to get off my duff and put the source code for JECTU up somewhere, so that it would actually be an "open source" project.

I chose Google Code Project Hosting as the new home. It's got just about everything I need. (The only thing I haven't worked out yet is how to publish the static Maven html "site" pages on there, so I'm still keeping it on my own server for now.)

Please, come and join me if you think this project could be of use to you!

Monday Oct 29, 2007

Announcing JECTU - the Java Equals Contract Test Utility

For the last couple of months, I've been writing tests for a bunch of domain objects. One of the big things when dealing with domain objects is dealing with identity. The equals(Object obj) and hashCode() methods are the two major levers a Java programmer has when dealing with identity.

There is a lot of overhead when testing equality in Java. There is an explicit set of characteristics (reflexive, transitive, consistent, symmetric) that a well-written equals method must adhere to, and I got tired of writing similar code, over and over again to test this code.

So, as I have heard many a time, as soon as I got tired of doing something over an over again, I wrote a utility to help me.

I have gotten to a decent starting point and wanted to open source my efforts. So, I now present to you: JECTU - the Java Equals Contract Test Utility.

Yes, I have quite a ways to go before it is a first-class test utility, but it is now in a usable state, so I thought I'd share it out now. In the future, I may find a home for it on SourceForge or on Google Code, but for now, I'm just going to host it here.

I am also still trying to figure out the Maven site publishing, and how to add extra pages to the static site output, so the download link is not mentioned in the Maven output. Here are the corresponding links:

Let me know if you have any questions or suggestions!


Update 20071112: I have changed the directory structure around a bit, and I updated the links here to reflect the new structure.