XDoclet is a tool for generating all of the extra things that J2EE requires for a component from JavaDoc tags in the source of the 'primary' part of the component. For example:
EJB's: You put tags in the bean implementation. It makes:
- Any Local, Remote, and Home interfaces that apply.
- An optional "data object" that packages the whole bean's data in a single object, for bulk reads and writes across an RPC interface. The object even supports all the canonical Object calls properly.
- Entries in a generated deployment descriptor with all of the appropriate information, including CMP info (and any extra XML required by the EJB container if you put in tags for it), relations, EJBQL finders, and probably more that I haven't thought of.
JSP, JSP tags, Servlets: It handles:
- TLD generation for the project, will all attributes and other information complete.
- EJB refs.
- Servlet configuration.
- Filter configuration.
- Probably more I don't know about.
Basically, it allows you to embed all of the metadata you normally have to put in a seperate XML file right at your fingertips in your Java source.
-- WalterMundt - 14 Jun 2002
Some XDoclet tags that I've set to be ignored in IDE Options->Editor->Error Highlighting to avoid them showing as errors.
ejb:bean, ejb:ejb-ref, jboss:destination-jndi-name, weblogic:message-driven, weblogic:enable-call-by-reference, weblogic:ejb-reference-description, ejb:create-method, xdoclet-generated, ejb:finder, weblogic:table-name, weblogic:data-source-name, jboss:table-name, ejb:persistent-field, ejb:pk-field, ejb:interface-method, weblogic:dbms-column, jboss:column-name, weblogic:resource-description, ejb:transaction, ejb:resource-ref
-- GwynEvans - 18 Jun 2002
New XDoclet plugin available.
This is currently only available in the XDoclet CVS, but as soon as it stabilizes a bit I will attach builds here. To get it, check out the xdoclet-all module from sourceforge and follow the instructions in xdoclet-all/xdocletgui/idea.
It currently has the following features:
- Provides a view similar to IDEA's native structure view of the class, but exposes access to the XDoclet tags
- Allows for adding/editing/remove of tags.
- Reads/Writes from/to IDEAs filesystem, no saving to disk is required.
- Doesn't lose your place in the file when editing a tag (questionable as to whether this is feature or a "feature" - some may prefer that it behaved the same as the structure pane in this way).
- Popups triggered on either mouse button (very useful on my laptop).
- Configuration - at a project level, to specify which tag families are visible and to change the xdoclet.class.path property (ie, add and remove modules).
-- DmitriColebatch - 13 Oct 2002
|
|
