XDoclet Overview News and Status Download/Installation Using XDoclet Best Practices FAQ License Ant Task Reference <ejbdoclet .. /> <webdoclet .. /> <hibernatedoclet .. /> <mockdoclet .. /> <jdodoclet .. /> <jmxdoclet .. /> <doclet .. /> Tag Reference apache (@soap @struts) bea (@weblogic) borland (@bes) caucho (@resin) ejb (@ejb @dao) exolab (@castor) hp (@hpas) hibernate (@hibernate) ibm (@websphere) java (@javabean) jboss (@jboss) jdo (@jdo) jmx (@jmx) macromedia (@jrun) mockobjects (@mock) mvcsoft (@mvcsoft) mx4j (@mx4j) objectweb (@jonas) oracle (@oc4j) orion (@orion) pramati (@pramati) sybase (@easerver) web (@web @jsp) webwork (@webwork) xdoclet (@xdoclet @doc) Feature Documentation Using Value Objects Advanced Maven Plug-in Merge Points Log4J Configuration IDE Integration Migration from EJBDoclet Ant 1.5 Troubleshooting Community Feedback Resources Tools Development Developer Guide Javadoc (API) Template Language (*.xdt) XJavaDoc Site Project Documentation Front Page Project Info Project Reports Development Process | ### XDoclet 1.2 Beta 1 Change Log #### Core XDoclet now requires Jakarta Ant v1.5 or higher. Refactoring work to make more modular. The bad news is there's a lot more jars for you to include in the classpath. The good news is you don't need all of them, depending on what tasks and subtasks you're using. There's an open enhancement request to build all modules into a single jar. We no longer use JavaDoc, but instead our own XJavaDoc module. The documentation has been reworked. A lot of it is now generated from the code, so should keep up to date better. We now use the Jakarta Commons Logging rather than Log4J directly. #### EJB Module Added <valueobject> subtask. This is a much more flexible version of dataobjects, allowing finer grained control and relation following. The dataobject subtask is now deprecated in favour of this. Documentation fix - DAOs work with session EJBs as well as entity EJBs. [500756] Self-referencing error with CMP EJB [511669] Enhancements to lookup util class [516890] "Component inheritence" problem? [517372] Wrong transact. method-intf for local bean [519011] Duplicate finder in inherited Home i/f [521571] Remote/Local Home finders ignore types [523907] @ejb-external-ref (docs & exception) [525797] @ejb.permission role-name="a,b" [528945] Business-Interface support accidentally removed [530900] misplaced message-selector [531310] Data Object hashcode() fails with byte[] [532498] Bad generation of findByPrimaryKey f [532832] Primary Key class bug [535221] ejbCreate for local interface only wrong [539614] method permissions for findByPrimaryKey [539770] Relations generated on all ValueObjects [545622] dao:call to handle create methods [550058] (patch) Using of PK in ValueObjects do not work Thanks to Ingo Brüll. [550404] Subclass's home iface extends super's Thanks to Paul Cantrell for fix. [566941] (FR) Beans' description in DD [570833] Inconsistent attribute for resource-ref [574883] env-entry-value should not be mandatory. [577891] soft-locking version field long or int? [578031] (patch) Dataobj->vobj transition patch [578820] ejbRemove() no RemoveException [579172] (patch) ejb:external-ref dies if view-type=local [579717] (FR) [patch] assembly-descriptor merge point Thanks to Toby Cabot. [579790] (patch) ejb:finder ignores view-type [580766] valueobject generates incorrect toString. Thanks to John Barbee for fix. [580678] (patch) value objects of type Set Thanks to John Barbee. [587587] (patch) Rev. fix for 1-valued ejb:finder returns ejb.env-entry now takes an optional description parameter <trans-attribute> was empty for class tag ejb.finder Added support for caching homes in the util class. Added a GUID generator in the util object (disabled by default). [597698] Finder bug! [603610] (patch) slsb ejbCreate() not called Thanks to Chris Harris. [604391] entity-body.xdt - ejbRemove() body #### JMX Module [574564] (patch) JMX operations/constructor parameters Thanks to Simone Bordet. #### Web Module [511612] Catalina fails to deploy web.xml [522195] JSP Tablib Merge File for tags [527254] Duplicate Entries for resource-ref [531980] no lf/cr in generated taglib.tld [577343] Wrong <run-as> element [579459] @web:listener doesn't. [581857] typo in web_xml.j [585726] Webdoc shouldn't default session-timeout. Thanks to William Ferguson for fix. Add missing ejb.servlet load-on-startup parameter [602028] ejb-ref/ejb-local-ref merge points #### Apache Module [529752] Missing Field in Form [529937] (patch) Add setData to struts forms [533754] Apache Soap Support [546139] @struts:action-forward and redirect Added Struts 1.1 support. [561172] (patch) Struts 1.1 Global Exceptions. Thanks to Vladimir Dias. [567058] unmeant get/set methods [574466] New Merge Points for struts-config Thanks to Volker Krebs. [577635] (patch) <strutscfg> patch for <message-resources> Thanks to Brian Topping. Fixed bug causing duplicate parameter attributes [581217] Ignored @struts:form-field [583106] (patch) Patch for <action-mappings/> Thanks to Thanks to Brian Topping. [599350] (patch) Struts Validator validation.xml gen. [604590] (patch) Validator patches [605231] Struts 1.1 DTD out of date #### Bluestone Module Fixed missing '/' in closing template tag. Subtask renamed to <hpas>. #### Castor Module [504332] Problem with m:n mapping and Castor [536768] mapping-body.j reference typo [537505] (patch) Castor mapping patches. Thanks to Bart Guijt. [538600] order of classes in castor mapping file [538602] inherited fields added to mapping file [538646] cannot specify @castor:class xml="..." [542172] Castor mapping-body.j collection types [542175] Castor mapping-body.j handler [542498] Castor mapping-body.j map-to. Thanks to Theo Harper for fix. #### JBoss Module [513489] jaws.xml generated with jboss3/cmp2 [536336] (patch) Issues with JBoss CMP descriptors Thanks to Ludovic Claude. [539387] JBoss CMP fields issues [548641] (patch) jboss-service-template.j Thanks to Theo Harper. [559114] (FR) Support <resource-env-ref> in jboss.xml [563717] missing empty key-fields element [563718] problem with ant props in jboss cmr's [568535] <jboss> task crashes without <entitycmp> [569371] jboss fk-constraints have been reversed [570832] Misalignment in @jboss.resource-ref [579235] JBoss resource-manager fails [579236] (patch) JBoss resource-manager fails (bug 579235 added read-ahead to jboss.query and jboss.declared-sql removed result-type-mapping attribute from @jboss.declared-sql added from attribute to @jboss.declared-sql [580180] m->1 uni invalid in jbosscmp-jdbc.xml [580634] (patch) JBoss version vs. ejb/CMP spec problems [582345] DVC column-name issue [583799] (FR) JBoss m:n relationship table naming [584257] @ejb.persistent-field still needed [599000] Default mapping element missing [591133] xdoclet ignoring deprecated jboss:column [591141] Document the @jboss.relation-table tag [600180] (patch) jboss clustering support Thanks to Oskari Kettunen. [601059] (patch) Explicit home interface parameter names Thanks to Gerald Turner. [603946] merge and tags mutully exclusive for DVC Thanks to Oskari Kettunen for fix. [604419] jbosscmp-jdbc_xml.xdt bug [604529] jboss-web.xml: dupliacated <ejb-ref> [605055] (patch) @jboss:security-proxy support [606245] (patch) order of xtags elements for jboss Thanks to Kevin ONeill. [607780] jaws.xml is broken if no typemapping [607791] Wrong DTD for jboss2.4 in jboss-web-xml [608315] Local interfaces not possible jboss 2.4 added support for JMX persistence-manager element #### MVCSoft Module [585458] (patch) Patch to MVCSoft-new tags Thanks to Daniel OConnor. [601485] (patch) bug fixes for MVCSoft vendor module. Thanks to Daniel O'Connor. #### OpenJMX Module Subtask renamed to MX4J, due to OpenJMX project's name changing. #### Orion Module orion.bean location was replaced by ejb.bean jndi-name Added version 1.5.4 support. [595280] Incorrect orion-ejb-jar.xml generated #### Weblogic Module [513641] transaction-isolation element [516909] Empty datasource generated [524003] Weblogic cmp dd generated with MVCSoft [569023] (patch) Wrapped weblogic-ql in CDATA [579939] weblogic.pool forces both atts to be set #### New tasks and sub-tasks [565609] (patch) Caucho (Resin) Module. Thanks to Yoritaka Sakakura. [532839] (FR)/[576134] (patch) JavaBean BeanInfo module Thanks to Laurent Etiemble. [541511] (FR) Add Sybase EAServer support [575905] (patch) JDO module Thanks to Ludovic Claude. [581243] (FR) Support for Struts validation framework [594029] (patch) JOnAS application server support. Thanks to Mathieu Peltier and Richard Chuo. #### Misc samples converted to dotted tag format. assorted fixes and enhancements to relation handling in ejbdoclet and vendor-specific subtasks. #### Bug Fixes [512180] (FR) make ejb.select a method level @tag [516425] support field/constructor tags in info [520066] empty merge file stop xml generation [522357] Make temp file name depend on username Thanks to Daniel Bratell. [523008] (patch) @ejb.finder result-type-mapping Thanks to Zak Jacobson. [523372] Ant property specified values [524219] load-on-startup missing from docs [529243] ejb examples use illegal ejb-names [529784] Merge Files don't work with 1.1.2. [530110] Template errors throw exception not msg [530297] Generated data.toString() needs space [536333] (patch) <If> tags not working Thanks to Ludovic Claude. [536440] (patch) DefaultXTag.parse() optimizations [536453] (patch) xdoclet buildsystem CNFE fixed Thanks to Bart Guijt. [537777] (patch) Multiple tag and parameters in templates [541614] error building todo listing [547633] ejb.home generate="none" fails [564382] user context being clobbered [570176] (patch) Turning on debugging requires recompile [571776] CMP xdt incorrectly refs DataObject [573624] (patch) protect description with <![CDATA[]]>. Thanks to Neale Swinnerton. [576125] Generation of DAO Calls for Set Methods [576483] valueobject template - pk problem and fix. [577374] @ejb-transaction local/remote handling [577679] array becomes 2 dimensional in SFSB i/f [579252] (patch) missing @ on doc tags in generated code Thanks to Michael Newcomb. [582804] Session problem with web.xml generated [584963] (patch) Fix for ClassNotFoundException. Thanks to Marc Breslow. [586168] latest release jarkartacommon not compat [586890] data objects and getter methods [587587] (patch) Rev. fix for 1-valued ejb.finder returns [587872] TemplateTask cannot override destdir [588075] Unhandled exception in XJavaDoc [589232] XDOclet not getting tags from a parent [597705] ant properties ignored by ejbdoclet task [594780] (FR) Merge files backwards compatibility [600486] (patch) BeanInfo: Java expression for attribute. Thanks to Laurent Etiemble. [608443] (patch) jonas tags for the xdoclet samples Thanks to Mathieu Peltier.