ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-ant/docs/manual/OptionalTasks ejb.html
Date Sun, 30 Sep 2001 12:31:42 GMT
conor       01/09/30 05:31:42

  Modified:    .        Tag: ANT_14_BRANCH build.xml
               docs/manual/OptionalTasks Tag: ANT_14_BRANCH ejb.html
  Descript ejbjar naming attribiute
  Revision  Changes    Path
  No                   revision
  No                   revision +1 -1      jakarta-ant/build.xml
  Index: build.xml
  RCS file: /home/cvs/jakarta-ant/build.xml,v
  retrieving revision
  retrieving revision
  diff -u -w -u -r1.175.2.10 -r1.175.2.11
  --- build.xml	2001/08/30 12:39:39
  +++ build.xml	2001/09/30 12:31:42
  @@ -14,7 +14,7 @@
     <property name="Name" value="Ant"/>
     <property name="name" value="ant"/>
  -  <property name="version" value="1.4"/>
  +  <property name="version" value="1.4.1b1"/>
     <property name="debug" value="true" />
     <property name="deprecation" value="false" />
  No                   revision
  No                   revision   +76 -15    jakarta-ant/docs/manual/OptionalTasks/ejb.html
  Index: ejb.html
  RCS file: /home/cvs/jakarta-ant/docs/manual/OptionalTasks/ejb.html,v
  retrieving revision 1.8
  retrieving revision
  diff -u -w -u -r1.8 -r1.8.2.1
  --- ejb.html	2001/08/05 09:31:23	1.8
  +++ ejb.html	2001/09/30 12:31:42
  @@ -20,7 +20,7 @@
   <p>Version @VERSION@<br>
  -$Id: ejb.html,v 1.8 2001/08/05 09:31:23 conor Exp $
  +$Id: ejb.html,v 2001/09/30 12:31:42 conor Exp $
   <h2>Table of Contents</h2>
  @@ -533,20 +533,6 @@
     <li>TOPLink for WebLogic 2.5.1-enabled entity beans</li>
  -<p>This task supports two approaches to creating ejb jar files. The first 
  -approach assumes a particular naming convention for deployment descriptor files. 
  -For an Account bean, for example, the deployment descriptor would be named 
  -<code>Account-ejb-jar.xml</code>. This naming convention allows the task to

  -distinguish deployment descriptors without relying on their positioning within a 
  -source tree. It is also used to derive the name of the .jar file which is 
  -generated. For the example this would be <code>Account.jar</code>. Vendor 
  -specific files are assumed to be named in a similar fashion. The deployment 
  -descriptor file which defines additional weblogic specific information for the 
  -above bean would be <code>Account-weblogic-ejb-jar.xml</code>. The second 
  -approach does not require a naming convention. This approach uses a specified a 
  -jar name for the resultant ejb jar. If the jar name is present, then no naming 
  -convention is required. If the jar name is not specified, then the default 
  -naming convention is expected for the deployment descriptor files.</p>
   <p>The task works as a directory scanning task, and performs an action for each 
   deployment descriptor found. As such the includes and excludes should be set 
  @@ -571,6 +557,75 @@
   any of these files are newer than the jar file the jar will be rebuilt otherwise 
   a message is logged that the jar file is up to date.</p>
  +<h3>Naming Convention</h3>
  +Ejbjar handles the processing of multiple beans, and it uses a set of naming 
  +conventions to determine the name of the generated EJB jars. The naming convention 
  +that is used is controlled by the &quot;naming&quot; attribute. It supports the

  +following values
  +<p>This is the default naming scheme. The name of the generated bean is derived from
  +name of the deployment descriptor.  For an Account bean, for example, the deployment 
  +descriptor would be named <code>Account-ejb-jar.xml</code>. Vendor specific
descriptors are
  +located using the same naming convention. The weblogic bean, for example, would be named
  +<code>Account-weblogic-ejb-jar.xml</code>. Under this arrangment, the deployment
  +can be separated from the code implementing the beans, which can be useful whe the same
bean code
  +is deployed in separate beans. 
  +<p>This scheme is useful when you are using one bean per EJB jar and where you may
  +deploying the same bean classes in different beans, with different deployment characteristics.
  +<p> This naming scheme uses the &lt;ejb-name&gt; element from the deployment
descriptor to
  +determine the bean name. In this situation, the descriptors normally use the generic
  +descriptor names, such as <code>ejb-jar.xml</code> along with any associated
vendor specific descriptor
  +names. For example, If the value of the &lt;ejb-name&gt; were to be given in the
deployment descriptor 
  +as follows:
  +    &lt;enterprise-beans&gt;
  +        &lt;entity&gt;
  +            &lt;ejb-name&gt;Sample&lt;/ejb-name&gt;
  +            &lt;home&gt;org.apache.ant.ejbsample.SampleHome&lt;/home&gt;
  +then the name of the generated bean would be <code>Sample.jar</code> 
  +<p> This scheme is useful where you want to use the standard deployment descriptor
names, which may be more
  +compatible with other EJB tools. This scheme must have one bean per jar.
  +In this mode, the name of the generated bean jar is derived from the directory 
  +containing the deployment descriptors. Again the deployment descriptors typically use
  +the standard filenames. For example, if the path to the deployment descriptor is 
  +<code>/home/user/dev/appserver/dd/sample</code>, then the generated 
  +bean will be named <code>sample.jar</code>
  +This scheme is also useful when you want to use standard style descriptor names. It is
  +most useful when the  descriptors are located in the same directory as the bean source
  +although that is not mandatory. This scheme can handle multiple beans per jar.  
  +The final scheme supported by the &lt;ejbjar&gt; task is used when you want to
specify the generated
  +bean jar name directly. In this case the name of the generated jar is specified by the

  +&quot;basejarname&quot; attribute. Since all generated beans will have the same
name, this task should
  +be only used when each descriptor is in its own directory.
  +This scheme is most appropriate when you are using multiple beans per jar and only process
a single 
  +deployment descriptor. You typically want to specify the name of the jar and not derive
it from the
  +beans in the jar.
   <table border="1" cellpadding="2" cellspacing="0">
  @@ -604,6 +659,12 @@
                        task is generating generic jars (i.e. no vendor-specific
                        deployment elements have been specified).</td>
       <td valign="top" align="center">Yes</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">naming</td>
  +    <td valign="top">Controls the naming convention used to name generated
  +                     EJB jars. Please refer to the description above.</td>
  +    <td valign="top" align="center">No</td>
       <td valign="top">basejarname</td>

View raw message