Added an integration test to assert behavior.  Enhanced JavaDoc.