|
Last update : April 21 2002
Doc for : v1.3
About
What is Cactus ?
News
Changes
Features/Status
Goals
Roadmap/Todo
Contributors
Contributing
Cactus Users
Tested on ...
License
Downloads
Downloads
Documentation
How it works ?
Getting Started
Mock vs Container
Javadocs
FAQ
Howto Guides
Classpath Howto
Config Howto
Migration Howto
TestCase Howto
Security Howto
Ant Howto
HttpUnit Howto
Sample Howto
EJB Howto
IDE Howto
JUnitEE Howto
Support
Bug database
Mailing list
Misc.
Why the name ?
Logo Challenge
Resources
Stats
Developers
CVS
Coding Conventions
Build results
|
Installing Cactus |
There is not really an installation of Cactus per see, as Cactus is
not an application but a framework. However you do need to understand
how it integrates in your working environment. Thus, installing Cactus
simply means to understand what jars need to be put where and what are
the configuration files you need to have and edit. This is discussed
below.
There are 2 kinds of environments in which you may want to use
Cactus, mainly :
-
within your IDE,
-
from the command line, using
Ant
 |
Usually, these 2 environments are complementary. A good strategy is
to use an IDE to increase day to day productivity, run quickly the
Cactus tests in the IDE and use Ant to perform the
(continuous) builds (including running the Cactus tests).
|
|
System Requirements |
In order to run Cactus tests you need to have the following
software already installed on your system :
-
Java Virtual Machine
A Java 1.2 or greater compatible virtual machine must be present. Note
that all servlet engines require a JVM to run so if you are already
using servlets you already have one installed.
-
Servlet Engine
A Servlet 2.x compliant servlet engine (where x >= 2.2) for running
your Cactus tests must be present.
-
Ant (optional)
Ant is only needed if you are working from the command line or if you
wish to automate the execution of tests. If you wish to use Ant,
make sure that you read the
Ant Howto after you finish
reading this introductory guide.
|
The Cactus files |
At this point, you should have
downloaded a Cactus distribution
(for the J2EE API you intend to use) and unzipped it in a
[cactus root] directory.
The jars making up Cactus can be found in
[cactus root]/lib . Namely, they are :
-
cactus.jar : the main jar,
contains the framework classes. You can find this jar in
[cactus root]/lib .
-
cactus-ant.jar : a jar which
contains some custom Ant tasks to help integrate easily with Ant.
This is only needed if you wish to use Ant for automating the
execution of Cactus tests. For more information on how to integrate
Cactus with Ant, see the
Ant Howto tutorial. You also
find this jar in [cactus root]/lib .
-
httpclient.jar : Cactus is relying
on the Jakarta Commons HttpClient framework for Cookie handling.
-
junit.jar : Cactus extends JUnit and
thus needs the JUnit jar.
-
aspectjrt.jar : Cactus uses
AspectJ for performing
several tasks (logging entries and exit of methods, checking
configuration, etc).
-
log4j.jar (optional) : Cactus uses
Log4j for performing all internal logging. This jar is optional and if
you don't put in the classpaths, no logs will be generated.
The Cactus configuration files are described in the
Configuration Howto tutorial.
|
|
|