strutsconfigxml

Generates struts-config.xml deployment descriptor.

Implementing Class

xdoclet.modules.apache.struts.StrutsConfigXmlSubTask

Attributes

Attribute Description Required
version Sets the struts version to use. Legal values are "1.0", "1.1" and "1.2".

Valid values: 1.0, 1.1, 1.2
"No. Default is '1.0'".
controller Sets fully qualified class to use when instantiating ActionMapping objects. 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 The XML Schema to which the generated document should conform. No.
validateXML If this is set to true, the generated XML will be validated against its DTD or XML Schema. No,defaultis false.
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'"
prefixWithPackageStructure Indicates whether or not to prefix with package structure. "No, default is 'true'"
destinationFile The destination file name. If a {0} is found it's assumed that a per class output generation is needed, so {0} is substituted with class name; otherwise a single file is generated with the specified name. No,defaultis determinedbythis task.
templateFile Sets the name of the template file to use for generation No,defaultis determinedbythis task.
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(s) will be written. No.
mergeDir Specifies the location of the merge directory. This is where XDoclet will look for merge files. No.

Merge Files

File name Description Relates to
struts-data-sources.xml An XML document containing the optional data-sources element. struts-config.xml
struts-forms.xml An XML unparsed entity containing form-bean elements, for additional non-XDoclet forms. struts-config.xml
global-exceptions.xml An XML document containing the optional global-exceptions element. struts-config.xml
global-forwards.xml An XML document containing the optional global-forwards element. struts-config.xml
struts-actions.xml An XML unparsed entity containing action elements, for additional non-XDoclet actions. struts-config.xml
actions.xml Deprecated (renamed to struts-actions.xml). Still used, but only for backwards compatibility. struts-config.xml
struts-controller.xml An XML document containing the optional controller element. struts-config.xml
struts-message-resources.xml An XML unparsed entity containing any message-resources elements. struts-config.xml
struts-plugins.xml An XML unparsed entity containing any plug-in elements. struts-config.xml

Nested Elements

Element Description
configParam Specifies a configuration parameter for the subtask.
ofType
packageSubstitution Substitutes the package of the generated files.