vmassol 02/01/19 10:16:42
Modified: docs/framework/xdocs changes.xml contributors.xml
doc-book.xml howto_ide.xml site-book.xml
Added: docs/framework/xdocs howto_ide_jbuilder4.xml
howto_ide_jbuilder5.xml
Removed: docs/framework/xdocs howto_ide_jbuilder.xml
Log:
new JBuilder5 integration tutorial. Thanks Sean !
Revision Changes Path
1.78 +14 -49 jakarta-cactus/docs/framework/xdocs/changes.xml
Index: changes.xml
===================================================================
RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/changes.xml,v
retrieving revision 1.77
retrieving revision 1.78
diff -u -r1.77 -r1.78
--- changes.xml 13 Jan 2002 21:21:17 -0000 1.77
+++ changes.xml 19 Jan 2002 18:16:42 -0000 1.78
@@ -28,6 +28,15 @@
<table>
<tr>
<td>
+ 19/01/2002
+ </td>
+ <td>
+ New <link href="howto_ide_jbuilder5.html">JBuilder 5 tutorial</link>
+ for Cactus integration. Thanks Sean !
+ </td>
+ </tr>
+ <tr>
+ <td>
14/11/2001
</td>
<td>
@@ -45,54 +54,6 @@
<link href="changes.html#release_changes">Release Notes</link>.
</td>
</tr>
- <tr>
- <td>
- 22/09/2001
- </td>
- <td>
- The <link href="howto_ejb.html">EJB testing
- tutorial</link> is now available ! Thanks Hudson !
- </td>
- </tr>
- <tr>
- <td>
- 18/09/2001
- </td>
- <td>
- The <link href="howto_testcase_jsp.html">Taglib testing
- tutorial</link> is now available ! Thanks Nicholas !
- </td>
- </tr>
- <tr>
- <td>
- 15/09/2001
- </td>
- <td>
- A cactus-dev mailing list has been created (in addition to the
- existing cactus-user one). See the
- <link href="mailinglist.html">Mailing-list page</link>.
- </td>
- </tr>
- <tr>
- <td>
- 15/09/2001
- </td>
- <td>
- Cactus is now a top level Jakarta project ! All documentations have
- been updated to reflect this and package names have changed from
- <code>org.apache.commons.cactus.*</code> to
- <code>org.apache.cactus.*</code>.
- </td>
- </tr>
- <tr>
- <td>
- 10/09/2001
- </td>
- <td>
- The <link href="howto_testcase_filter.html">Filter testing
- tutorial</link> is now available !
- </td>
- </tr>
</table>
</s1>
@@ -127,8 +88,12 @@
</devs>
<release version="1.3 in CVS">
+ <action dev="VMA" type="add" due-to="Sean Zhang"
due-to-email="[EMAIL PROTECTED]">
+ New <link href="howto_ide_jbuilder5.html">JBuilder5 integration
+ tutorial</link>.
+ </action>
<action dev="VMA" type="add">
- Added support for BASCI authentication. Thanks to
+ Added support for BASIC authentication. Thanks to
<link href="mailto:[EMAIL PROTECTED]";>Jason Robertson</link>
and
<link href="mailto:[EMAIL PROTECTED]";>Peter Wong</link>. See class
1.14 +3 -0 jakarta-cactus/docs/framework/xdocs/contributors.xml
Index: contributors.xml
===================================================================
RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/contributors.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- contributors.xml 13 Jan 2002 21:21:17 -0000 1.13
+++ contributors.xml 19 Jan 2002 18:16:42 -0000 1.14
@@ -94,6 +94,9 @@
<li>
<link href="mailto:[EMAIL PROTECTED]";>Kaarle Kaila</link>
</li>
+ <li>
+ <link href="mailto:[EMAIL PROTECTED]";>Sean Zhang</link>
+ </li>
</ul>
</s1>
1.35 +2 -1 jakarta-cactus/docs/framework/xdocs/doc-book.xml
Index: doc-book.xml
===================================================================
RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/doc-book.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- doc-book.xml 15 Dec 2001 20:52:36 -0000 1.34
+++ doc-book.xml 19 Jan 2002 18:16:42 -0000 1.35
@@ -57,7 +57,8 @@
<menu-item label="IDE Howto" source="howto_ide.xml"/>
<menu-item type="hidden" source="howto_ide_vajava_wte.xml"/>
<menu-item type="hidden" source="howto_ide_vajava_tomcat.xml"/>
- <menu-item type="hidden" source="howto_ide_jbuilder.xml"/>
+ <menu-item type="hidden" source="howto_ide_jbuilder4.xml"/>
+ <menu-item type="hidden" source="howto_ide_jbuilder5.xml"/>
<menu-item label="JUnitEE Howto" source="howto_junitee.xml"/>
</menu>
1.4 +11 -2 jakarta-cactus/docs/framework/xdocs/howto_ide.xml
Index: howto_ide.xml
===================================================================
RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/howto_ide.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- howto_ide.xml 15 Dec 2001 20:52:36 -0000 1.3
+++ howto_ide.xml 19 Jan 2002 18:16:42 -0000 1.4
@@ -22,7 +22,15 @@
</p>
<ul>
<li>
- <link href="howto_ide_jbuilder.html">JBuilder Integration</link>,
+ <link href="howto_ide_jbuilder4.html">JBuilder Integration
+ Tutorial</link> (more focused on JBuilder 4),
+ </li>
+ <li>
+ Another <link href="howto_ide_jbuilder5.html">JBuilder Integration
+ Tutorial</link> (more focused on JBuilder 5),
+ </li>
+ <li>
+ <link href="howto_ide_jbuilder.html">JBuilder 4 Integration</link>,
</li>
<li>
VisualAge for Java Integration :
@@ -45,7 +53,8 @@
from your IDE (possibly in debug mode if you wish to debug your
test case) and set up correctly the class path (see the
<link href="getting_started.html">Getting Started</link> tutorial
- for understanding the classpath).
+ for understanding the classpath). Look at the tutorials for other IDEs
+ and do the same for yours.
</p>
</s1>
1.31 +2 -1 jakarta-cactus/docs/framework/xdocs/site-book.xml
Index: site-book.xml
===================================================================
RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/site-book.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- site-book.xml 15 Dec 2001 20:52:36 -0000 1.30
+++ site-book.xml 19 Jan 2002 18:16:42 -0000 1.31
@@ -57,7 +57,8 @@
<menu-item label="IDE Howto" source="howto_ide.xml"/>
<menu-item type="hidden" source="howto_ide_vajava_wte.xml"/>
<menu-item type="hidden" source="howto_ide_vajava_tomcat.xml"/>
- <menu-item type="hidden" source="howto_ide_jbuilder.xml"/>
+ <menu-item type="hidden" source="howto_ide_jbuilder4.xml"/>
+ <menu-item type="hidden" source="howto_ide_jbuilder5.xml"/>
<menu-item label="JUnitEE Howto" source="howto_junitee.xml"/>
</menu>
1.1 jakarta-cactus/docs/framework/xdocs/howto_ide_jbuilder4.xml
Index: howto_ide_jbuilder4.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
<document>
<header>
<title>JBuilder 4 Integration</title>
<authors>
<person name="Cedric Chabanois" email="[EMAIL PROTECTED]"/>
<person name="Kunal Vaishnav" email="[EMAIL PROTECTED]"/>
<person name="Vincent Massol" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Forewords and Requirements">
<p>
First of all, JUnit and Cactus jar files are needed for this tutorial, please
download them :
</p>
<ul>
<li>
<link href="downloads.html">cactus</link>
</li>
<li>
<link href="http://www.junit.org/";>junit</link>
</li>
</ul>
</s1>
<s1 title="Step 1 : Create junit and cactus libraries">
<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.
Let's also assume <strong><code>{Tomcat dir}</code></strong> to be the
Tomcat directory.
</p>
<figure src="images/jb_libraries.gif" alt="jbuilder libraries" />
<s2 title="Create the junit library">
<p>
Create a new library named <code>junit</code>.
Add the junit.jar file to this library in the class tab.
</p>
</s2>
<s2 title="Create the cactus library">
<p>
Create a library named <code>cactus</code>.
Add <code>cactus.jar</code> and optionnaly
<code>log4j-core.jar</code>. Note that
<code>log4j-core.jar</code> is useful only if you wish to get
some Cactus runtime logs.
</p>
<note>
You can also add the source file directories in the source tab :
<code>{Cactus dir}/src/framework/servlet22</code> and
<code>{Cactus dir}/src/framework/share</code>
This way, you will be able to debug inside cactus sources.
</note>
</s2>
<s2 title="Create the tomcat library">
<p>
Create another library named <code>tomcat</code>
and add all the jar files from <code>{Tomcat dir}/lib</code>.
</p>
<note>
If you use JBuilder 4 Enterprise or JBuilder 4 Professionnal, you don't
need to create
this library because Tomcat 3.1 is provided with those versions.
</note>
</s2>
</s1>
<s1 title="Step 2 : Set up the cactus.properties file">
<p>
Edit a new file named <code>cactus.properties</code>
(see the <link href="howto_config.html">Configuration Howto</link>
tutorial for more details on <code>cactus.properties</code>).
</p>
<p>
Sample <code>cactus.properties</code> file :
</p>
<source><![CDATA[
cactus.servletRedirectorURL = http://localhost:8080/cactus/ServletRedirector
]]></source>
<p>
Copy your <code>cactus.properties</code> file to a directory present
in your classpath. You can copy it to a directory and add this
directory in the class tab of the cactus library.
</p>
</s1>
<s1 title="Step 3 : Configure Tomcat Environment">
<s2 title="Create a cactus webapp">
<p>
Create and edit the file <code>{Tomcat
dir}/webapps/cactus/WEB-INF/web.xml</code> :
</p>
<source><![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd";>
<web-app>
<servlet>
<servlet-name>ServletRedirector</servlet-name>
<servlet-class>org.apache.cactus.server.ServletTestRedirector</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>ServletRedirector</servlet-name>
<url-pattern>/ServletRedirector</url-pattern>
</servlet-mapping>
</web-app>
]]></source>
</s2>
<note>
You can edit <code>{Tomcat dir}/conf/web.xml</code> instead if you prefer.
<br />
You can also edit the web.xml file of the webapp where is located the
servlet(s) you want to test. <br />
Don't forget to modify <code>cactus.properties</code> file accordingly.
</note>
</s1>
<s1 title="Step 4 : Configure your project">
<ol>
<li>
Put <code>-classic -Dtomcat.home="{Tomcat dir}"</code> as the VM
parameters for your project and
<code>org.apache.tomcat.startup.Tomcat</code> as the main class.
</li>
<li>
Add the following libraries in the <code>Required Libraries</code> tab in
the
project properties :
<ul>
<li>tomcat</li>
<li>servlet</li>
<li>junit</li>
<li>cactus</li>
</ul>
<figure src="images/jb_paths.gif" alt="jbuilder libraries" />
</li>
</ol>
</s1>
<s1 title="Step 5 : Test and debug your servlet">
<s2 title="Test your servlet">
<ol>
<li>
Start Tomcat using the <code>Run/Run Project</code> menu.
</li>
<li>
Run your unit tests : right Click on the file containing your test case
and click on <code>run</code>
</li>
</ol>
</s2>
<s2 title="Debug your servlet and your tests">
<p>
You can easily print the results of the methods on the server-side itself.
</p>
<p>
You can also start Tomcat in debug mode (<code>Run/debug project</code>).
This way, you can stop at breakpoints on methods that are executed on the
server side (<code>void testXXX()</code> for example)
</p>
<p>
If you right click on the file containing your test case and click on
<code>debug</code>,
you can stop at breakpoints on methods that are executed on the client
side like
<code>void endXXX(WebResponse)</code> or <code>void
beginXXX(WebRequest)</code>
</p>
</s2>
</s1>
</body>
</document>
1.1 jakarta-cactus/docs/framework/xdocs/howto_ide_jbuilder5.xml
Index: howto_ide_jbuilder5.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
<document>
<header>
<title>JBuilder 5 Integration</title>
<authors>
<person name="Sean Zhang" email="[EMAIL PROTECTED]"/>
<person name="Vincent Massol" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Forewords and Requirements">
<p>
This document describes steps to setup Cactus to unit test Server side
code (i.e. EJBs, Servlets, etc) deployed to Weblogic 6.1 within
Jbuilder5 IDE.
</p>
<p>
The steps described below apply to current release (Cactus 1.2 as of
this writing) and assuming that Cactus has been installed correctly
(which means that you can run sample successfully).
</p>
</s1>
<s1 title="Step 1 : Create cactus.properties file">
<p>
Create cactus.properties file : Add entry to identify the URL of the
redirector. For example:
<code>cactus.servletRedirectorURL =
http://localhost:7001/test/ServletRedirector </code>. Modify this to
reflect the actual redirector used and the actual URL of the
redirector.
</p>
</s1>
<s1 title="Step 2 : Configure Cactus to work with JBuilder5">
<p>
Follow these steps :
</p>
<ol>
<li>
Click Menu item Tools/Configure Libraries to open Configure Libraries
wizard
</li>
<li>
On the lefthand side of Configure Libraries wizard, click on New
button to open New Library Wizard.
</li>
<li>
Enter value <code>"cactus"</code> in the Name field. Choose
<code>"user home"</code> from the Location drop down menu.
</li>
<li>
Click on Add button to open the dialog to choose files.
</li>
<li>
Navigate to <code>[cactus home]/lib/</code> directory, select
<code>cactus.jar</code> and click OK button.
</li>
<li>
Click on Add button again to open the dialog to choose files.
</li>
<li>
Navigate to the directory where the <code>cactus.properties</code>
file is saved.
</li>
<li>
Click OK button.
</li>
<li>
Click "Add as Class Path" button if "No Paths Found" dialog box pops
up
</li>
<li>
Follow steps 2 - 6 to add <code>junit.jar</code>,
<code>httpclient.jar</code> which are all in
<code>[cactus home]/lib</code> directory
</li>
<li>
Optionally, add <code>log4j-core.jar</code> in
<code>[cactus home]/lib</code> directory to enable cactus logging
</li>
<li>
Click Menu item Project/Project Properties to open Project
Properties dialog box
</li>
<li>
Click Path tab and then Required Libraries tab
</li>
<li>
Click Add button and add the libraries created above to your project.
</li>
</ol>
</s1>
<s1 title="Step 3 : Configure Cactus for Weblogic6.1">
<ol>
<li>
Open <code>web.xml</code> in <code>WEB-INF</code> directory of the
web application deployed on Weblogic
</li>
<li>
Add the mapping for the redirector under the
<code><web-app></code> element.
</li>
<li>
Copy <code>cactus.jar</code>, <code>junit.jar</code>,
<code>log4j-core.jar</code>(optional) to <code>WEB-INF/lib</code>
directory of the web application
</li>
<li>
Copy your classes files to <code>WEB-INF/classes</code> directory of
the web application
</li>
</ol>
</s1>
<s1 title="Step 4 : Run the test">
<ol>
<li>
In JBuilder, click Menu item Project/Project Properties
</li>
<li>
Click Run tab and then Application tab
</li>
<li>
Open "Select Main Class for Project" dialog box and choose the test
case class which has a main method in it.
</li>
<li>
Run your project
</li>
</ol>
</s1>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
