Archive for September 4, 2008

Java Documentation Additions

September 4, 2008 at 2:25 pm · Filed under Uncategorized

We were working on something and everyone is contributing little little snippet of codes, a method here and there. We document too a lot so I being the manager of the code put @author on every method of every class, bcos one person can not say he is the one that wrote a particular class from start to finish.

When I run javadoc, I recieved a very great shock. There are a lot of warnings flying across my screen and the bottomline line is Javadoc only supports @author on the class or package and not on methods grrrrrrrrr

I have to remove all the @author in the files(thanks to cat and grep) but wont it be a nice addition if subsequent versions of javadoc support this tag on methods too?

Never mind its me just thinking aloud.

ciao

Leave a Comment

Discoveries

September 4, 2008 at 2:16 pm · Filed under Netbeans, general talks

Now I have been programming for some time and I just made a discovery today. I am writing an RMI application and I asked one of my methods to return an Enumeration. I keep getting errors(bcos I catch all errors and print my own error message). After some time I did printStackTrace() and the error was interesting. I am so sorry I couldn’t paste the stack trace, but it said something about serialising(Unsearalizable Error) so I checked the javadoc, and read the FAQ in the collections framework, what I discovered? The Java Collection Framework can not be Serialized.

This is a big discovery for me and It makes my work even more interesting because right now I am serializing a whole lot of Java Data Structures(dont ask me how, you will know later :) ) major of them is the Hashtable.

You want to know what I am working on? Yes its a DHT you can find the project source at

http://gitorious.org/projects/hashquel

Thats all for now folks

ciao

Comments (4)