vmassol 01/07/01 02:48:09
Modified: cactus/docs/framework/xdocs doc-book.xml index.xml
site-book.xml
Added: cactus/docs/framework/xdocs ide_vajava.xml
Log:
new tutorial for Cactus integration within VAJava
Revision Changes Path
1.12 +1 -0 jakarta-commons/cactus/docs/framework/xdocs/doc-book.xml
Index: doc-book.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/cactus/docs/framework/xdocs/doc-book.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- doc-book.xml 2001/06/14 13:27:06 1.11
+++ doc-book.xml 2001/07/01 09:48:09 1.12
@@ -40,6 +40,7 @@
<menu-item label="Servlet Sample" source="sample_servlet.xml"/>
<menu-item label="Ant integration" source="ant.xml"/>
<menu-item label="Servlet Engines" source="servlets.xml"/>
+ <menu-item label="VAJava Config" source="ide_vajava.xml"/>
<menu-item type="external" label="API Reference" href="javadoc/index.html"/>
</menu>
1.14 +9 -0 jakarta-commons/cactus/docs/framework/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/cactus/docs/framework/xdocs/index.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- index.xml 2001/06/18 21:07:14 1.13
+++ index.xml 2001/07/01 09:48:09 1.14
@@ -47,6 +47,15 @@
<table>
<tr>
<td>
+ 01/07/2001
+ </td>
+ <td>
+ New <link href="ide_vajava.html">tutorial</link> for installing
+ Cactus inside VisualAge for Java.
+ </td>
+ </tr>
+ <tr>
+ <td>
18/06/2001
</td>
<td>
1.11 +1 -0 jakarta-commons/cactus/docs/framework/xdocs/site-book.xml
Index: site-book.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/cactus/docs/framework/xdocs/site-book.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- site-book.xml 2001/06/14 13:27:06 1.10
+++ site-book.xml 2001/07/01 09:48:09 1.11
@@ -40,6 +40,7 @@
<menu-item label="Servlet Sample" source="sample_servlet.xml"/>
<menu-item label="Ant integration" source="ant.xml"/>
<menu-item label="Servlet Engines" source="servlets.xml"/>
+ <menu-item label="VAJava Config" source="ide_vajava.xml"/>
<menu-item label="API Reference" source="javadoc.xml"/>
</menu>
1.1 jakarta-commons/cactus/docs/framework/xdocs/ide_vajava.xml
Index: ide_vajava.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
<document>
<header>
<title>VisualAge for Java Integration</title>
<authors>
<person name="Vincent Massol" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Forewords and Requirements">
<p>
I would like to thank <link href="mailto:[EMAIL PROTECTED]";>
Todd Idler</link> and <link href="mailto:[EMAIL PROTECTED]";>
Andrew B Forman</link> for providing this tutorial.
</p>
<p>
I have received reports that the following tutorial works with
VAJava 3.5.2 and 3.5.3. Please tell us if you find that it works with
other versions.
</p>
<note>
If for any reason you cannot succeed in integrating Cactus with
VisualAge for Java, please send a mail to the Cactus mailing list.
Make sure you mention your exact version of VAJava (with patch level).
</note>
</s1>
<s1 title="Step 1 : Import the correct packages in VAJava">
<p>
Let's assume the following conventions :
<strong><code>{Cactus dir}</code></strong> is the directory where you
have unzipped the Cactus distribution or sources and
<strong><code>{VAJava dir}</code></strong> is the directory where
VAJava is installed. Let's also define <strong><code>{WTE dir}</code>
</strong> to be the WebSphere Test Environment directories, i.e.
<code>{VAJava dir}/ide/project_resources/IBM WebSphere Test
Environment</code>.
</p>
<p>
You need to create 3 projects : one for JUnit, one for Cactus (
let's call it "Cactus") and
optionally one for Log4j. Note that the Log4j one is useful only if
wish to get some Cactus runtime logs. If you don't import the Log4j
classes, some Cactus classes will appear with a red cross in VAJava
but you can safely ignore them as they won't be executed.
</p>
<note>
You can either import the source files or the compiled classes as you
wish. If you import the source file, you should import the following
directories : <code>{Cactus dir}/src/framework/servlet22</code> and
<code>{Cactus dir}/src/framework/share</code>. You also need to
copy the following files into
<code>{VAJava dir}/ide/project_resources/Cactus</code> :
<code>log_client.properties</code> and
<code>log_server.properties</code> which are located in
<code>{Cactus dir}/sample/conf/test</code>. If you have imported from
the Cactus jar file, and you have selected to import resources files
then they have been automatically imported for you.
</note>
</s1>
<s1 title="Step 2 : Set up the cactus.properties file">
<p>
Copy your <code>cactus.properties</code> file (see the
<link href="configuration.html">configuration page</link> for more
details on <code>cactus.properties</code>) to
<code>{VAJava dir}/ide/project_resources/Cactus</code>
</p>
</s1>
<s1 title="Step 3 : Modify WebSphere Test Environment">
<s2 title="Edit default.servlet_engine">
<p>
Edit <code>{WTE dir}/properties/default.servlet_engine</code> and
add the following under the <code>default_app</code> webgroup :
</p>
<source><![CDATA[
<websphere-webgroup name="test">
<description>Cactus Testing Web Application</description>
<document-root>$approot$/web</document-root>
<classpath>$approot$/servlets</classpath>
<root-uri>/test</root-uri>
<auto-reload enabled="true" polling-interval="3000"/>
<shared-context>false</shared-context>
</websphere-webgroup>
]]></source>
</s2>
<s2 title="Create a test directory">
<p>
Create a directory called <code>test</code> under
<code>{WTE dir}/hosts/default_host</code>. Under <code>test</code>
create another 2 subdirectories : <code>servlets</code> and
<code>web</code>.
</p>
</s2>
<s2 title="Create a test.webapp file">
<p>
Create a <code>test.webapp</code> file in
<code>{WTE dir}/host/default_app/servlets</code> and put the following
content :
</p>
<source><![CDATA[
<?xml version="1.0"?>
<webapp>
<name>test</name>
<description>Cactus testing web application</description>
<error-page>/ErrorReporter</error-page>
<servlet>
<name>ServletRedirector</name>
<description>Cactus Testing ServletRedirector</description>
<code>org.apache.commons.cactus.server.ServletTestRedirector</code>
<servlet-path>/ServletRedirector</servlet-path>
<autostart>false</autostart>
</servlet>
<servlet>
<name>JspRedirector</name>
<description>Cactus Testing JspRedirector</description>
<code>/test/web/redirector.jsp</code>
<servlet-path>/JspRedirector</servlet-path>
<autostart>false</autostart>
</servlet>
<servlet>
<name>ErrorReporter</name>
<description>Default error reporter servlet</description>
<code>com.ibm.servlet.engine.webapp.DefaultErrorReporter</code>
<servlet-path>/ErrorReporter</servlet-path>
<autostart>true</autostart>
</servlet>
<servlet>
<name>jsp</name>
<description>JSP support servlet</description>
<code>com.ibm.ivj.jsp.jasper.runtime.JspDebugServlet</code>
<init-parameter>
<name>workingDir</name>
<value>$server_root$/temp/default_app</value>
</init-parameter>
<init-parameter>
<name>jspemEnabled</name>
<value>true</value>
</init-parameter>
<init-parameter>
<name>scratchdir</name>
<value>$server_root$/temp/JSP1_1/default_app</value>
</init-parameter>
<init-parameter>
<name>keepgenerated</name>
<value>true</value>
</init-parameter>
<autostart>true</autostart>
<servlet-path>*.jsp</servlet-path>
</servlet>
<servlet>
<name>file</name>
<description>File serving servlet</description>
<code>com.ibm.servlet.engine.webapp.SimpleFileServlet</code>
<servlet-path>/</servlet-path>
<init-parameter>
<name></name>
<value></value>
</init-parameter>
<autostart>true</autostart>
</servlet>
</webapp>
]]></source>
</s2>
<s2 title="Copy the Cactus JSP Redirector file">
<p>
Copy the <code>{Cactus dir}/sample/web/test/redirector.jsp</code>
file to <code>{WTE dir}/hosts/default_host/test/web</code>.
</p>
</s2>
</s1>
<s1 title="Step 4 : Edit VAJava workspace classpath">
<p>
Add the following to the VAJava workspace classpath (select menu
"Window... | Resources" under VAJava) :
</p>
<source><![CDATA[
{VAJava dir}\ide\project_resources\JUnit\;
{VAJava dir}\ide\project_resources\Cactus\;
{VAJava dir}\ide\project_resources\Log4j\;
]]></source>
</s1>
<s1 title="Step 5 : Edit VAJava workspace classpath">
<p>
In the WebSphere Test Environment under Servlet Engine, add Cactus,
JUnit, Log4j, and the project that contained the tests to the
classpath.
</p>
</s1>
<s1 title="Final note">
<note>
With this configuration, you'll find <code>cactus_client.log</code>
under <code>{VAJava dir}/ide/project_resources/{project being
tested}</code> and <code>cactus_server.log</code> under
<code>{VAJava dir}/ide/tools/com-ibm-ivj-ui-webcontrolcenter</code>
when you run your tests.
</note>
</s1>
</body>
</document>
