File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
http://aspose.com/file-tools
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes javadoc bug or missing an option for class extending AbstractTableModel Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Soft Skills this week in the Jobs Discussion forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "javadoc bug or missing an option for class extending AbstractTableModel" Watch "javadoc bug or missing an option for class extending AbstractTableModel" New topic
Author

javadoc bug or missing an option for class extending AbstractTableModel

Carlos Morillo
Ranch Hand

Joined: Jun 06, 2009
Posts: 221

Hi Everybody,

I am reviewing my javadoc before submission of my assignment and I noticed
for my JTable model class HotelRoomTableModel that extends AbstractTableModel
for all the overwritten methods like getValueAt(), getColumnCount(), getRowCount()
that implement the TableModel interface where I am using javadoc comments of the form:



the HTML generated javadoc I see in my browser doesn't show anything
for these methods other than the name and the signature of the method.

Is that normal? Or is it a bug? Or perhaps did I miss anything?

I would hope that it would show something like:

"Specified by: methodName in interface InterfaceName"

or

"Overrides: methodMame in class ClassName".

Any ideas?

Thanks,

Carlos.


SCSA, OCA, SCJP 5.0, SCJD, CCDH, CCAH http://www.linkedin.com/in/carlosamorillo
Andy Jung
Ranch Hand

Joined: Feb 07, 2010
Posts: 150
Hi Carlos,

I have absolutely the same problem like you.
I couldn't find any reason or solution so far.

I also tried it to javadoc with NetBeans and MyEclipse, but all the same.

Kind Regards,
Andy

SCJP, SCJD
Carlos Morillo
Ranch Hand

Joined: Jun 06, 2009
Posts: 221

Hi Andy,

I am building my submission jar with Roel's ant build.xml on a SunBlade 2000 SPARC based system
running Solaris 10 with the latest Java 6 JDK from the command line using the
latest Apache Ant distribution.

I could be wrong but sounds like a bug to me.

Carlos.
Andy Jung
Ranch Hand

Joined: Feb 07, 2010
Posts: 150
Could be a bug in javadoclet version 1.6 ?
I override JTables public method changeSelection and I have the same behavior like you.



Could this be a situation to automatic fail ? I mean my assigment says that all public methods have to be java documented.
Roel De Nijs
Bartender

Joined: Jul 19, 2004
Posts: 5597
    
  15

I have checked my javadoc file for my TableModel and this is what is generated:

getColumnName

public String getColumnName(int column)

Specified by:
getColumnName in interface TableModel
Overrides:
getColumnName in class AbstractTableModel



I ran the script from within my Eclipse IDE, using jdk 1.6.0_13. This problem is also mentioned in this thread.

And as a final remark: I don't think this will lead to automatic failure, because you added javadoc to your public methods (in the code).

Kind regards,
Roel


SCJA, SCJP (1.4 | 5.0 | 6.0), SCJD
http://www.javaroe.be/
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: javadoc bug or missing an option for class extending AbstractTableModel