rough justice

strutsフレームワークを利用してシステム開発する場合、どうしてもstruts-config.xml他設定ファイルを常に編集しながら作業をおこなうことになります。
eclipseにXML用のエディタプラグインをインストールしていても、設定量が増えてくるにつれて不便になってきます。っていうか、目がチカチカする。

こんなのが延々と続く。視力落とすよ。

というわけで、struts用のeclipseプラグインをインストールするわけですが、いろいろな種類のプラグインが有償・無償いろいろな形で提供されています。無償のものをいくつか試してみて、結局「Struts Console」に決めました。

一言で言うと、struts-config.xml・validation.xml・tiles-defs.xmlなんかの編集ツールです。グラフィカルなエディタというか…とりあえずインストールしてみましょう。

事前にEclipse3.1のインストールがおこなわれている必要があります。

（※注　以下の説明文でパスの区切り文字が「\（バックスラッシュ）」で表記されていますが、「￥」に読み替えてください。）

Struts Console のページにアクセスし、上の方、Version 4.8 Now Availableのリンク（06/03/02 現在）をクリックします。

「Download」一覧の一番上、「.zip」リンクをクリックします。

ダウンロード先を指定して（どこでも）、「struts-console-4.8.zip」を保存します。

保存したzipファイルをお手持ちの解凍ツールで解凍します（ディレクトリ付き解凍）。解凍すると、「struts-console-4.8」というディレクトリが作成されます。

そのディレクトリを開くとさらに「com.jamesholmes.console.struts」というディレクトリがあります。

このディレクトリを<eclipse インストール先>\pluginsディレクトリの中にコピーします。

eclipseを再起動しましょう。インストールはこれで終了です。

まずちょっとだけStruts Consoleの設定をしましょう。
メニューバー「ウィンドウ」-「設定」を開いて、「Struts Console」の設定をします。

「Enable pretty output」のチェックをONにしましょう。このチェックをつけていないと、action mapping 等の設定が一つにつき１行で編集されてしまいます。（たとえば <action>タグから</action>タグまで）これすんごく横長になってしまって、かなり横スクロールでの移動を強いられます。
チェックをONにすると、設定ダイアログの下部分に例が出ているように成形しながら編集してくれます。行間隔やインデントの種類等も設定できます。
ただし、注意書きにあるように、このチェックがONの場合、設定ファイル内のコメントは全て消えてしまうのでそのつもりで。

では、実際に動作を見てみましょう。
WEB-INF/struts-config.xmlを右クリックして表示されるメニューから、「アプリケーションから開く」を見ると、「Struts Console」が増えていて、かつstruts-config.xmlに関連付けられていると思います。

開いてみるとこんな感じ。eclipseの上（というか外というか）にStruts Console のウィンドウが開きます。

Form Beans やら Action Mapping をこのウィンドウで編集していくわけです。機能的にはそれ以上でもそれ以下でもないんですが、XMLを直接編集するよりは便利さを味わえるはずです。

Struts Consoleウィンドウで編集した内容は、入力したコントロール（テキストやリストやチェックボックスなど）からフォーカスが外れた時に反映するようです。

で、ここからは余談なのですが、Struts Consoleと他のエディタを同時に開いた場合の動作を検証してみましょう。

Struts Consoleのウィンドウを開いたまま、もう一度 WEB-INF/struts-config.xmlを右クリックしてメニューを表示します。「アプリケーションから開く」-「Amateras XMLエディタ」を選択します。

eclipse内で、XMLエディタで開けましたね。これで２つのエディタで同じファイルを見ていることになります。

試しにaction mapping に forward属性を一つ追加してみましょう。

「Forwards」タブの「Add」ボタンを押して、fowardを一つ追加します。とりあえず「change」という名前で作りました。

Struts Consoleウィンドウの、「Forwards」タブには当然、１行追加されて見えます。この時struts-config.xmlファイル実体にも更新されています。

eclipseのamateras XMLエディタのほうはどうでしょう。Struts Console ウィンドウから、eclipseをアクティブにしてみると…おっ、即時反映されますね。

こんな風に、グラフィカル表示・テキスト表示を見比べながら編集していくと効率も上がるでしょう。

J2EEアプリケーションの設定ファイル（あるいは国際化対応）は、プロパティファイルを利用することになります。しかし、仕様上プラットホーム非依存を実現するために、ファイル内のマルチバイト文字をJ2SDKに付属の「native2ascii」ツールでUnicodeに変換しなければなりません。
たいした手間ではないものの、頻繁に「native2ascii」を実行するのも面倒になってきます。

そこで今回は、プロパティファイル編集用のeclipseプラグインをインストールします。
このプラグインでは、プロパティ編集中はマルチバイト文字で表示させ、保存時に自動的にUnicodeに変換してくれます。

事前にEclipse3.1のインストールがおこなわれている必要があります。。

更新サイトが用意されているので、ネットワークインストールをおこなうこととします。

インターネット環境にHTTPでアクセスする際、プロキシサーバーを経由している場合はEclipse HTML Editor プラグインのインストールを参考に、先にプロキシの設定をおこなってください。

sourceforge更新サイトに接続します。メニューの「ヘルプ」-「ソフトウェア更新」-「検索とインストール」を選択します。

フィーチャーの更新では、「インストールする新規フィーチャーを検索」を選択して次へボタンを押します。

更新アクセス先サイトでは、まず「新規リモート・サイト」ボタンを押します。

名前に「property editor」、URLに「http://propedit.sourceforge.jp/eclipse/updates/」を入力してOKボタンを押します。

更新先アクセスサイトでは、「property editor」のチェックをONにして終了ボタンを押します。

指定サイトに接続されるまで待ちます。

サイトに登録されているフィーチャーがツリー表示されます。「PropertiesEditorForEclipse3.x」のチェックをONにして、次へボタンを押します。

使用条件の条項に同意して、次へボタンを押します。

インストールするフィーチャーが表示されるので、終了ボタンを押します。

フィーチャーにデジタル署名されていない旨の警告が表示されますが、かまわず「すべてインストール」ボタンを押します。

しばし待ちます。

インストールが完了すると、ecilpseの再起動確認ダイアログが表示される場合があります。お奨めされているので、はいボタンを押します。

Eclipseが再起動されます。

これでプロパティエディタのインストールは完了です。
では、実際に動作を見てみましょう。
プロパティファイルは、「WEB-INF/src」下に配置してあります。

プロパティファイルのアイコンが、エディタのアイコンになっているので、ダブルクリックで開きます。

もしアイコンがプロパティエディタのものになっていなかったら、右クリックメニューから「アプリケーションから開く」-「PropertiesEditor」を選択して開いてください。

こんな漢字でマルチバイト文字で表示されます。ハイライトもされていますね。

通常のJavaエディタのように、「Ctrl+S」キーで保存すると、実ファイルはUnicodeで保存されます。
確認してみましょう。エディタ上で右クリックして表示されるメニューから「Unicode表示」を選択します。

Unicode変換されたファイル内容が表示されます。実ファイルの中身はこうなっているわけです。

EclipseのテキストエディターはWindowsメモ張並のエディターなので、
HTML・JSP等を記述する時はなにかと不便なものです。
そこで、Eclipseにエディタープラグインをインストールします。

いろいろなエディターが公開されているのですが、ここでは
Eclipse HTML Editor を選択します。
公開されているサイトでは、エディタ機能として以下の点が挙げられています。

HTML/JSP/XML/CSSのシンタックスハイライト

Browserコントロールによるプレビュー

HTMLタグ要素、属性名、閉じタグのコンテンツアシスト

ウィザードによるHTML/JSP/XMLファイルの作成

HTML編集支援機能（選択範囲のタグエスケープ、コメント化）

見出しのアウトライン表示

エディタの設定（強調表示の色、タブ/分割形式の切り替え）

JSPタグ、カスタムタグの補完

XMLのアウトライン表示、DTDベースの補完・バリデーション

HTML/JSP/XMLエディタでのフォールディング機能

Eclipseのエディタとして動作するWebブラウザ

イメージビューア（「ウィンドウ」→「ビューの表示」→「その他」から「HTML/JSP/XMLエディタプラグイン」→「イメージ」を選択）

タグパレット（「ウィンドウ」→「ビューの表示」→「その他」から「HTML/JSP/XMLエディタプラグイン」→「パレット」を選択）

CSSエディタでの補完、アウトライン表示

もともとHTML/JSP/XML/CSSのシンタックスハイライト・コード補完をおこなってくれる上に、tablibの設定がされている場合はtldの情報を読んで、カスタムタグ（strutsタグでも）のハイライト・補完もできてしまうわけです。COOL COOL COOL!

バージョンは1.6.9が最新です。(06/02/21現在)
事前にEclipse3.1のインストールがおこなわれている必要があります。。

まずEclipse HTML Editorを動作させるためにはeclipse.orgから提供されるGEF(Graphical Editing Framework)も必要になるので先にインストールします。すでにGEFがeclipseにインストールされている場合は、この項を読み飛ばしてください。

GEFのインストールはEclipseの更新サイトからネットワークインストールすることにします。インターネット環境にHTTPでアクセスする際、プロキシサーバーを経由している場合は、ブラウザの設定とは別にEclipseでもプロキシの指定をしなければなりません。（プロキシの無い環境では、この項を読み飛ばしてください）

[ウィンドウ]-[設定]メニューを選択し、[インストール/更新」を選択します。ここで下段「プロキシｰ設定」をおこないます。「HTTPプロキシｰ接続を使用可能にする」チェックをONにし、プロキシサーバーのIPアドレスと、ポート番号を指定してOKボタンを押します。（下画像のIPアドレスはでたらめなので、自身の環境にあわせて読み替えてください）

Eclipse更新サイトに接続します。メニューの「ヘルプ」-「ソフトウェア更新」-「検索とインストール」を選択します。

フィーチャーの更新では、「インストールする新規フィーチャーを検索」を選択して次へボタンを押します。

更新アクセス先サイトでは、「Eclipse.org update site」のチェックをONにして終了ボタンを押します。

指定サイトに接続されるまで待ちます。

指定サイトにミラーサイトが用意されている場合、サイトを選択することができます。ここではそのまま「Eclipse.org update site」を選択してOKボタンを押します。（会津大に繋がんなかった…）

サイトに登録されているフィーチャーがツリー表示されます。「Graphical Editing Framework 3.1.1」のチェックをONにして、次へボタンを押します。

使用条件の条項に同意して、次へボタンを押します。

インストールするフィーチャーが表示されるので、終了ボタンを押します。

フィーチャーにデジタル署名されていない旨の警告が表示されますが、かまわず「すべてインストール」ボタンを押します。

しばし待ちます。

インストールが完了すると、ecilpseの再起動確認ダイアログが表示される場合があります。お奨めされているので、はいボタンを押します。

Eclipseが再起動されます。

これでGEFのインストールは完了です。

さて、ここからEclipse HTML Editorのインストールを始めます。

Project AmaterasサイトのEclipse HTML Editor Pluginのページにアクセスし、上の方「ダウンロード」-「こちらからどうぞ」リンクをクリックします。

EclipseHTMLEditor欄の一番上が最新バージョンです。」-「tk.eclipse.plugin.htmleditor_1.6.9.zip」リンクをクリックします。

ダウンロード先を指定して（どこでも）、「 tk.eclipse.plugin.htmleditor_1.6.9.zip」を保存します。

保存したzipファイルをお手持ちの解凍ツールで解凍します（ディレクトリ付き解凍）。解凍すると、「plugins」といるディレクトリが作成されるので、まるごと<eclipseインストール先> ディレクトリにコピーします。

プラグインをインストールしたらお約束、Eclipseの再起動をおこないます。

以上でEclipse HTML Editorのインストールは完了です。では、実際に動作するか見てみましょう。

プロジェクト内のHTMLファイルをEclipse HTML Editorで開いてみます。ファイルを右クリックして表示されるメニューの「アプリケーションから開く」を選択すると、サブメニュー内に「Amateras HTMLエディタ」が増えています。選択してみましょう。

タグがハイライト表示されていますね？
またタグを途中まで入力すると補完リストが表示されます。

HTMLの他にXML・CSS・JSPファイルなどでも試してみてください。
「アプリケーションから開く」で選択されたエディタはファイルごとに記憶されているので、次回はダブルクリックのみで最後に指定したエディタ（アプリケーション）で開かれます。

では、JSPファイルでカスタムタグが指定されている場合はどうなるでしょうか。以下Strutsのカスタムタグの例です。

補完されるじゃないですか！COOL COOL COOL!
もちろんtablibが正しく設定されていないと補完されません。おかしいなと思ったらtablibの記述を調べてみてください。

EclipseにTomcatと連携されるプラグインをインストールします。いろいろな種類のプラグインが公開されていますが、ここでは「Sysdeo Tomcat プラグイン」を利用します。（将来的にはWTPも試してみるつもり）

「Sysdeo Tomcat プラグイン」をインストールすると、Eclipseから以下のことがおこなえます。

Tomcatの起動・停止・再起動

Eclipseのデバッガでデバッグ（ブレークポイント・スッテプイン・ステップアウト）

server.xmlファイルの自動作成・更新

同コンフィグレーションファイルの選択

プロジェクトからwarファイルの作成

TomcatのJVMパラメータ・クラスパス・ブートクラスパスの設定

バージョンはV3.1が最新です。(06/02/10現在)
事前にEclipse3.1のインストールがおこなわれている必要があります。。

（※注　以下の説明文でパスの区切り文字が「\（バックスラッシュ）」で表記されていますが、「￥」に読み替えてください。）

sysdeo.comのダウンロードサイトにアクセスし、上の方「Te'le'chargement」-「tomcatPluginV31.zip」リンクをクリックします。

ダウンロード先を指定して（どこでも）、「tomcatPluginV31.zip」を保存します。

保存したzipファイルをお手持ちの解凍ツールで解凍します（ディレクトリ付き解凍）。解凍すると、「com.sysdeo.eclipse.tomcat_3.1.0」というディレクトリが作成されるので、まるごと<eclipseインストール先>\plugins ディレクトリにコピーします。

eclipseを起動すると（既に起動している場合は再起動）、メニューバーに「Tomcat」が、ツールボタンににゃんこちゃんが追加されているはずです。

メニューバー「ウィンドウ」-「設定」を開いて設定ダイアログを表示し、「Tomcat」の設定をしましょう。

「Tomcat バージョン」は現在トムキャット5.0がインストールされているので「バージョン 5.x」を選択します。
「Tomcat ホーム」はTomcatをインストールしている場所です。

「コンテキスト宣言モード」は、コンフィグレーションファイルの選択となります。
「server.xml」を選択すると、<TOMCAT_HOME>\conf\server.xml にアプリケーションコンテキストの設定が更新されます。
「コンテキストファイル」を選択すると、指定したディレクトリ（デフォルトは <TOMCAT_HOME>\conf\Catalina\localhost）にアプリケーションコンテキストの設定ファイル（プロジェクト名.xml）が作成されます。

つまり、「server.xml」を選択した場合は複数のアプリケーションを１つのファイルで一括管理、「コンテキストファイル」を選択した場合は、アプリケーションごとに１つずつのファイルで管理となります。どちらでもよいですが、個人的には「コンテキストファイル」の方が各種設定の使い勝手が良いように感じます。

次に一つツリーを下がって「JVMの設定」を選択します。「JRE」の項目が、設定ダイアログの「Java」-「インストール済みのJRE」と同じものが表示されていることを確認しましょう。（SUN J2SE JDKであること）

ツリーで同じ並びの「Tomcat Webアプリケーション」を選択します。アプリケーションを再ロードさせるために、URL・ユーザー名・パスワードを設定します。事前に、manager権限をもったTomcatユーザーを作成しておく必要があります。

ApacheとTomcatをJK2で連携させて、8080番ポートのリスニングを止めている場合は、デフォルトの「http://localhost:8080/manager」から「http://localhost/manager」に変更します。

ここまで設定できたら「OK」ボタンを押して設定ダイアログを閉じます。プラグインの設定は完了です。

Eclipseのインストールをおこないます。3.1.2もリリースされていますが、ここでは3.1.1のインストールをおこないます。
事前にJ2SE SDKのインストールがおこなわれて…なくてもEclipseはjreされあれば動作しますが、Tomcat環境での開発のために事前にインストールしておきます。

（※注　以下の説明文でパスの区切り文字が「\（バックスラッシュ）」で表記されていますが、「￥」に読み替えてください。）

Eclipse Projectのダウンロードサイトにアクセスし、上の方「Latest Releases」-「3.1.1」リンクをクリックします。

「Eclipse SDK」の中から、Platform「Windows」の「eclipse-SDK-3.1.1-win32.zip」リンクをクリックします。
ミラーサイトが一覧で表示されますので、適当なサイトを選びます。

ダウンロード先を指定して（どこでも）、「eclipse-SDK-3.1.1-win32.zip」を保存します。

保存したzipファイルをお手持ちの解凍ツールで解凍します（ディレクトリ付き解凍）。解凍先がEclipseのインストール先となります。なお、解凍するとまず「eclipse」というディレクトリが解凍先に作成され、その中に各種ファイル・ディレクトリが保存されます。今回の例ではEドライブの直下に保存しました。

そのまま起動すると、メニューやヘルプ全てが英語表記となります。起動前にEclipseの日本語化もおこないましょう。Eclipse Projectから言語パックが公開されています。

先ほどのダウンロードサイトから、一番下の方にある「Language Packs」-「3.1.1 Language Packs」リンクをクリックします。

上から一つ目の表「SDK Language Packs」で、１行目「NLpack1」の２列目「Windows 98/ME/2000/XP」のリンク、２つあるうちの下「NLpack1-eclipse-SDK-3.1.1a-win32.zip」をクリックします。
ミラーサイトが一覧で表示されますので、適当なサイトを選びます。

ダウンロード先を指定して（どこでも）、「NLpack1-eclipse-SDK-3.1.1a-win32.zip」を保存します。

さて、このファイルもzip形式なので解凍ソフトで解凍（ディレクトリ付き解凍）することになります。Eclipse本体と同様、解凍先に指定したディレクトリに「eclipse」というディレクトリを作成し、その中に言語パックライブラリ類が保存されるので、解凍先にはEclipse本体を解凍するときに解凍先として指定したディレクトリと同じ場所を指定しましょう。解凍ツールでは同名ファイルは上書きするようオプション指定しましょう。
解凍と同時に上書き保存が不安な方は、一旦別ディレクトリに解凍してから、解凍先の「eclipse」ディレクトリ内、「features」と「plugins」ディレクトリを、Eclipse本体のインストール先（今回の例ではE:\eclipse）ディレクトリに上書きコピーしてください。

では日本語化されたEclipseを起動してみましょう。Eclipse本体インストール先の「eclipse.exe」を起動します。（今回の例ではE:\eclipse\eclipse.exe）

作成するプロジェクトのデフォルトの保管先となる、ワークスペースディレクトリを指定します。あくまでデフォルトなので、プロジェクト新規作成時に別の場所を個別に指定することができます。よって、毎回eclipse起動時にこのダイアログが出てくるのもうっとおしいので、「この選択をデフォルトとして使用し、今後この質問を表示しない」というチェックボックスをONに設定しましょう。

設定したらOKボタンを押します。

ようこそ画面が表示されたらインストール成功です。日本語表示されていますね？

「ようこそ」タブの「×」をクリックすると、初期画面が表示されます。

最後の確認として、メニューの[ウィンドウ] - [設定]から設定ダイアログを表示して、「Java」-「インストール済みのJREを確認しておきましょう。

「ロケーション」に、既にインストールしてあるSUN J2SE JDKが表示されているか確認しておきます。他のJRE（例えばOracle 9i Clientをインストールすると、jre1.3.1がインストールされる）がインストールされている場合はよく注意して、EclipseがSUN J2SE JDK上で動いていることを確認しましょう。

ApacheへのリクエストをTomcatへ渡すコネクタの設定します。
開発環境であればTomcat内蔵のHTTPサーバーでも良いような気もしますが、
URLの「:8080」がうっとおしいし。（Tomcat HTTPサーバーのリスニングポートを80にするというは無しの方向で…）

で、tomcat.pache.orgではJK 2は既に「非推奨」であり、「JK 1.2」を使うようアナウンスされていますが、どうしても連携できなかった…(´･ω･`)ｼｮﾎﾞｰﾝ
ので、今回はJK 2でのApache-Tomcat連携です。

Tomcat Projectのダウンロードサイトにアクセスし、下の方「JK2（deprecated）」-「JK 2 Binary Releases」リンクをクリックします。

「win32」リンクをクリックして表示されるリストから、「jakarta-tomcat-connectors-jk2.0.4-win32-apache2.0.49.zip」のリンクをクリックして保存します。（どこでも）

解凍するといくつかディレクトリができるので、「modules」ディレクトリ内の「mod_jk2.so」を、（Apacheインストール先）\modules」ディレクトリへコピーします。

（Apacheインストール先）\conf\httpd.conf ファイルをエディタで開き、「LoadModule」エントリが並んでいる辺りの末尾に、

LoadModule jk2_module modules/mod_jk2.so

と１行追加します。

（Apacheインストール先）\conf ディレクトリ内に、「workers2.properties」というファイルを作成します。連携プロトコルや、Tomcatに渡すか否かを判断するURIを設定します。

いろいろ設定できますけど、ま、こんなもんでいいかと。
uriに指定している「manager」「admin」は、Tomcatに含まれている管理用アプリケーションです。今後自分でアプリケーションを作成した際は、[uri:/(コンテキスト名)/*] てな感じで追加していくことになります。

設定できたらApacheを再起動しましょう。
タスクトレイのApacheMonitorアイコンを左クリックして表示されるメニューから、「Apache2」-「Restart」を選択します。

さて、連携できているかどうかの確認ですが、まずTomcat内蔵のHTTPサーバーに直接アクセスできることを確認してから、Apacheを経由してアクセスできることを確かめましょう。対象のアプリケーションはTomcat管理用アプリケーション「admin」です。

まずブラウザで「http://localhost:8080/admin/」にアクセスして、ログイン画面が表示されることを確かめます。

同じアプリケーションにApacheを経由してアクセスします。
ブラウザで「http://localhost/admin/」にアクセスして、ログイン画面が表示されれば成功です。

最後に、Tomcat自身が8080番ポートでリスニングするのをやめさせましょう。開発環境ならいいですけど、インターネット接続環境で外部に開放する用途であれば忘れちゃだめです。
（Tomcatインストール先）\conf\server.xml をエディタで開き、

<Connector port="8080"　…

という個所をコメントアウトします。

Tomcatを再起動して、「http://localhost:8080」がアクセスできなくなっていることを確認しましょう。念のため「http://localhost/admin/」への連携が大丈夫かも確認しましょう。

Apacheのインストールをおこないます。2.2系もリリースされていますが、ここでは2.0のインストールをおこないます。

（※注　以下の説明文でパスの区切り文字が「\（バックスラッシュ）」で表記されていますが、「￥」に読み替えてください。）

Apache サイトのダウンロードページにアクセスし、上の方「Apache HTTP Server 2.0.55 is also available」-「Win32 Binary (MSI Installer)」-「apache_2.0.*-win32-x86-no_ssl.msi」リンクをクリックします。

ダウンロード先を指定して（どこでも）、「apache_2.0.*-win32-x86-no_ssl.msi」を保存します。

保存したインストーラーを実行します。

使用許諾契約条項に同意します。

使用上のご注意。

サーバー情報の設定をおこないます。

ネットワークドメイン・サーバー名は、開発環境としては localhost でいいでしょう。「Install Apache HTTP Server 2.0 programs and shortcuts for」では上の「for All Users, on Port 80, as a Service」を選択しましょう。リスニングポート80番でサービスとしてApacheがインストールされます。

インストールタイプは「カスタム」を選択します。

インストールする機能を選択します。

「Apache Documentation」は必要なければ外します（ケチくさい？）
インストール先はディレクトリ名を指定します。また、指定ディレクトリ下に「Apache2」というディレクトリが自動作成され、その下にApacheがインストールされるので注意してください。先にTomcat5.0のインストールがおこなわれており、「E:\ApacheSoftwareFoundation\tomcat5.0」のようにインストールされているのであれば、ここで「E:\ApacheSoftwareFoundation\」と指定するとすっきりします。

これで事前準備は完了。インストールを開始します。

インストール中。しばらく待ちます。

インストール完了。

インストール先のディレクトリ構成はこんな感じになります。

ブラウザから「http://localhost」にアクセスしてみましょう。

テストページが表示されれば完了です。