wood burning stoves*
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Javadoc and nested classes? Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Murach's Java Servlets and JSP this week in the Servlets forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Javadoc and nested classes?" Watch "Javadoc and nested classes?" New topic
Author

Javadoc and nested classes?

Robert Konigsberg
Ranch Hand

Joined: Jun 23, 2004
Posts: 172
What do you think is sun's policy on nested classes being documented? I have a JTable and within it I have an implementation of AbstractTableModel. I do not know how to run javadoc so nested classes are included, nor do I want to put the implementation of AbstractTableModel in its own class file. However the requirements say that all classes must be documented using javadoc.

Can someone who passed and had this problem tell me what they did?

Also, here's a question I hate to ask: do you think they're including anonymous classes in that requirement?


SCJP 1.4 (91%)<br />SCJD 1.4 (376/400, 94%)
Robert Konigsberg
Ranch Hand

Joined: Jun 23, 2004
Posts: 172
Well the good news is I answered my own question about nested classes: make them public and javadoc will pick it up as public. OK.

PEOPLE WHO PASSED: You hadn't documented anonymous inner classes, had you?
Andrew Monkhouse
author and jackaroo
Marshal Commander

Joined: Mar 28, 2003
Posts: 11404
    
  81

Hi Robert,

I did document everything, but I did not use javadoc for anonymous inner classes - I just used C or C++ comments depending on what sort of comment I wanted.

Regards, Andrew


The Sun Certified Java Developer Exam with J2SE 5: paper version from Amazon, PDF from Apress, Online reference: Books 24x7 Personal blog
Nathaniel Stoddard
Ranch Hand

Joined: May 29, 2003
Posts: 1258
I didn't have nested classes.


Nathaniel Stodard<br />SCJP, SCJD, SCWCD, SCBCD, SCDJWS, ICAD, ICSD, ICED
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Javadoc and nested classes?
 
Similar Threads
Javadoc and nested classes?
javadoc bug or missing an option for class extending AbstractTableModel
Javadoc for public interface
Disallowed to use private inner classes?
Listener classes + javadoc