Migration Howto

Last update : July 29 2002
Doc for : v1.4b1

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
  • Runner Howto
  • Security Howto
  • Ant Howto
  • HttpUnit Howto
  • Sample Howto
  • EJB Howto
  • IDE Howto
  • Tomcat Howto
  • JUnitEE Howto


  • Support
  • Bug database
  • Mailing list


  • Misc.
  • Why the name ?
  • Logo Challenge
  • Resources
  • Test Coverage
  • Stats


  • Developers
  • CVS
  • Coding Conventions
  • Build results
  • Release Checklist


  • From Cactus 1.3 to 1.4

    See the Changes page for full list of changes.

    Here are the changes that might affect your previous installation of Cactus 1.3:

    • Configuring Cactus logging has changed. See the Config Howto page. Thus, the old cactus.enableLogging property no longer has any effect.
    • One new jar needs to be put in both client and server side classpaths: commons-logging.jar, due to the new logging system.
    • The following classes have been removed (they were deprecated in Cactus 1.2):
      • org.apache.cactus.ServletTestRequest,
      • org.apache.cactus.util.ClientCookie,
      • org.apache.cactus.util.AssertUtils
    • External jars provided by Cactus have been renamed to contain their version suffixed to their name.
    • The jspRedirector.jsp now creates a HTTP Session by default (it was not previously).

    From Cactus 1.2 to 1.3

    Here are the steps to migrate from Cactus 1.2 to 1.3

    Note This migration guide does not explain any of the new feature of Cactus 1.3 but concentrates on making you move from Cactus 1.2 to 1.3.

    Let's call CACTUS_HOME the directory where you unzipped the Cactus distribution.

    Follow these steps :

    • Step 1 : Put aspectjrt.jar (found in CACTUS_HOME/lib) in both your client side and server side classpaths.
    • Step 2 : Modify your cactus.properties to the new format. For example:
    • cactus.contextURL = http://localhost:8000/cactus
      cactus.servletRedirectorName = ServletRedirector
      
    • Step 3 : Ensure that cactus.servletRedirectorName does not end with a "/" and that the mapping in web.xml matches it :
    •     <servlet-mapping>
              <servlet-name>ServletRedirector</servlet-name>
              <url-pattern>/ServletRedirector</url-pattern>
          </servlet-mapping>
      

    The Cactus sample is supposed to work with Ant 1.4. However, we introduced an incompatibility at the last moment (i.e. a feature only supported by Ant 1.5). If you're using Ant 1.4, simply remove the failing line (it is an optional line).




    Copyright © 2000-2002 The Apache Software Foundation. All Rights Reserved.