User: ko5tik
Date: 02/04/18 07:31:48
Modified: src/java xdoclet-tags.dtd xdoclet-tags.xml
Log:
modified conditions. added new types of them
writen xml for ejb tags up to persistent-field
Revision Changes Path
1.10 +2 -2 xdocletgui/src/java/xdoclet-tags.dtd
Index: xdoclet-tags.dtd
===================================================================
RCS file: /cvsroot/xdoclet/xdocletgui/src/java/xdoclet-tags.dtd,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -w -r1.9 -r1.10
--- xdoclet-tags.dtd 18 Apr 2002 11:42:39 -0000 1.9
+++ xdoclet-tags.dtd 18 Apr 2002 14:31:48 -0000 1.10
@@ -17,7 +17,7 @@
xtags.ConditionFactory
-->
<!ATTLIST condition
- type (and | class | method | or | not | tag-param | type | name) #REQUIRED
+ type (and | class | method | or | not | tag-param | type | name | abstract |
public | final | static | starts-with) #REQUIRED
>
@@ -94,7 +94,7 @@
<!--
The definition of a tag
-->
-<!ELEMENT tag (name, usage-description, unique?, condition-description? ,
condition?, parameter*)>
+<!ELEMENT tag (name, usage-description, unique, condition-description? ,
condition?, parameter*)>
<!--
1.13 +600 -3 xdocletgui/src/java/xdoclet-tags.xml
Index: xdoclet-tags.xml
===================================================================
RCS file: /cvsroot/xdoclet/xdocletgui/src/java/xdoclet-tags.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -w -r1.12 -r1.13
--- xdoclet-tags.xml 18 Apr 2002 11:42:39 -0000 1.12
+++ xdoclet-tags.xml 18 Apr 2002 14:31:48 -0000 1.13
@@ -97,6 +97,8 @@
you obviously do not want the abstract EJB be wrongly specified in
deployment
desciptors as a concrete EJB. Default is "true".
</usage-description>
+ <mandatory>false</mandatory>
+ <default>true</default>
</parameter>
<parameter type="text">
<name>jndi-name</name>
@@ -181,6 +183,7 @@
</condition>
<option-sets>
<option-set>
+ <default>remote</default>
<options>
<option>local</option>
<option>remote</option>
@@ -206,6 +209,7 @@
</condition>
<option-sets>
<option-set>
+ <default>CMP</default>
<options>
<option>CMP</option>
<option>BMP</option>
@@ -215,6 +219,7 @@
</condition>
</option-set>
<option-set>
+ <default>Stateless</default>
<options>
<option>Stateless</option>
<option>Stateful</option>
@@ -239,9 +244,13 @@
<condition type="type">
<condition-parameter>javax.ejb.SessionBean</condition-parameter>
</condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.MessageDrivenBean</condition-parameter>
+ </condition>
</condition>
<option-sets>
<option-set>
+ <default>Container</default>
<options>
<option>Container</option>
<option>Bean</option>
@@ -255,6 +264,7 @@
Defines the entity bean's reentrancy.
</usage-description>
<mandatory>false</mandatory>
+ <default>true</default>
<condition-description>Entity beans</condition-description>
<condition type="type">
<condition-parameter>javax.ejb.EntityBean</condition-parameter>
@@ -273,6 +283,7 @@
</condition>
<option-sets>
<option-set>
+ <default>1.x</default>
<options>
<option>1.x</option>
<option>2.x</option>
@@ -316,6 +327,7 @@
capabilities built-in, so you don't need to worry about it locking
issues.
</usage-description>
<mandatory>false</mandatory>
+ <default>false</default>
<condition-description>Entity beans</condition-description>
<condition type="type">
<condition-parameter>javax.ejb.EntityBean</condition-parameter>
@@ -344,6 +356,7 @@
</condition>
<option-sets>
<option-set>
+ <default>Auto-acknowledge</default>
<options>
<option>Auto-acknowledge</option>
<option>Dups-ok-acknowledge</option>
@@ -363,6 +376,7 @@
</condition>
<option-sets>
<option-set>
+ <default>javax.jms.Queue</default>
<options>
<option>javax.jms.Queue</option>
<option>javax.jms.Topic</option>
@@ -383,6 +397,7 @@
</condition>
<option-sets>
<option-set>
+ <default>Durable</default>
<options>
<option>Durable</option>
<option>NonDurable</option>
@@ -435,8 +450,9 @@
interface. It is applicable to Session and Entity beans. In Stateless
Session
beans the ejbCreate will be created if it is not in the code.
</usage-description>
+ <unique>false</unique>
<condition-description>
- Applicable to session and entity beans method has to be called ejbCreate
+ Applicable to session and entity beans. Method has to be called ejbCreate
</condition-description>
<condition type="and">
<condition type="method">
@@ -461,6 +477,7 @@
<mandatory>false</mandatory>
<option-sets>
<option-set>
+ <default>remote</default>
<options>
<option>local</option>
<option>remote</option>
@@ -508,10 +525,12 @@
<parameter type="text">
<name>package</name>
<usage-description>
+ <![CDATA[
Define the package the DAO interface is in
- (generated or not). Use <packageSubstitution/> to
+ (generated or not). Use <packageSubstitution/> to
configure which package the interface should end
up in.
+ ]]>
</usage-description>
<mandatory>false</mandatory>
</parameter>
@@ -522,6 +541,7 @@
Defaults to true.
</usage-description>
<mandatory>false</mandatory>
+ <default>true</default>
</parameter>
<parameter type="text">
<name>impl-class</name>
@@ -554,6 +574,7 @@
Defines configuration attributes used for data object generation.
Applicable only for
Entity beans.
</usage-description>
+ <unique>true</unique>
<condition-description>
Applicable only for Entity beans.
</condition-description>
@@ -581,6 +602,7 @@
of reference bean's home interface [home], name of
reference bean's remote interface [remote]. Applicable to all types of
beans.
</usage-description>
+ <unique>false</unique>
<condition-description> Applicable to all types of
beans</condition-description>
<condition type="and">
<condition type="class">
@@ -627,6 +649,7 @@
<mandatory>true</mandatory>
<option-sets>
<option-set>
+ <default>Entity</default>
<options>
<option>Entity</option>
<option>Session</option>
@@ -659,6 +682,7 @@
to the bean with EJB-name [ejb-name]. ref-name is optional and if not
specified then the reference name is [ejb-name] prefixed by a ejb/
</usage-description>
+ <unique>false</unique>
<condition type="and">
<condition type="class">
</condition>
@@ -685,6 +709,7 @@
<mandatory>true</mandatory>
<option-sets>
<option-set>
+ <default>remote</default>
<options>
<option>local</option>
<option>remote</option>
@@ -714,6 +739,7 @@
If used on class level applies to all interface methods unless overriden
</usage-description>
+ <unique>true</unique>
<condition-description>Entity & Session beans</condition-description>
<condition type="or">
<condition type="type">
@@ -729,6 +755,7 @@
<mandatory>true</mandatory>
<option-sets>
<option-set>
+ <default>Supports</default>
<options>
<option>NotSupported</option>
<option>Supports</option>
@@ -744,6 +771,7 @@
<tag>
<name>ejb:env-entry</name>
<usage-description>Defines an environment entry for an EJB.
</usage-description>
+ <unique>false</unique>
<condition-description>Applicable to all EJB types.</condition-description>
<condition type="and">
<condition type="class">
@@ -798,10 +826,579 @@
</parameter>
</tag>
<tag>
+ <name>ejb:finder</name>
+ <usage-description>
+ Defines a finder method for the home interface. An entity bean may have
zero or more
+ ejb:finder tags.
+ </usage-description>
+ <unique>false</unique>
+ <condition-description>Applicable only to Entity beans</condition-description>
+ <condition type="and">
+ <condition type="class">
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>view-type</name>
+ <usage-description>
+ To restrict the home interface in wich the finder will be defined.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>both</default>
+ <options>
+ <option>local</option>
+ <option>remote</option>
+ <option>both</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ <parameter type="text">
+ <name>signature</name>
+ <usage-description>
+ Defines the signature of the
+ method. E.g.. "java.util.Collection
+ findAll()". The return type in the
+ signature must be fully qualified.
+ </usage-description>
+ <mandatory>true</mandatory>
+ </parameter>
+ <parameter type="bool">
+ <name>unchecked</name>
+ <usage-description>
+ Flags the finder as having
+ unchecked permission. EJB2.0 only.
+ If present, role-name must be
+ omitted
+ </usage-description>
+ <mandatory>false</mandatory>
+ <default>true</default>
+ </parameter>
+ <parameter type="text">
+ <name>role-name</name>
+ <usage-description>
+ A comma-separated list of roles that can invoke this finder method.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>query</name>
+ <usage-description>
+ EJB-QL query for the finder. Applicable to EJB2.0 CMP only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>result-type-mapping</name>
+ <usage-description>
+ Result type mapping for the finder
+ method. Applicable to EJB2.0 CMP
+ only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>none</default>
+ <options>
+ <option>none</option>
+ <option>Local</option>
+ <option>Remote</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ <parameter type="text">
+ <name>transaction-type</name>
+ <usage-description>
+ Indicates the transaction type attribute sets to the method.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>method-intf</name>
+ <usage-description>
+ Indicates the interface (Home or
+ LocalHome) for which the finder
+ permissions should be set. If the
+ permissions should apply to both
+ Home or LocalHome interfaces,
+ this parameter should not be
+ specified.</usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>Home</default>
+ <options>
+ <option>Home</option>
+ <option>LocalHome</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ </tag>
+ <tag>
+ <name>home</name>
+ <usage-description>
+ The @ejb:home tag provides information about an Entity or Session
+ Bean's home interface.All parameters are applicable to both Entity and
Session beans.
+ </usage-description>
+ <unique>true</unique>
+ <condition-description>Applicable to Entity and Session
beans</condition-description>
+ <condition type="and">
+ <condition type="class">
+ <condition type="or">
+ <condition type="type">
+ <condition-parameter>javax.ejb.SessionBean</condition-parameter>
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ </condition>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>extends</name>
+ <usage-description>
+ Declare which interface the generated
+ home interface should extend. Default is
+ "javax.ejb.EJBHome".
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-extends</name>
+ <usage-description>
+ Declare which interface the generated
+ local home interface should extend.
+ Default is "javax.ejb.EJBLocalHome".
+ EJB2.0 only
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="bool">
+ <name>generate</name>
+ <usage-description>
+ Which home interfaces should be
+ generated. Defaults to both (only
+ generated if relevant)
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>local,remote</default>
+ <options>
+ <option>none</option>
+ <option>local</option>
+ <option>remote</option>
+ <option>local,remote</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ <parameter type="text">
+ <name>remote-class</name>
+ <usage-description>
+ The fully qualified name of the remote
+ home interface.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-class</name>
+ <usage-description>
+ The fully qualified name of the local
+ home interface. EJB2.0 only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>remote-pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of the remote home
+ interface - only used if remote-class is
+ not present.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of the local home
+ interface - only used if local-class is
+ not present. EJB2.0 only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of either local or
+ remote home interfaces. Used where
+ -class and -pattern tags are absent for the
+ bean.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>remote-package</name>
+ <usage-description>
+ <![CDATA[
+ The package the remote home interface
+ should be in - only used where
+ remote-class is not present. Use
+ <packageSubstitution/> to configure
+ which package the interface should end
+ up in
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-package</name>
+ <usage-description>
+ <![CDATA[
+ The package the local home interface
+ should be in - only used where
+ local-class is not present. Use
+ <packageSubstitution/> to configure
+ which package the interface should end
+ up in
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>package</name>
+ <usage-description>
+ <![CDATA[
+ The package the home interfaces to be
+ placed in - only used where
+ -class or -package is not present. Use
+ <packageSubstitution/> to configure
+ which package the interface should end
+ up in
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ </tag>
+ <tag>
+ <name>ejb:home-method</name>
+ <usage-description>
+ Define this method as a home method (e.g. its name is "ejbHomefoo", and
+ the corresponding home method should be defined in the home interface).
+ </usage-description>
+ <unique>true</unique>
+ <condition-description>
+ Applicable to session and entity beans - valid for EJB2.0 only
+ </condition-description>
+ <condition type="and">
+ <condition type="method">
+ </condition>
+ <condition type="or">
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.SessionBean</condition-parameter>
+ </condition>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>view-type</name>
+ <usage-description>
+ Optionally specify which view-type the
+ method will be exposed in.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>local</default>
+ <options>
+ <option>local</option>
+ <option>remote</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ </tag>
+ <tag>
+ <name>ejb:interface</name>
+ <usage-description>
+ The @ejb:interface tag provides information about an Entity or
+ Session Bean's component interfaces (remote and/or local). It is not
+ applicable to Message-driven beans. All parameters are applicable to both
+ Entity and Session beans.</usage-description>
+ <unique>true</unique>
+ <condition-description>
+ Applicable to both
+ Entity and Session beans.
+ </condition-description>
+ <condition type="and">
+ <condition type="class">
+ </condition>
+ <condition type="or">
+ <condition type="type">
+ <condition-parameter>javax.ejb.SessionBean</condition-parameter>
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>extends</name>
+ <usage-description>
+ Declare which interface the generated
+ remote interface should extend. Default is
+ "javax.ejb.EJBObject".
+ </usage-description>
+ <mandatory>false</mandatory>
+ <default>javax.ejb.EJBObject</default>
+ </parameter>
+ <parameter type="text">
+ <name>local-extends</name>
+ <usage-description>
+ Declare which interface the generated local
+ interface should extend. Default is
+ "javax.ejb.EJBLocalObject". EJB2.0 only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <default>javax.ejb.EJBLocalObject</default>
+ </parameter>
+ <parameter type="text">
+ <name>generate</name>
+ <usage-description>
+ Which interfaces should be generated.
+ Defaults to both (only generated if
+ relevant), can be "none", "remote", "local",
+ or "local, remote".
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>local,remote</default>
+ <options>
+ <option>none</option>
+ <option>remote</option>
+ <option>local</option>
+ <option>local,remote</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ <parameter type="text">
+ <name>remote-class</name>
+ <usage-description>
+ The fully qualified name of the remote
+ interface.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-class</name>
+ <usage-description>
+ The fully qualified name of the local
+ interface. EJB2.0 only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>remote-pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of the remote interface -
+ only used if remote-class is not present.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of the local interface -
+ only used if local-class is not present.
+ EJB2.0 only.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>pattern</name>
+ <usage-description>
+ The pattern to be used in determining the
+ unqualified name of either local or remote
+ interfaces. Used where -class and -pattern
+ tags are absent for the bean.
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>remote-package</name>
+ <usage-description>
+ <![CDATA[
+ The package the remote interface should be
+ in - only used where remote-class is not
+ present. Use <packageSubstitution/> to
+ configure which package the interface
+ should end up in.
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>local-package</name>
+ <usage-description>
+ <![CDATA[
+ The package the local interface should be in
+ - only used where local-class is not
+ present. EJB2.0 only. Use
+ <packageSubstitution/> to configure which
+ package the interface should end up in.
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ <parameter type="text">
+ <name>package</name>
+ <usage-description>
+ <![CDATA[
+ The package for the interfaces to be placed
+ in. Only used where -class and -package
+ are not present. Use
+ <packageSubstitution/> to configure which
+ package the interface should end up in.
+ ]]>
+ </usage-description>
+ <mandatory>false</mandatory>
+ </parameter>
+ </tag>
+ <tag>
+ <name>ejb:interface-method</name>
+ <usage-description>
+ Declare in which interface (local/remote) this method must appear. If the
+ view-type parameter is absent then the method will be added to whatever
+ component interfaces are defined in @ejb:bean.
+ </usage-description>
+ <unique>true</unique>
+ <condition type="and">
+ <condition type="method">
+ </condition>
+ <condition type="or">
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.SessionBean</condition-parameter>
+ </condition>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>view-type</name>
+ <usage-description>
+ Optionally specify which view-type the
+ method will be exposed in. The value
+ "local" or "both" is only applicable to
+ EJB2.0 beans.
+ </usage-description>
+ <mandatory>false</mandatory>
+ <option-sets>
+ <option-set>
+ <default>remote</default>
+ <options>
+ <option>local</option>
+ <option>remote</option>
+ <option>both</option>
+ </options>
+ </option-set>
+ </option-sets>
+ </parameter>
+ </tag>
+ <tag>
+ <name>ejb:permission</name>
+ <usage-description>
+ Defines the transactional behavior for this method. Applicable to methods
+ with @ejb:create-method and @ejb:interface-method tags. When used on
class level applies
+ to all interface methods cumulatively.
+ </usage-description>
+ <unique>true</unique>
+ <condition-description>Session and Entity beans</condition-description>
+ <condition type="or">
+ <condition type="type">
+ <condition-parameter>javax.ejb.SessionBean</condition-parameter>
+ </condition>
+ <condition type="type">
+ <condition-parameter>javax.ejb.EntityBean</condition-parameter>
+ </condition>
+ </condition>
+ <parameter type="text">
+ <name>role-name</name>
+ <usage-description>
+ Comma-separated list of roles allowed to call this
+ method
+ </usage-description>
+ <mandatory>true</mandatory>
+ </parameter>
+ </tag>
+ <tag>
+ <name>ejb:persistent-field</name>
+ <usage-description>
+Use this for methods with the following patterns:
+
+ public abstract Foo getX();
+ public abstract boolean isX();
+ public abstract void setX(Foo newVal);
+
+This will create the CMP field "X" in the generated CMP layer of type
+"Foo", and concrete implementations of the getX/setX methods. For BMP,
+it will generate getX/setX methods that keep track of a dirty flag (so that
+ejbStore is only called if necessary). If the type is boolean it is ok to have
+the get method prefixed "is" instead of "get". If you don't define the setter
+method, no setter method is generated for the concrete BMP/CMP class
+(concrete CMP class is generated only if EJB 1.1 or EJB 2.0 but using CMP
+1.x). This is useful for cases where for example nothing is set
+programmatically but via external sources such as a stored procedure.
+Applicable for entity beans.
+ </usage-description>
+ <unique>true</unique>
+ <condition-description>
+ Methods which follow patterns:
+ public abstract Foo getX();
+ public abstract boolean isX();
+ public abstract void setX(Foo newVal);
+ </condition-description>
+ <condition type="and">
+ <condition type="method">
+ </condition>
+ <condition type="public">
+ </condition>
+ <condition type="abstract">
+ </condition>
+ <condition type="or">
+ <condition type="starts-with">
+ <condition-parameter>get</condition-parameter>
+ </condition>
+ <condition type="starts-with">
+ <condition-parameter>set</condition-parameter>
+ </condition>
+ <condition type="starts-with">
+ <condition-parameter>is</condition-parameter>
+ </condition>
+ </condition>
+ </condition>
+ </tag>
+ <tag>
<name>ejb:relation</name>
<usage-description>
Defines a relationship between Entity beans. Applicable only to EJB2.0
CMP2.x beans.
</usage-description>
+ <unique>true</unique>
<condition-description>EJB2.0 CMP2.x beans</condition-description>
<condition type="and">
<condition type="method">
_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
