sunone

Generates configuration files for EJB jars in iPlanet/SunONE

Implementing Class

xdoclet.modules.sun.sunone.ejb.SunONESubTask

Attributes

Attribute Description Required
version The SunONE/iPlanet version. Supported versions are 6.0, 6.5 and 7.0.

Valid values: 6.0, 6.5, 7.0
"No, default is '7.0'."
transactionManagerType Optional default transaction manager type for all components. Allowed values are 'local' and 'global'. "Only used for version = 6.5, and optional even then."
cmpResourceJndiName Specifies the absolute jndi-name of the database to be used for storing CMP beans in the EJB JAR file. "Only used for version = 7.0, and optional even then."
cmpResourcePrincipalName Specifies the default sign-on name to the resource manager. Onlyusedif cmpResourceJndiNameparameteris specified,andoptional eventhen.
cmpResourcePrincipalPassword Specifies the default password to the resource manager. Onlyusedif thecmpResourcePrincipalNameparameter isspecified.
cmpSchema Specifies the database schema filename (minus .dbschema extension), as captured using Sun's utilities. Onlyusedwith CMPentitybeans.
cmpTemplateFile Sets the name of the sun-cmp-mappings.xml template file. No.
cmpDestinationFile Sets the destination filename of the CMP mappings file. 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
ejb-env-entries-{0}.xml Same as for <deploymentdescriptor> subtask (only used for MDBs). ias-ejb-jar.xml
mdb-ejbrefs-{0}.xml Same as for <deploymentdescriptor> subtask, except root element name is mdb-ejb-ref rather than ejb-ref (only used for MDBs). ias-ejb-jar.xml
mdb-resourcerefs-{0}.xml Same as for <deploymentdescriptor> subtask, except root element name is mdb-resource-ref rather than resource-ref (only used for MDBs). ias-ejb-jar.xml
ejb-resource-env-refs-{0}.xml Same as for <deploymentdescriptor> subtask (only used for MDBs). ias-ejb-jar.xml
sunone-role-mappings.ent An Unparsed XML Entity file that contains the <role-mapping> elements. ias-ejb-jar.xml, sun-ejb-jar.xml
sunone-pm-descriptors.xml An XML Document containing the <pm-descriptors> element. sun-ejb-jar.xml
sunone-ior-security-config-{0}.xml An XML Document containing the <ior-security-config> element for a bean. sun-ejb-jar.xml

Nested Elements

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