source: release-kits/lirk3/bin/ant-installer/web/manual/manual/OptionalTasks/BorlandEJBTasks.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3

File size: 6.1 KB
Line 
1<!--
2 Licensed to the Apache Software Foundation (ASF) under one or more
3 contributor license agreements. See the NOTICE file distributed with
4 this work for additional information regarding copyright ownership.
5 The ASF licenses this file to You under the Apache License, Version 2.0
6 (the "License"); you may not use this file except in compliance with
7 the License. You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17<html>
18
19<head>
20<meta http-equiv="Content-Language" content="en-us">
21<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
22<title>Borland EJB Tasks</title>
23</head>
24
25<body>
26
27<h2><a name="log">BorlandDeploy</a>Tool</h2>
28<p>by Benoit Moussaud (<a href="mailto:[email protected]">[email protected]</a>)</p>
29
30
31<h3>Description</h3>
32<p>The BorlandDeployTool is a vendor specific nested element for the Ejbjar optional task.</p>
33<p>BorlandDeploymentTool is dedicated to the Borland Application Server 4.5.x and Borland
34 Enterprise Server 5.x. It generates and compiles the stubs and skeletons for all ejb described into the
35 Deployment Descriptor, builds the jar file including the support files and
36 verify whether the produced jar is valid or not.</p>
37
38<p>Benoit Moussaud maintains a separate <a
39href="http://www.moussaud.org/ejbjar.html">FAQ</a> for this task at
40his homepage.</p>
41
42<h3>Borland element</h3>
43<table border="1" cellpadding="2" cellspacing="0">
44 <tr>
45 <td valign="top" width="63"><b>Attribute</b></td>
46 <td valign="top" width="915"><b>Description</b></td>
47 <td align="center" valign="top" width="62"><b>Required</b></td>
48 </tr>
49 <tr>
50 <td valign="top" width="63">destdir</td>
51 <td valign="top" width="915">The base directory into which the generated borland
52 ready jar files are deposited</td>
53 <td align="center" valign="middle" width="62">yes</td>
54 </tr>
55 <tr>
56 <td valign="top" width="63">debug</td>
57 <td valign="top" width="915">If true, turn on the debug mode for each borland
58 tools (java2iiop, iastool ...) default = false</td>
59 <td align="center" valign="middle" width="62">no</td>
60 </tr>
61 <tr>
62 <td valign="top" width="63">verify</td>
63 <td valign="top" width="915">If true, turn on the verification at the end
64 of the jar production (default = false)</td>
65 <td align="center" valign="middle" width="62">no</td>
66 </tr>
67 <tr>
68 <td valign="top" width="63">verifyargs</td>
69 <td valign="top" width="915">extra parameter for verify command</td>
70 <td align="center" valign="middle" width="62">no</td>
71 </tr>
72 <tr>
73 <td valign="top" width="63">suffix</td>
74 <td valign="top" width="915">String value appended to the basename of the
75 deployment descriptor to create the filename of the Borland EJB jar file.</td>
76 <td align="center" valign="middle" width="62">No, defaults to '-ejb.jar'.</td>
77 </tr>
78 <tr>
79 <td valign="top" width="63">basdtd</td>
80 <td valign="top" width="915"><b>Deprecated</b>. Defines the location of the
81 DTD which covers the Borland specific deployment descriptors.
82 This should not be necessary if you have borland in your classpath. If you
83 do not, you should use a nested
84 <a href="ejb.html#ejbjar-dtd"><code>&lt;dtd&gt;</code></a> element, described
85 in the ejbjar task documentation.</td>
86 <td align="center" valign="middle" width="62">no</td>
87 </tr>
88 <tr>
89 <td valign="top" width="63">ejbdtd</td>
90 <td valign="top" width="915"><b>Deprecated</b>. Defines the location of the
91 ejb-jar DTD in the class hierarchy. This should not be necessary
92 if you have borland in your classpath. If you do not, you should use a
93 nested <a href="ejb.html#ejbjar-dtd"><code>&lt;dtd&gt;</code></a> element,
94 described in the ejbjar task
95 documentation. </td>
96 <td align="center" valign="middle" width="62">no</td>
97 </tr>
98 <tr>
99 <td valign="top" width="63">generateclient </td>
100 <td valign="top" width="915">If true, turn on the generation of the corresponding
101 ejbjar (default = false)</td>
102 <td align="center" valign="middle" width="62">no</td>
103 </tr>
104 <tr>
105 <td valign="top" width="63">version</td>
106 <td valign="top" width="915">set the Borland Application Version.
107 <ul>
108 <li>4 means B.A.S (Borland Application Server) 4.x, target will add ejb-inprise.xml file</li>
109 <li>5 means B.E.S (Borland Application Server) 5.x, target will add ejb-borland.xml file</li>
110 </ul>
111 </td>
112 <td align="center" valign="middle" width="62">No, defaults to 4</td>
113 </tr>
114 <tr>
115 <td valign="top" width="63">java2iiopParams </td>
116 <td valign="top" width="915">If filled, the params are added to the java2iiop command (ex: -no_warn_missing_define)</td>
117 <td align="center" valign="middle" width="62">no</td>
118 </tr>
119
120</table>
121
122<h3>Examples</h3>
123<p>The following build.xml snippet is an example of how to use Borland element
124 into the ejbjar task</p>
125<pre> &lt;ejbjar srcdir=&quot;${build.classes}&quot; basejarname=&quot;vsmp&quot; descriptordir=&quot;${rsc.dir}/hrmanager&quot;&gt;
126 &lt;borland destdir=&quot;lib&quot; verify=&quot;on&quot; generateclient=&quot;on&quot; version=&quot;5&quot;&gt;
127 &lt;classpath refid=&quot;classpath&quot;/&gt;
128 &lt;/borland&gt;
129 &lt;include name=&quot;**\ejb-jar.xml&quot;/&gt;
130 &lt;support dir=&quot;${build.classes}&quot;&gt;
131 &lt;include name=&quot;demo\*.class&quot;/&gt;
132 &lt;include name=&quot;demo\helper\*.class&quot;/&gt;
133 &lt;/support&gt;
134 &lt;/ejbjar&gt;</pre>
135<pre>The borland element will generate into the lib dir an ejb jar file using the deployment descriptor placed into the ${rsc.dir}/hrmanager directory.
136The verify phase is turned on and the generate client phase as well.
137</pre>
138
139<h3>&nbsp;</h3>
140
141</body>
142</html>
143
Note: See TracBrowser for help on using the repository browser.