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.clas s

    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 inher ited 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.