On Mar 11, 2008, at 9:46 AM, Jerome Louvel wrote:

Actually, there is already a paragraph on this in the Javadocs (1.1 M2) at the class level, but not for each getter. I have just added a note to each
getter returning encoded strings.

Thanks.

I meant that it might 'clutter' the class to add "getDecoded***()" methods.

Yes, but I prefer to err on the side of points of use rather than class definition. By that I mean that if getDecoded*() methods are not defined, then every use of get*() methods where one wants decoding requires something like:

        path = Reference.decode( ref.getPath() );

which is more verbose than:

        path = ref.getDecodedPath();

The "clutter", instead of being hidden away in the source file of Reference.java, is now dispersed to every use of the functions.

- Paul

Reply via email to