[Javaのお部屋] [java.dev.jp] [developer.jp]
[Tomcat]

Tomcat 4でServlet/JSP するメモ

Jakarta Tomcat は、Apache のサブプロジェクトでつくられている Servlet / JSP のリファレンス環境である。
こいつを使って、Servlet / JSP のいろいろを試す。
Tomcat 4とApache の連携は、あちこち探しても日本語資料が微量というか・・・まとまってないですねぃ・・・。
というわけで、解読というか、いろいろ試してApache との連携の解読に成功しました。そういえば、PostgreSQLのJDBCドライバとか、繋ぐものが好きかもしれない・・・。

このページのもくじ

• インストール
• [Tomcat 5.5版]
• Tomcatちょっと翻訳
• Apacheと連携
  • mod_jk2
  • mod_webapp (完成?)
• JSP/Servlet Webアプリケーションの製作
• 掲示板づくり

インストール

必要なもの

• Java 2 SDK, Standard Edition 1.2以降?
• Jakarta Tomcat 4.1系

Tomcat 5の場合は、ほとんど変わりませんが

• J2SE SDK 1.4ぐらい
• Jakarta Tomcat 5.0.25

3.x は Linux メモでちょこっとメモしていました。もう古いので使うのはやめましょう。
4.x は、同じです。最新版は、2004年、4.1.30 です。古いものは危険です。
バイナリ版をインストールします。
バイナリ版Tomcat は、Standard版とLE版の2つが用意されています。
この違いは、LE版では実行に必要な環境のうち J2SDK1.4に含まれているXMLパーサを含んでいません。LE版にXMLパーサを組み合わせればJ2SDK1.2以降でも動作します。
その他、JavaMail、Java Activation Framework (JAF)、Xerces、JNDI、JDBC標準拡張も、LE版には含まれていません。

ファイル名は、4.1.18からjakarta- の名称がなくなっているようです。

解凍する

# tar zxvf tomcat-4.1.x.tar.gz
# mv tomcat-4.1.x /usr/local
# cd /usr/local
# ln -s tomcat-4.1.x tomcat

ユーザは tomcat なんていうのを作っておくと安全かもしれません。

# adduser tomcat
# chown -R tomcat:tomcat /usr/local/tomcat-4.1.x

環境設定するんかな?

/etc/profile または、ユーザの環境変数に
JAVA_HOME とか、いろいろ設定します。
Tomcat 4系の環境変数は、CATALINA_HOME と CATALINA_BASE があります。

CATALINA_HOME以外は実行ユーザで書き込み権限があった方がいいのかもしれません。
あと、PATHにも $CATALINA_HOME/bin を追加しておくといいかもしれません。
# su - tomcat
となって startup.sh をつんつんすると、Tomcat がさくっと起動します。Tomcat 3系より軽そうにメッセージ少ないです。

ディレクトリはどうなってるの?

tomcat をどこへインストールしたのか知りませんが、その中は、こんなふうになっています。

%CATALINA_HOME%
  bin/
  common/ Catalina とWebアプリの共通クラス群?
    classes/ 共通のクラス置き場?
    lib/ 共通ライブラリ置き場 ( jre/lib/ext 相当? )
         ant とか activation とか mail とか
  server/ Catalina内部クラス (CATALINA_BASE側かも?)
    webapps/ 管理ツール達
      shared/ からっぽ?

%CATALINA_BASE%
  conf/ 設定ファイル
    server.xml メインの設定ファイル(サンプル入り)
    server-noexamples.xml.config サンプルを外した server.xmlファイル
    web.xml デフォルトのweb.xml
    tomcat-users.xml 簡単なユーザ定義
  logs/ ログ
  webapps/ アプリケーション (conf/server.xmlで変更可)
    ROOT/
    admin.xml
    manager.xml
  work/ 作業ファイル置き領域

%CATALINA_TMPDIR%
  /

ドキュメントのなかで、CATALINA とか書かれてるのは、Tomcat 4系の開発コードのようです。
webapps の中に、各種Webアプリケーションというものが置かれていたり、作ったりできます。
さらにその中の WEB-INF/ というディレクトリは、設定やラリブラリをいろいろと置けてしまいます。
conf/server.xml の Context をカキカキすることで、webapps 以外へのWEBAPP配置もできます。(4 ではできないとか、誰かが言ってたけど、そなのか?)

• WEB-INF/
  • classes/ クラスを置きましょ
  • jsp/ 外から見えない部品的JSPファイルを置きましょ (推奨? 標準じゃないかも?)
  • lib/ アプリケーション固有の jar ライブラリを置いてみましょ
  • tlds/ タグライブラリ置けます。(推奨ディレクトリ?)
  • web.xml 定義ファイルだぞ
  • その他いろいろ置けるよ

まぁとりあえず、動作確認もできたところで、設定ファイルいってみよう

conf/server.xml です。(日本語コメント付き UTF-8)
conf/tomcat-users.xml

tomcat-users.xml は、adminとmanager管理ツールのアクセス制限等につかうもののようです。
role というのがアプリケーション、user がユーザのようです。
Tomcat 4.1.xには admin と manager というツールがついているようですので、これのユーザを追加してみましょう。
Windows版のTomcat は、インストールする時にこのユーザも入力しているかもしれません。
まず、<role rollname="admin"/> と <role rolename="manager.xml"/> を role のところへ追加します。
<user username="username" password="password" roles="admin,manager"/> なんてふうに、追加します。

Tomcat が起動されていたら、再起動しましょう。
http://localhost:8080/ の admin とか manager というところへ追加したアカウントでアクセスできるようになっているはずです。

web.xml の設定

Apache とごにょごにょする?

Last update 2003.9.8

ApacheとTomcat をごにょごにょするには、mod_jk2やmod_webapp というものを使います。この近辺の日本語資料が少ないので悲しいです。
なんか、mod_webapp とか、coyote とか mod_jk2 とかいろいろあるので混乱しがちですが、次のような感じです。

Tomcat 4.1.x には最初から coyote が入ってたので、次はApache 側の設定をしてみましょう。

mod_webapp とmod_jk2がありますが、mod_jk(古いもの)とmod_webapp を比べた場合にはmod_webappの方が素直な設定のようなので、私的にはWebモジュール単位でApacheと連携できるmod_webappをおすすめします。

mod_jk2は、jspだけをマッピングしたり、サーブレットのマッピングとか面倒ではないのでしょうかね・・・? Webモジュール内の処理は全部Tomcat側で処理させた方がいいので、おすすめできません。CGIやPHPなどを使う場合は、モジュールの外で分けて使うようにしましょう。

• mod_webapp の設定
• mod_jk2の設定