Agreed.  Documentation is absolutely needed.  In fact, this exact issue cost
me several hours of debugging time when I first started using the library.
The fact is that, for example, ArrayList operations work fine without hash,
but CollectionUtils augmentations don't.

Like Greg, I very rarely implement hash, since I tend not to need it, and
its a major pain to code properly.

.T.

On 1/28/03 11:06 AM, [EMAIL PROTECTED] wrote:

> Peter...
> 
> Ok, fair enough.  Point well taken.  If I expect hash-related data
> structures to
> work I need to complete the implementation of my objects.  But...  are you
> advocating that a programmer have intimate knowledge of an API's
> implementation
> in order to get the "expected" semantics?  The fact remains that there
> is a behavior
> difference between the commons and java APIs, for whatever reason.
> Neither documentation set stresses the importance of implementing #hashCode
> (and at least in my experience this is not something I would commonly do
> for every object I create).  At the very least this should be documented
> heavily
> to reset users' expectations or the semantics changed.
> 
> Regards,
> Greg

-- 
    WAR is NOT a NECESSITY

    http://www.UnitedForPeace.org/
    http://www.NotInOurName.net/
    http://www.MoveOn.org/



--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to