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 | ### webspherewebxml This class is responsible for generating the WebSphere specific deployment descriptors. It generates ibm-web-bnd.xmi and ibm-web-ext.xmi . The id attributes of various elements in the deployment descriptors and the web.xml file must be applied as a seperate step with the task <WebSphereWebXmlIds/> after the deployement descriptors have been generated. ibm-web-bnd.xmi is responsible for: Binding EJB references in `web.xml` to a JNDI name in the local namespace Binding resource references in `web.xml` to a JNDI name in the local namespace ibm-web-ext.xmi contains IBM specific extensions to the web.xml file and is responsible for specifying the following: A Reload Interval . Every 'reload interval' seconds, the web application's files are checked and reloaded if they have been modified A flag specifying whether Reloading is enabled The URI of an error page Enabling or disabling File Serving . If enabled, the application is allowed to serve static file types such as HTML and GIF. File serving can be disabled if, for example, the application contains only dynamic components. The default value is true. Enabling or disabling Directory Browsing . If enabled, the application may browse disk directories. Directory browsing can be disabled if, for example, you want to protect data. The default value is true. Enabling or disabling the serving of servlets by their classname. The default value is true Association of responses with a given MIME type to a given target (servlet?); the idea being to either transform or filter a response. Page List configuration. Page lists allow servlets, which have been configured to utilise page list support, to refer to resources by names which map onto URIs. JSP Attribute configuration. To quote the IBM documentation " JSP attributes are used by the servlet that implements JSP processing behavior. ". No doubt IBM have lots of undocumented parameters to the JSP processing engine that can passed using this feature. File Serving Attribute configuration. To quote the IBM documentation " File-serving attributes are used by the servlet that implements file-serving behavior. ". Another means to pass undocumented parameters, this time to the file serving servlet. Invoker Attribute configuration. To quote the IBM documentation " Invoker attributes are used by the servlet that implements the invocation behavior. ". (I wonder if anyone at IBM knows what can be configured here) Servlet Cache configuration. An Additional ClassPath that will be used to reference resources outside of those specified in the archive. The following help is taken from the IBM documentation: Specify the values relative to the root of the EAR file and separate the values with spaces. Absolute values that reference files or directories on the hard drive are ignored. To specify classes that are not in JAR files but are in the root of the EAR file, use a period and forward slash (./). Consider the following example directory structure in which the file myapp.ear contains a Web module named mywebapp.war. Additional classes reside in class1.jar and class2.zip. A class named xyz.class is not packaged in a JAR file but is in the root of the EAR file. myapp.ear/mywebapp.war myapp.ear/class1.jar myapp.ear/class2.zip myapp.ear/xyz.class Specify `class1.jar class2.zip ./` as the value of the Additional classpath property. (Name only the directory for .class files.) #### Attributes
Attribute | Description | Required
--- | --- | ---
virtualHostName | Sets the virtual host name configuration parameter. | No.
reloadInterval |  | No.
reloadingEnabled | We need an implementation of this method else the framework does not see 'reloadingEnabled' as a java bean property (ie. read-only properties don't seem to work). | No.
defaultErrorPage |  | No.
fileServingEnabled |  | No.
directoryBrowsingEnabled |  | No.
serveServletsByClassnameEnabled |  | No.
additionalClassPath |  | No.
useIds | If this attribute is set to true, XDoclet will generate id attributes in the XML document. Note that this is only available in some subtasks. | No. Default is "false"
xmlencoding | The encoding of the produced xml file. If your XML file uses international characters, you might want to set this to "ISO-8859-1". | No, default is "UTF-8"
schema | Sets the Schema attribute of the XmlSubTask object. | No.
validateXML | If this is set to true, the generated XML will be validated against its DTD or XML Schema. | No.
acceptInterfaces | Indicates whether or not to generate for interfaces. | No, default is "true"
acceptAbstractClasses | Indicates whether or not to generate for abstract classes. | No, default is "true"
packageSubstitutions | Sets the PackageSubstitutions attribute of the TemplateSubTask object | No.
packageSubstitutionInheritanceSupported | Indicates whether or not package substitution should be inherited | No, default is "true"
subTaskClassName | Sets a different name for the subtask which will be seen in the log messages. | No.
prefixWithPackageStructure | Indicates whether or not to prefix with package structure. | No, default is "true"
templateFile | Sets the name of the template file to use for generation | Yes if its a nested element.
havingClassTag | Sets the HavingClassTag attribute of the TemplateSubTask object | No.
ofType |  | No.
subTaskName | Sets an optional name for the subtask that will be seen in XDoclet's debug messages. | No.
destDir | Sets the directory where the generated file will be written. | No.
mergeDir | Specifies the location of the merge directory. This is where XDoclet will look for merge files. | No.
#### Nested Elements
Element | Description
--- | ---
configParam | Describe the method
ofType |
packageSubstitution | Substitutes the package of the generated files.