开发者

Any way to auto generate ALL Javadoc comments in Eclipse?

开发者_运维百科

I know that you can press shift+alt+j to insert an appropriate comment template for the current code block, but is there any way to let eclipse just go crazy and do a whole project like this?


For a whole project, may be not, but you can at least:

  • go to the Package Explorer View
  • expand the class you want to generate comment on (open each method)
  • select all the opened elements in the class from that Package Explorer Tree
  • alt+shift+J and voilà: comments generated on the class, and every method

The only reason it is not practical for the all project is:

  • you need to open every class you want to generate comments on
  • once a first set of methods have been commented, you still need to repeat the process if you have written new methods.

That being said, another approach is described in the article "The Problem of Incomplete Javadocs" from March, 30th 2010, advocating for an extended Javadoc view.

The extended Javadoc View is essentially an aggregator of different information sources for a single code element like a class, method, field or parameter. It is designed as a replacement for the existing Eclipse Javadoc.

Any way to auto generate ALL Javadoc comments in Eclipse?

The interesting part comes with the other tabs in the view: Subclassing Directives and Subclassing Patterns.
These tabs contain mined information about how developers typically extended the selected code element.

  • Subclassing tab:

subclassing directives are generalizations of frequently made observations in example code like "Subclasses of Wizard always override its method addPages()" or "Reimplementors of Dialog.createContents() may call its super implementation".

Any way to auto generate ALL Javadoc comments in Eclipse?

Any way to auto generate ALL Javadoc comments in Eclipse?

  • Subclassing Patterns Tab

Subclassing patterns try to group observed extensions of a base class into typical extension patterns, i.e., they cluster subclasses by similarity to find patterns in data.

Any way to auto generate ALL Javadoc comments in Eclipse?


I was also looking for an auto javadoc tool for eclipse and found one called JAutodoc.

This tool generates comments pretty well and requires only minor changes manually in some places (if you require). In my opinion, this tool can save approximately 75% of the time spent in writing comments.

You may visit here for detailed instructions on downloading and integrating it with eclipse.


There's also this plugin, which I have yet to try, but looks promising: JAutoDoc


Adding a menu image because someone asked for it. @Maude This is on Eclipse IDE 2020-09 (4.17).

Note: Some users change their shortcut hotkeys to suit their workflow, so we should never dismiss someone and tell them outright to use shortcuts, or figure out why shortcuts don't work on their ends.

The context menu itself is contextualized, so it really depends on where you right click.

Any way to auto generate ALL Javadoc comments in Eclipse?

0

上一篇:

下一篇:

精彩评论

暂无评论...
验证码 换一张
取 消

最新问答

问答排行榜