Cactusチュートリアル - トム猫とサボテンのダンス

• はじめに
• Tomcat Quickstart について
• Step 1：Tomcatのインストール
• Step 2：Cactus jarsをコピー
• Step 3：Tomcat web.xmlを編集
• Step 4：テスト用のサンプルアプリケーションを作る
• Step 5：テストを実行する
• Step 6：もっと面白く！
• おまけ：サーバーサイドで XSLT Transformations

はじめに

Tomcat Quickstart について

• Cactusのjarファイルを全部 WEB-INF/lib に入れるやり方。Classpath Tutorial( http://jakarta.apache.org/cactus/integration/howto_classpath.html )で説明してるよ。
• Cactusのjar達をコンテナクラスパスに入れて、コンテナのContextクラスローダーを使うやり方。ここでは、こちらを説明します。こっちの方が面倒くさくないし、使いまわしが利くから。

Step 1：Tomcatのインストール

訳注：2003年10月31日現在の最新バージョンは、Tomcat 4.1.27。
http://sunsite.tus.ac.jp/pub/apache/jakarta/tomcat-4/tomcat-4.1.27.tar.gz
インストールの仕方は、ApacheとTomcatの連携の中で解説してます。

Step 2：Cactus jarsをコピー

訳注：zipファイルへの直リンク
J2EE API 1.2：http://ring.asahi-net.or.jp/archives/net/apache/dist/jakarta/cactus/binaries/jakarta-cactus-12-1.5-rc1.zip
J2EE API 1.3：http://ring.asahi-net.or.jp/archives/net/apache/dist/jakarta/cactus/binaries/jakarta-cactus-13-1.5-rc1.zip

• cactus.jar
• commons-httpclient.jar
• commons-logging.jar
• junit.jar
• aspectjrt.jar

訳注：実際にはこんな感じです。(J2EE API 1.3の場合)

[tmp]# wget http://ring.asahi-net.or.jp/archives/net/apache/dist/jakarta/cactus/binaries/jakarta-cactus-13-1.5-rc1.zip
[tmp]# jar xvf jakarta-cactus-13-1.5-rc1.zip
[tmp]# cd jakarta-cactus-13-1.5-rc1/lib/
[lib]# cp cactus-1.5-rc1.jar [tomcat-root]/common/lib/cactus.jar
[lib]# cp commons-httpclient-2.0-rc2.jar [tomcat-root]/common/lib/commons-httpclient.jar
[lib]# cp commons-logging-1.0.3.jar [tomcat-root]/common/lib/commons-logging.jar
[lib]# cp junit3.8.1.jar [tomcat-root]/common/lib/junit.jar
[lib]# cp aspectjrt-1.1.1.jar [tomcat-root]/common/lib/aspectjrt.jar
[lib]# cp httpunit-1.5.3.jar [tomcat-root]/common/lib/httpunit.jar

Step 3：Tomcat web.xmlを編集

<servlet>
　<servlet-name>ServletRedirector</servlet-name>
　<servlet-class>
　　org.apache.cactus.server.ServletTestRedirector
　</servlet-class>
</servlet>

<servlet>
　<servlet-name>ServletTestRunner</servlet-name>
　<servlet-class>
　　org.apache.cactus.server.runner.ServletTestRunner
　</servlet-class>
</servlet>

訳注：wikiの都合上、全角スペースを使ってますので、このままコピペでは使えないっす。半角に変換してね。
以下インデントは全角スペースです。

<servlet-mapping>
　<servlet-name>ServletRedirector</servlet-name>
　<url-pattern>/ServletRedirector</url-pattern>
</servlet-mapping>

<servlet-mapping>
　<servlet-name>ServletTestRunner</servlet-name>
　<url-pattern>/ServletTestRunner</url-pattern>
</servlet-mapping>

Step 4：テスト用のサンプルアプリケーションを作る

[tomcat-root]/webapps
　　　　　　　　　　|- test
　　　　　　　　　　　　　|- WEB-INF
　　　　　　　　　　　　　　　　|- classes

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;

public class SampleServlet extends HttpServlet
{
　　public void saveToSession(HttpServletRequest request)
　　{
　　　　String testparam = request.getParameter("testparam");
　　　　request.getSession().setAttribute("testAttribute", testparam);
　　}
}

import junit.framework.Test;
import junit.framework.TestSuite;

import org.apache.cactus.ServletTestCase;
import org.apache.cactus.WebRequest;

public class TestSampleServlet extends ServletTestCase
{
　　public TestSampleServlet(String theName)
　　{
　　　　super(theName);
　　}

　　public static Test suite()
　　{
　　　　return new TestSuite(TestSampleServlet.class);
　　}

　　public void beginSaveToSessionOK(WebRequest webRequest)
　　{
　　　　webRequest.addParameter("testparam", "it works!");
　　}

　　public void testSaveToSessionOK()
　　{
　　　　SampleServlet servlet = new SampleServlet();
　　　　servlet.saveToSession(request);
　　　　assertEquals("it works!", session.getAttribute("testAttribute"));
　　}
}

Step 5：テストを実行する

Step 6：もっと面白く！

おまけ：サーバーサイドで XSLT Transformations

[...]
<servlet>
　　<servlet-name>ServletTestRunner</servlet-name>
　　<servlet-class>
　　　　org.apache.cactus.server.runner.ServletTestRunner
　　</servlet-class>
　　<init-param>
　　　　<param-name>xsl-stylesheet</param-name>
　　　　<param-value>styles/cactus-report.xsl</param-value>
　　</init-param>
</servlet>
[...]