Web View Technologies - Recently Updated Pages

Eclipse(ClickIDE)環境の構築

sim_j — Fri, 26 Dec 2008 00:49:47 CST

Clickフレームワークを使用した開発

Clickはシンプルなフレームワークで、事前に用意するライブラリやXMLの設定ファイルなども非常に少なく、開発中の作業にも難しいXMLの編集等がほとんど無く、またテンプレートを活用し始めるとHTMLの編集も非常に少なく済むため、IDEなどのサポートが無くてもテキストエディタとJDKだけでも十分開発が可能です。

とはいえ、より楽になるに越したことはありません。
Click用の開発環境としては非常に高機能なClick IDEがあり、これとEclipse＋WTPを組み合わせると非常に開発が楽になるので、お勧めです。

ここではWindows XP上に、Eclipse 3.2 + WTP 1.5 + ClickIDEを導入する方法を説明します。

※追記：この情報は古くなっています。すでにClickIDE 2.1がリリースされ、Eclipse3.4/WTP 3.0に対応しています

ファイルのダウンロード

まず必要なファイルをPCにダウンロードします。
JDKを入れていない人は、まずSUNからJDKをダウンロードします。ここではJava SDK 6を使用しますが、JDK 5でも問題ありません。

IDE周りですが、ClickIDEの動作環境がEclipse 3.2+WTP 1.5 なので、まずEclipse 3.2環境が必要になります。

Eclipse.orgからEclipse 3.2 SDKをダウンロードして、プラグインのアップデート機能で機能を追加していっても良いのですが、関連パッケージが多く、更新に結構時間がかかるので、wtp、eclipse、必須パッケージがひとまとめになっているwtp-all-in-oneをダウンロードして使用する事にします。加えてメニュー周りを日本語化するために、Eclipse SDK用とWTP用のNL Pack1 をダウンロードします。（動作に必須ではありません）

次にClickIDEをダウンロードします。この中にClickIDEと、必要なClickフレームワーク本体も含まれています。

開発用のアプリケーションサーバとしてTomcatをダウンロードします。バージョン5.5.x系がお勧めです（WTP 1.5ではTomcat 6.xをサポートしていません）。またtcnative-1.dllもダウンロードしておくと良いでしょう。これはWindows上でTomcatの動作を高速化するためのJNIラッパライブラリなのですが、これを入れる事でTomcat起動/終了時にでる警告メッセージを出さないようにするためにも必要です。（詳しくはこちらに解説があります）

最後に、Clickフレームワーク本体をダウンロードします。上述のようにClickIDEにClickフレームワークが含まれているので無くても開発できるのですが、ドキュメントやソースコードを閲覧するためにダウンロードしておく事をお勧めします。

名前	ダウンロード先	今回ダウンロードしたファイル	備考
Java SE 6	SUN	Java SE 6 update 2	JDK 5でも問題ありません
WTP 1.5 all-in-one	Eclipse.org	wtp-all-in-one-sdk-R-1.5.4-200705021353-win32.zip	EclipseとWTPがパックになっています
NL pack1 for Eclipse SDK	Eclipse.org	NLpack1-eclipse-SDK-3.2.1-win32.zip	日本語化
NL pack1 for WTP	Eclipse.org	NLpack1-wtp-sdk-R-1.5.1-200609230508a.zip	日本語化
ClickIDE	ClickIDE	clickide-1.70.zip	Eclipseプラグイン
Apache Tomcat	Apache.org	apache-tomcat-5.5.23.zip	開発用アプリケーションサーバ
Tomcatネイティブライブラリ	tomcat.heanet.ie	tcnative-1.dll	Tomcatの動作を高速化するライブラリ。必須ではありません
Click フレームワーク	SourceForge	click-1.3.1.zip	Click本体

導入

まず導入にあたって、導入先のディレクトリを決めてください。今回導入するEclipseもTomcatもClickの開発専用として利用しますので、すべてを1つのディレクトリ以下に収めるようにします。この例ではE:\work\click\以下に導入します。ご自分の環境に合わせて読み替えてください。

JDKの導入

JDKが導入されていない環境の人は、最初にJava SEを導入します。ダウンロードしたexeファイルを実行して、何回かクリックするだけで設定する箇所がほとんど無いので難しいところは無いと思います。私の場合は、JDKの導入ディレクトリを C:\Program Files\Java\jdk6\に、JREのディレクトリをC:\Program Files\Java\jre6\に変更して導入しています。

Eclipse+WTP環境の導入

ダウンロードしたwtp-all-in-one-sdk*.zipを導入先ディレクトリに展開（unzip）すると、eclipseというディレクトリが作成されます。同様にNLpack1-eclipse-SDK*.zipとNLpack1-wtp-sdk*.zipを導入先ディレクトリに展開します。

次に、ClickIDEを導入します。ダウンロードしたclickide-*zipファイルを、一旦別の適当なディレクトリに展開します。展開した中のfeaturesディレクトリ以下にあるnet.sf.clickide.feature_1.7.0ディレクトリ全体をE:\work\click\eclipse\features以下にコピーします。同様にplugins以下にあるnet.sf.clickide_1.7.0.jarファイルをE:\work\click\eclipse\pluginsにコピーします。

Tomcatの導入

開発用のTomcatも導入先ディレクトリのE:\work\click以下に導入します。ダウンロードしたapache-tomcat-5.5.23.zipを導入先ディレクトリに展開します。E:\work\click\apache-tomcat-5.5.23というディレクトリが作成されます。

次にtcnative-1.dllを導入します（動作に必須ではありません）。このファイルはTomcat実行時に環境変数PATHが通っている場所にコピーする必要があります。C:\WINDOWS\system32等に導入しても良いのですが、システム全体に影響があるので、今回はeclipseのトップディレクトリにコピーすることにします。こうする事でeclipse上のWTPから実行した時だけtcnative-1.dllが有効になります。

Clickフレームワークの展開（オプション）

Clickフレームワーク本体のclick-1.3.1.zipをE:\work\click\以下に展開します。この作業は必須ではありませんが、オフラインでドキュメントを参照するためにやっておくと良いと思います。
展開後は、E:\work\click\click-1.3.1\documentation\index.htmlをブラウザから開くとドキュメントを参照できます。

ここまでの通りに作業を進めると最終的にはこの様なフォルダが出来ている事になります。

Eclipseの初期設定

Elipseの初回起動

導入先ディレクトリ以下のeclipse\eclipse.exeを実行するとEclipseが起動できますが、初回のみ念のため-cleanオプションを指定して起動します。スタートメニューの「ファイル名を指定して実行」から、E:\work\click\eclipse\eclipse.exe -cleanを実行します。

起動中に、ワークスペースの位置を聞かれますので、ここでは導入先のworkspaceディレクトリを指定し、「この選択をデフォルトとし、今後この質問を表示しない」にチェックを入れてOKを押します。

起動すると、「ようこそ」の画面が出ますので、×ボタンでクローズします。

JDKの登録

使用するJDKを登録しておきます。Eclipseのメニューでウィンドウ⇒設定を選択し、ダイアログでJava⇒インストール済みのJRE画面で、「追加」ボタンを押し、使用したいJDKを登録します。私の場合はC:\Program Files\java\jdk6に導入してあるJDK 6を指定しました。

JRE名を分かりやすい名前にしておき（この場合はSUN Java SE 6)、「OK」ボタンで登録します。
一覧に戻るので、今登録したJDKにチェックを入れ、デフォルトに指定し、「OK」で閉じます。

文字コードの設定

Clickの開発のために文字エンコードのデフォルトをUTF-8にします。（Clickは特にUTF-8でないと動かないという訳ではありませんが、AJAXライブラリなどとの連携を考えてUTF-8にしています）

Eclipseのメニュー、ウィンドウ⇒設定で出るダイアログで、以下の3箇所を変更します。

一般⇒ワークスペースでテキスト・ファイル・エンコーディングをUTF-8に変更

Web および XML⇒HTMLファイルで、エンコードをUTF-8に変更

Web および XML⇒CSSファイルで、エンコードをUTF-8に変更

３ヵ所を変更したら、「OK」を押します。

WTPサーバランタイムの設定

WTPからTomcatを起動できるように、展開済みのTomcat 5.5をランタイムとして登録します。
Eclipseのメニュー、ウィンドウ⇒設定で出るダイアログで、サーバ⇒インストール済みランタイムを選択し、追加ボタンを押します。

新規登録のウィザードが出るので、Apache Tomcat 5.5を選択して、「次へ」をクリックします。

次の画面で以下のように、Tomcat インストール・ディレクトリに展開済みのTomcatディレクトリを指定し、JREには、使用するJDK 1.5を指定し、「終了」を押します。

インストール済みサーバ・ランタイムの画面に戻るので、「OK」を押します。

これで開発環境の導入が完了しました。

→Eclipse(ClickIDE)を使った開発に続く

Click

sim_j — Fri, 26 Dec 2008 00:48:26 CST

自分でも使えると本当に思えるフレームワーク

Clickフレームワーク(Click Framework)は、理解が容易である事、シンプルである事を重視して作成されているWEBアプリケーションフレームワークです。

ホームページの"Why Click"のページでも一番上にSimple to leanを掲げているだけあって、本当にシンプルで理解しやすく、イントロダクション（リンク先は日本語wiki上のもの）を読んで、サンプルを眺めれば、だいたいの感覚をすぐにつかめるようになっています。また、ドキュメント類も非常に丁寧に作成されています。

少しClickの仕組みが理解できたら、Click control類（コンポーネント）のソースコードを読んでみてください。あまりにシンプルかつ簡単に作成されている事に驚くと思います。そして多くの人が「これなら自分でも作れそう」と思うのではないでしょうか。

この「自分でも作れる」という感覚が、Clickの一番の魅力だと思います。

それはフレームワークがシンプルで見通し良く作られているからこそなのですが、長大、重厚になり理解するには多くの努力が必要となるフレームワークが多くなりつつある中、この「自分でも作れる」感というのは非常に貴重だと思います。

コンテンツ

お勧め書籍

sim_j — Tue, 29 Jan 2008 08:20:51 CST

Tapestry

Enjoying Web Development With Tapestry

Tapestry 4.1に対応した数少ない書籍の1つ。英語ですが、難しい表現が少ないので比較的読みやすいです。作者のページで、太っ腹にも最初の4章までをPDFで無料公開しているので、まずはそちらを見るのが良いと思います。

Wicket

Wicket in Action

新しいWicket 1.3に対応した書籍です。(2008.06発売予定。予約受付中)

Pro Wicket (Expert's Voice in Java)

Wicket 1.2.xに対応した書籍です。第一章(30ページ強)がホームページで公開されていて参考になります。初歩的な解説から、他のフレームワーク、特にSpringフレームワークとの連携まで広くカバーされていて、お勧めです。

Maven

Apache Maven 2.0入門 Java・オープンソース・ビルドツール

Maven 2を本格的に日本語で解説した初めての書籍。
Mavenのセットアップから、高度な使い方、実際にプロジェクトで使う場合の使い方など幅広く解説しています。

Seasar 2

Seasar入門はじめてのDI&AOP

Seasar 2を網羅的に解説した本です。DIとは何か、なぜ必要なのか？というところから始まって、S2Containerの使い方、AOP、S2DAOなどの周辺ソフトの解説と幅広く解説が行われています。バージョンは2.2.xベース＋2.3の補足ですので2.4.xの新機能は解説されていませんが、基礎は変わっていませんので、DIやS2初心者向けとして良い本です。

Springフレームワーク

Spring2.0入門 Java・オープンソース・Web開発自由自在

Spring Framework 2.0を本格的に解説した初めての本です。「Java・J2EE・オープンソース Spring入門 ~より良いWebアプリケーションの設計と実装」の続編で、バージョン2.0の新機能を中心に解説された前の本の差分的な内容になっています。
Spring 2.0の新しいSpring Bean定義ファイルの解説から始まってJPA、DWR(AJAX)、Acegi（セキュリティ）、バッチ処理など広範囲に新機能が解説されています。
Spring 2.0は日本語だけでなくまだ英語での解説も多く無い状況ですので、Spring 2.0を学習したい人には貴重な本だと思います。

Clickメモ

sim_j — Sun, 27 Jan 2008 00:39:51 CST

このページには、Click Frameworkに関するちょっとしたTipsやメモをまとめます。

[Q] Pageクラスで表示するモデルをpublicで定義したくない場合は？

[A] privateで定義した変数をPage#addModelメソッドでモデルとして追加する事で対応可能

public MyPage extends Page {
private String name;

public MyPage() {
addModel("name", name);
}
}

Wicket/Maven関連リンク集

sim_j — Mon, 24 Dec 2007 02:10:01 CST

Wicket関連リンク

Apache Wicket

本家です。ドキュメント、バイナリのダウンロードなど。

Wicket Wiki

本家のWikiです。

Wicket-Library

Wicket関連の情報やリンクがまとまっています。特にWicket examplesは多くの動作サンプルとソースコードが閲覧できるので参考になります。

Wicket Bench

Eclipe用Wicket開発プラグインです。

Javaウェブフレームワーク「Wicket」の使い方

日本語で書かれたWicketのチュートリアルです。

Secret Staircase

Wicketの情報が多くまとめられているwikiです。

Qwikcet

Wicket＋Hibernate、Spring連携を含んだアプリケーションの雛形を作成するツールです。

Wicket Seasar Integration(S2Wicket)

WicketとSeasar2を連携させるための機能を提供してくれます。

Maven関連リンク

Apache Maven

本家です。ドキュメント、バイナリのダウンロードなど。

Maven wiki

本家のWikiです。

Maven2のTipsを集めるWiki

日本語でMaven2のTipsがまとめられたWikiです。

Mevenide2-Netbeans

Netbeans IDEからMaven2を使えるようにする拡張です。

Tycho: The Maven Extension for Eclipse

EclipseからMaven2を使えるようにするプラグインです。

Maven Repository

Mavenのリポジトリを検索可能なサービスです。

WEB上のMaven解説記事

Maven 2.0を知る、使う
Introduction to Apache Maven 2 (英語) 英語ですが、丁寧な解説PDFです

Wicket開発環境の構築

sim_j — Sun, 30 Sep 2007 10:28:46 CDT

Wicketフレームワークを使用した開発

Wicketは依存ライブラリが少なく、開発環境の整備はそれほど面倒ではありませんが、他のJava WEBアプリケーションフレームワーク同様、RDBMSアクセス周りの機能を持っていないので他のプロダクトが必要になりますし、Springフレームワークなどが欲しくなるかもしれません。そのため、ここではMaven 2を使った開発環境の作成例を示します。Maven 2であれば、後からライブラリを追加するのは容易です。

開発にはEclipseを使用します。アプリケーションサーバとしてはTomcat等J2EE準拠であればどのソフトでも良いのですが、WicketのQuickStartではJettyが使用されているので、Jettyを使用する事にします。

ここではWindows XP上に、Eclipse 3.2 + Maven + Jetty 環境を整える方法を解説します。

ファイルのダウンロード

まず必要なファイルをPCにダウンロードします。
JDKを入れていない人は、まずSUNからJDKをダウンロードします。ここではJava SDK 5 update 10を使用しましたが、おそらくJava SDK 6やJDK 1.4.xでも問題無く動くのではと思います。
ただしEclipse 3.2のデフォルトJDKレベルがJava SDK 5なので、新たにダウンロードする場合はJava SDK 5がお勧めです。

IDE周りとしては、Eclipse.org からEclipse 3.2.x SDKをダウンロードすれば問題ありません。お好きな方法でEclipseを導入してください。ここではダウンロードサイズを最小化する事を狙って、eclipse-platformとJDTを個別にダウンロードして導入します。同時に日本語化のNLpack1をダウンロードします。（NLpack1は動作に必須ではありません）

開発用のアプリケーションサーバとしてJettyをダウンロードします。Jettyはすでにバージョン6系がリリースされていますが、後から設定するJettyLauncherが5.xしかサポートしていないため、Jetty 5.1.xを使用します。

名前	ダウンロード先	今回ダウンロードしたファイル	備考
Java SE 5	SUN	SUN JDK 5.0 update 10	おそらくJava SE 6でも問題なく動くと思います
Eclipse platform	Eclipse.org	eclipse-platform-3.2.1-win32.zip	Eclipse本体
Eclipse JDT	Eclipse.org	eclipse-JDT-3.2.1.zip	Java開発環境
NL pack1 for Eclipse platform	Eclipse.org	NLpack1-eclipse-platform-3.2.1-win32.zip	日本語化
NL pack1 for JDT	Eclipse.org	NLpack1-eclipse-JDT-3.2.1.zip	日本語化
Jetty	codehaus	jetty-5.1.12.zip	開発用アプリケーションサーバ
Apache Mavem	Apache Maven	maven-2.0.4-bin.zip	Maven 2バイナリ

導入

まず導入にあたって、導入先のディレクトリを決めてください。今回導入するEclipseもJettyもWicketの開発専用として利用しますので、すべてを1つのディレクトリ以下に収めるようにします。この例ではE:\work\wicket\以下に導入します。ご自分の環境に合わせて読み替えてください。

JDKの導入

JDK が導入されていない環境の人は、最初にJava SEを導入します。ダウンロードしたexeファイルを実行して、何回かクリックするだけで設定する箇所がほとんど無いので難しいところは無いと思います。私の場合は、JDKの導入ディレクトリを C:\Program Files\Java\jdk\に、JREのディレクトリをC:\Program Files\Java\jre\に変更して導入しています。

Eclipseの導入

ダウンロードしたeclipse-JDT-*.zip、eclipse-platform-*-win32.zip、NLpack1-eclipse-JDT-*.zip、 NLpack1-eclipse-platform-*-win32.zipの4つのファイルを同じ導入先ディレクトリに展開します。これでE:\work\wicket\eclipseというディレクトリが作成されます。

Jettyの導入

開発用のJettyも導入先ディレクトリのE:\work\wicket以下に導入します。ダウンロードしたjetty-5.1.12.zipを導入先ディレクトリに展開します。E:\work\wicket\jetty-5.1.12というディレクトリが作成されます。

Maven2の導入

ダウンロードしたMaven2のバイナリアーカイブmaven-2*.zipを任意のディレクトリに展開し、その中のbinディレクトリにPATHを通します。また、使用するJDKの位置を環境変数JAVA_HOMEに設定します。

上記が用意できたら、動作テストのためにコマンドプロンプトからmvn -versionを実行します。ただしく動作している場合は、以下のように表示されるはずです。

E:\>mvn -version
Maven version: 2.0.4

Eclipseの起動確認とワークスペースの作成

導入先ディレクトリ以下に導入したEclipseを起動します。初回のみ、-cleanオプション付きで起動します。

起動中にワークスペースの位置を聞かれますので、任意のディレクトリを指定し、「この選択をデフォルトとして使用し、今後この質問を表示しない」にチェックを入れ、OKを押します。

Eclipseが起動したら、「ようこそ」画面をクローズします。

Jetty Launcherの導入

Eclipseメニューのヘルプ⇒ソフトウェア更新⇒検索およびインストールを選択し、「インストールする新規フィーチャーを検索」して「次へ」をクリックします。

新規リモート・サイトを登録します。URLにはhttp://jettylauncher.sourceforge.net/updates/を指定します。

検索結果が表示されたらJetty Launcher Pluginを選択し、導入します。

インストールが完了したらEclipseの再起動を促されるので、再起動し、起動を確認したら一旦Ecilpseを終了します。

クラスパス変数のセットアップ

MavenのローカルリポジトリがEclipseのビルド時に正しく認識されるために、クラスパス変数M2_REPOをEclipseに設定します。設定のためのeclipse:add-maven-repoゴールが用意されているので、それを実行します。
実行時には、以下のように-Declipse.workspaceにEclipseのワークスペースの位置を指定します。この時、ディレクトリの区切り文字は\（バックスラッシュ、円マーク）ではなく、/（スラッシュ）を使う必要があるようです。

E:\>mvn -Declipse.workspace="E:/work/wicket/workspace" eclipse:add-maven-repo
（実際は一行で入力します）

上記を実行すると、インターネットから必要なプラグインがダウンロードされ、ゴールが実行されます。

[INFO] ----------------------------------------------------------------------------
[INFO] Building Maven Default Project
[INFO] task-segment: [eclipse:add-maven-repo] (aggregator-style)
[INFO] ----------------------------------------------------------------------------
[INFO] [eclipse:add-maven-repo]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL

このようにBUILD SUCCESSFULと表示された場合は正しく実行されています。

これで開発環境の準備ができました。

（WicketとMaven2を使った開発へ続く）

Tapestry関連リンク集

sim_j — Fri, 27 Jul 2007 21:50:35 CDT

リンク集

Apache Tapestry

本家です。バージョン毎に情報が整理されており、関連情報、書籍などへのリンクも充実しています。

Tapestry @ Javaforge

Tapestryを拡張するためのライブラリが集められています。

ognlの代わりにprop:表記を実現する（高速になる）tapestry-prop
Railsのフラッシュ（flash）に似た機能を実現する tapestry-flash
Springフレームワークとの連携を実現する tapestry-spring
TestNGでTapestryアプリケーションをテストできるようにする tapestry-testing

Tapestry 5 Screencasts

Tapestry作者のHowardさんによる、Tapestry 5新機能動画デモ。Tapestry 5新機能に興味がある人には必見のデモです。

#1は、Eclipse+Maven2による開発環境設定の方法と、live class reloading機能（Tomcatを立ち上げっぱなしでもクラスの変更が反映される機能）のデモ
#2は、新しいTapestryコンポーネント(ifやloop)の使用方法と、ページ間データ転送（保持）方法のデモ
#3は、Maven2とTapestry用のtapestry-simple Maven archetypeを使用してTapestry 5プロジェクトの雛形を作成するデモ。このデモと同じように実行するにはhttp://people.apache.org/repo/m2-snapshot-repository/をリポジトリに追加する必要があります。（-DremoteRepositories=http://people.apache.org/repo/m2-snapshot-repository/）
#4は、Java Beanから自動的に入力フォーム（HTMLのform）を生成してくれ、値をBeanに設定してくれるBeanEditFormについてのデモ
#5は、新しいグリッド（表）コンポーネントのデモ

Tapestry and HiveMind

Tapestry作者のHoward Lewis Shipさんのblog。

nbtapestrysupport

NetBeans IDE上でのTapestry開発をサポートするプラグイン。

Handy edit

IntelliJ Idea用のTapestryプラグイン。

Tapestry/Spring Integration

Tapestry 5とSpring 1.2.xのインテグレーションを実現します。@Inject("spring:xxx")でBeanをインジェクションできるようになります。

Maven 2 リポジトリ

Tapestry@JavaforgeやTacos等用のMaven 2用リポジトリ。

http://howardlewisship.com/repository/com/javaforge/tapestry/

Tapestry 5のSNAP SHOT等が置かれたMaven 2用リポジトリ。

http://people.apache.org/repo/m2-snapshot-repository/

参考文献、ドキュメント

Tapestry 5 Preview at OSCON 2007

OSCON 2007でHawardさんがTapestry 5解説に使用したプレゼンテーション資料(PDFへの直接リンク)

リンク集

sim_j — Fri, 09 Mar 2007 06:01:37 CST

Click関連のリンク集

Click Framework

本家です。クイックスタート、サンプルなど、ドキュメントが充実しており、本家だけで十分な情報が入手できます。

Click Wiki

各種情報が集められたWikiです。本家には無い有用な情報が多数あります。

ClickIDE - an Eclipse plug-in for Click

Eclipse用の極めて有用なプラグインです。Eclipse 3.2+WTP 1.5で動作します。Clickは開発ツールの補助などが無くても開発が楽なフレームワークですが、このプラグインがあるとさらに楽に開発が進みます。お勧めです。

Click Wiki (日本語)

日本語で書かれたClickに関するWikiです。本家のドキュメントの重要な部分などが翻訳されていたりと非常に有用なページです。

シンプルかつ強力なコンポーネント指向フレームワーク「Click Framework」

非常にポイントを付いた解説がすばらしい、日本語の解説ページです。読むだけでどういう風に使えば良いかイメージが掴める記事です。お勧めです。

Click Framework探訪

非常に分かりやすい日本語での解説ページ。Clickの基本的な考え方が理解できます。

S2Click

DIコンテナーのSeasar2とClickを連携させるためのコンポーネント。これを使うことでS2を使ったDIや、S2関連プロダクト（S2DAOなど）との連携が可能になります。

Velocity (Ja-Jakarta)

Clickのビュー層を担当しているVelocityのドキュメントが日本語翻訳されています。特にユーザガイドは有用です。

Eclipse(Dolteng)環境の構築

sim_j — Fri, 23 Feb 2007 08:43:31 CST

（作成中）

ファイルのダウンロード

※追記： 2007/02 Eclipse 3.2に対応したDolteng 0.17.0がリリースされています。そのため、今後はEclipse 3.2が推奨環境になっていくものと思われます。
http://eclipse.seasar.org/updates/3.2/

まず必要なファイルをPCにダウンロードします。
JDKを入れていない人は、まずSUNからJDKをダウンロードします。ここではJava SDK 5 update 10を使用します。JDK 1.4.xでもTeeda Extensionは使用できますが、アノテーションを使いたい場合はJava SDK 5以上が必要になります。新たにダウンロードする場合はJava SDK 5がお勧めです。

IDE周りですが、Doltengの動作環境が（私が試した限りでは）Eclipse 3.2ではうまく動作しなかったためEclipse 3.1.2を使用します。（これは今後のDoltengのアップデートで解消するものと思われます）

Eclipse.org のアーカイブからEclipse 3.1.2 SDKをダウンロードして、プラグインを追加していっても良いのですが、関連パッケージが多いので、日本語化や関連パッケージがひとまとめになっているAll-In-One Eclipseの2.0(古いバージョン)を使用します。All-In-One Eclipse 2.0はVectorからダウンロード可能ですのでこれを利用します。

Teeda Extensionでの開発ではHTMLを編集する事が多くなります。All-In-One Eclipse 2.0に入っているWTPのHTMLエディタでも良いのですが、より高機能でプリビュー機能が付いているProject AmaterasのEclipse HTML Editorがお勧めです。こちらもダウンロードしておきます。

DoltengやSeasar関連のEclipseプラグインは Eclipseのアップデート機能で、http://eclipse.seasar.org/updates/3.1からアップデートをするので、先にダウンロードしておく必要はありません。

開発用のアプリケーションサーバとしてTomcatをダウンロードします。バージョン5.5.x系がお勧めです。またtcnative-1.dllもダウンロードしておくと良いでしょう。これはWindows上でTomcatの動作を高速化するためのJNIラッパライブラリなのですが、これを入れる事で Tomcat起動/終了時にでる警告メッセージを出さないようにするためにも必要です。（詳しくはこちらに解説があります）

またEclipseからTomcatを操作するためのSysdeo Eclipse Tomcat Launcher pluginをダウンロードします。Tomcatを簡単に起動/停止するためのプラグインで、DoltengがTomcat Launcher用にワークスペースを作成してくれるので導入しておくと便利です。

名前	ダウンロード先	今回ダウンロードしたファイル	備考
Java SE 5	SUN	SUN JDK 5.0 update 10	アノテーション使用にはJDK 5.0以上が必須
All-In-One Eclipse	Vector	All-In-One-Eclipse-2.1.0.exe	Eclipse 3.1.2に日本語化NLPackや便利なプラグインがセットになっています
Eclipse HTML Editor	SourceForge	tk.eclipse.plugin.htmleditor_2.0.2.zip	高機能なHTMLエディタ
Apache Tomcat	Apache.org	apache-tomcat-5.5.20.zip	開発用アプリケーションサーバ
Tomcatネイティブライブラリ	tomcat.heanet.ie	tcnative-1.dll	Tomcatの動作を高速化するライブラリ。必須ではありません
Sysdeo Eclipse Tomcat Launcher plugin	sysdeo	tomcatPluginV32beta3.zip ※sysdeo.comに繋がらない時のために、ここに上記ファイルのコピーを置いておきます。(tomcatPluginはMITライセンスですので再配布が可能なようです）	Tomcatの起動/停止を操作するランチャー

導入

まず導入にあたって、導入先のディレクトリを決めてください。今回導入するEclipseもTomcatもTeedaの開発専用として利用しますので、すべてを1つのディレクトリ以下に収めるようにします。この例ではE:\work\teeda\以下に導入します。ご自分の環境に合わせて読み替えてください。

JDKの導入

All-In-One Eclipseの導入

All-In-One Eclipseはダブルクリックで起動してウィザードに従って進めるしてだけで導入できますので、特に悩むところは無いと思います。今回は導入パッケージはデフォルトのままで、導入先ディレクトリをE:\work\teeda\にしました。

Eclipseの起動とアップデート

All-In-One Eclipse導入の最後で「完了」を押すとEclipseが起動します。また、デスクトップにも起動アイコンが作成されているはずです。

Eclipseの起動中にワークスペースの位置を聞かれるので、今回はE:\work\teeda\workspaceを指定し、「この選択をデフォルトとして使用し、今後もこの質問を表示しない」にチェックを入れ、「OK」を押します。

Eclipseが起動したら、「ようこそ」の画面が出ますので、起動が確認できたら、一旦Eclipseを終了します。

Eclipse HTML EditorとTomcat Launcherの導入

Eclipseを一旦終了したら、HTMLエディタとTomcatランチャーを導入します。

ダウンロードしたtomcatPluginV32beta3.zipとtk.eclipse.plugin.htmleditor_2.0.2.zipを展開すると出来るtk.eclipse.plugin.htmleditor_2.0.2フォルダとcom.sysdeo.eclipse.tomcat_3.2.0.beta3フォルダをそのままE:\work\teeda\eclipse\pluginsフォルダ以下にコピーします。

コピーしたら、-cleanオプション付きでeclipse.exeを起動します。

Dolteng、kijimuna、舞姫の導入

次にアップデート機能でDoltengプラグインなど、SeasarプロジェクトのEclipseプラグインを導入します。

「ヘルプ」⇒「ソフトウェア更新」⇒「検索とインストール」を選択し、

http://eclipse.seasar.org/updates/3.1/

Tomcatの導入

JDKの登録

使用するJDKを登録しておきます。Eclipseのメニューでウィンドウ⇒設定を選択し、ダイアログでJava⇒インストール済みのJRE画面で、「追加」ボタンを押し、使用したいJDKを登録します。私の場合はC:\Program Files\java\jdkに導入してあるJDK 1.5を指定しました。

JRE名を分かりやすい名前にしておき（この場合はSUN JDK 1.5）、「OK」ボタンで登録します。
一覧に戻るので、今登録したJDKにチェックを入れ、デフォルトに指定し、「OK」で閉じます。

その他

Linuxの場合

Linuxの場合にはAll-In-One Eclipseがありませんので、アーカイブなどからEclipse 3.1.2をダウンロードしてプラグインを追加していってください。またEclipse HTML Editorでプリビュー機能を使用する場合は環境変数MOZILLA_FIVE_HOMEをFirefox導入ディレクトリの位置に設定しておく必要がります。

例）
export MOZILLA_FIVE_HOME=/usr/lib/firefox/

WicketとMaven2を使った開発

sim_j — Mon, 12 Feb 2007 07:11:18 CST

Wicket+Maven2+EclipseによるWicket開発の始め方

（このページの内容はWicket開発環境の構築の続きです）

ここでは、Wicketでの開発にMaven2＋Eclipseを使う場合の方法を説明します。

説明には、ここで作成した開発環境を使っており、1つのディレクトリ以下にeclipse、jetty、eclipseのワークスペースがまとめられた環境を使っています。

Mavenによるプロジェクトディレクトリの作成

まず、Mavenの規約にそったプロジェクトディレクトリを作成します。コマンドプロンプトを開いて、Eclipseのワークスペースにディレクトリに移動し、

E:\>cd E:\work\wicket\workspace

以下のように、archetype:createゴールを実行します。下記のgroupId,version,artifactIdは自分の環境にあうように変更してください。

E:\work\wicket\workspace>mvn archetype:create -DgroupId=com.example -Dversion=0.0.1 -DartifactId=wicketapp1 -DarchetypeArtifactId=maven-archetype-webapp
(実際には一行で入力します）

groupId	アプリケーションを作成する組織、個人を特定するユニークなID。通常、パッケージ名を指定します。リポジトリ上に公開する場合は、他のグループIDと被らないようにする必要がありますが、個人で作成する場合は適当な名前で問題ありません。
version	任意のバージョン番号です。後から変更できます。
artifactId	組織（groupId)内で作成するアプリケーションを識別する文字列。この名前でwarファイルが作成されます。

[INFO] Archetype created in dir: E:\work\wicket\workspace\wicketapp1
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL

と表示されれば正しく作成されています。指定したarfifactIdと同じ名前のディレクトリが作成されるので、そこに移動します。

E:\work\wicket\workspace>cd wicketapp1

ディレクトリ内にはpom.xmlファイルが作成されています。pom.xmlはプロジェクト全体の依存関係などを記述するファイルです。そのpom.xmlを自分の用件にあうように編集します。ここでは以下のような追記を行いました。

まずwicketへの<dependency>を追加します。－①
また、JDK 1.5でコンパイルするためにmaven-compiler-pluginへ設定追加を行います。－②

③はソースフォルダをsrc/main/javaに明示的に指定しています。（src/main/javaデフォルトの値なので、この指定は書かなくても問題ありません）

最後に、<resources>を追加して、リソースのフィルタを変更しています。－④
これはWicketの場合、ソースフォルダにHTMLファイルを作成し、それがWARのclasses/にコピーされる必要があるためです。（デフォルトではソースフォルダにあるファイルは、コンパイル後のclassファイルのみコピーされ、HTMLファイルはコピーされない）

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>wicketapp1</artifactId>
<packaging>war</packaging>
<version>0.0.1</version>
<name>wicketapp1 Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency> 
<groupId>wicket</groupId>
<artifactId>wicket</artifactId>
<version>1.2.5</version>
<scope>compile</scope>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/main/java</sourceDirectory>　
<finalName>wicketapp1</finalName>
<plugins> 
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
</plugins>

<resources> 
<resource>
<filtering>false</filtering>
<directory>src/main/java</directory>
<includes>
<include>**</include>
</includes>
<excludes>
<exclude>**/*.java</exclude>
</excludes>
</resource>
</resources>
</build>

</project>

上記の内容はここからダウンロードできます。

=========================================================
補足：
もしmavenのcentralリポジトリに最新のWicketが無い場合は<project>タグ直下に以下のようにリポジトリを追加してください。こちらはWicketのリリースから間を置かずに最新版が置かれるようです。

<repositories>

<repository>
<id>wicket</id>
<name>Wicket repository</name>
<url>http://wicket.sourceforge.net/maven2</url>
</repository>

</repositories>
=========================================================

pom.xmlを編集したら、以下のようにeclipse:eclipseゴールを実行します。自動的に必要なjarファイルがダウンロードされ、eclipseプロジェクト内から正しく参照が設定されます。-DdownloadSources=true を付けることでソースコードもダウンロードされます。

E:\work\wicket\workspace\wickettest1>
　mvn -DdownloadSources=true eclipse:eclipse

こうして作成されたプロジェクトディレクトリには、（なぜか）Javaソースコードを保存するディレクトリが作成されていないので、Eclipseを起動する前に手動で作成しておきます。（必要ならsrc\test\javaやsrc\test\respources等も作成します）

E:\work\wicket\workspace\wickettest1>mkdir src\main\java

Eclipseを起動する

プロジェクトディレクトリが用意できたので、Eclipseを起動します。起動したら、まずパースペクティブをJavaに変更します。

次に、作成したプロジェクトディレクトリをインポートします。メニューのファイル⇒インポートでウィザードを起動し、「既存プロジェクトをワークスペースへ」を選択します。

ルート･ディレクトリとして作成したプロジェクトディレクトリを指定し、「終了」をクリックします。

右図のようにインポートされます。もしこのようにsrc/main/javaがソースフォルダとなっていない場合（アイコンがフォルダアイコン＋パッケージアイコンになっていない場合）、src/main/javaを右クリックし、ビルドパス⇒ソースフォルダとして使用を選択してください。（必要なら、同様にsrc/main/resources等もソースフォルダとして登録します）

この時点でwicketやcommons-loggingにはCLASSPATHが通されていますので、開発を始める事ができます。自動的に作成されているindex.jspは不要なので削除しておきます。

アプリケーションの作成を開始する

Wicketアプリケーションで最低限必要なのは1つのHTMLテンプレート、とそれに対応するJavaクラス、そしてアプリケーションクラスです。ここではそれぞれ、

パッケージ	com.example.wicket
アプリケーションクラス	Application.java
HTMLテンプレート	home.html
Javaクラス	Home.java

としました。

まず、web.xmlファイルを編集して、Wicketのサーブレットクラスとアプリケーションクラスを定義します。

（以下のファイルはここからダウンロード可能です）

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>

<display-name>Wicket Application</display-name>

<context-param>
<param-name>configuration</param-name>
<param-value>development</param-value>
</context-param>

<servlet>
<servlet-name>wicketapp</servlet-name>
<servlet-class>wicket.protocol.http.WicketServlet</servlet-class>
<init-param>
<param-name>applicationClassName</param-name>
<param-value>com.example.wicket.Application</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>wicketapp</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>

</web-app>

上記をサンプルにweb.xmlを編集してください。

src/main/java以下にApplicationクラスを作成します。ApplicationクラスはWebアプリケーション全体の基点となるクラスで、wicket.protocol.http.WebApplicationクラスを継承して作成します。最低限必要になるのはgetHomePage()メソッドをオーバーライドして、自分のホームページクラスを返すようにする事です。

package com.example.wicket;
import wicket.protocol.http.WebApplication;

public class Application extends WebApplication {

@Override
public Class getHomePage() {
return Home.class;
}

}

次に対になるHome.javaとhome.htmlを作成します。Home.javaはwicket.markup.html.WebPageクラスを継承して作成します。今回は何もロジックを作成しないので、ただ継承するだけです。

package com.example.wicket;
import wicket.markup.html.WebPage;

public class Home extends WebPage {

private static final long serialVersionUID = 1L;

}

HTMLテンプレートとなるhome.htmlファイルも、まずは単純に"Hello,World"と書いてあるだけのものにします。HTMLテンプレートは、Javaクラスファイルと同じディレクトリに作成する必要がある事に注意してください。

<html>
<head>

<title>Hello,World</title>

</head>
<body>

Hello,World!

</body>
</html>

これで最低限の用意が出来ましたので、アプリケーションサーバで起動してみます。

Jettyを使用して起動する

パッケージ・エクスプローラーのwicketapp1フォルダを右クリックして、デバッグ⇒構成およびデバッグを選択します。Jetty Web選択し、新規作成アイコンをクリックします。
Jetty homeにはJettyを展開したディレクトリを指定し、webapp root dirにはsrc/main/webappを指定します(もしくはtarget/wicketapp1でも良いようです)。その他は必要に応じて変更してください。設定できたら「デバッグ」を押します。

正しく設定されていると以下のようにコンソールに起動ログが表示されます。

22:45:59.671 INFO [main] wicket.protocol.http.WebApplication.logStarted(WebApplication.java:684) >14> [Application] Started Wicket in development mode

起動したらWebブラウザでhttp://localhost:8080/にアクセスして動作を確認します。図のようにHTMLテンプレートに書いた内容が表示されたら動作確認は完了です。

Jettyを停止するには、JettyLauncherのツールバーメニューから赤色のアイコンをクリックすれば停止できます。同様に人が走っているアイコンをクリックするとJettyを再起動できます。

ただし、実際の開発ではあまり再起動は必要ありません。デバッグで起動した場合はJavaクラスの変更やHTMLテンプレートの変更は、Jettyの再起動不要でほぼ即時に反映されます。

以上でEclipseを使ったWicketアプリケーション開発を進めていける環境が整いました。

補足

文字コードについて

上記は一切文字コードについて考えていませんが、実際には文字コードを設定する必要があるでしょう。ですのでHTMLテンプレートはXHTMLで書いて<?xml version="1.0" encoding="..." ?>で指定するか、Applicationクラスのinit()内で設定する必要があります。同様にレスポンスのエンコーディングを設定する場合はinit()で設定する必要があります。詳しくは以下のドキュメントで解説されています。

Javaウェブフレームワーク「Wicket」の使い方

warの作成について

作成したアプリケーションをwarファイルにしたい場合は、プロジェクトディレクトリ上でmvn packageを実行します。

E:\>cd work\wicket\workspace\wicketapp1
E:\work\wicket\workspace\wicketapp1>mvn package

こうする事で\target\ディレクトリにwicketapp1.warが作成されます。

Wicket

sim_j — Sat, 20 Jan 2007 01:40:31 CST

Swing風イベントモデルを備えたXML不要のフレームワーク

Wicketのビュー部分はプレインなHTMLをテンプレートとして使用し、Javaロジックへの連携にはHTMLタグ内にwicket:id属性を埋め込む事で指定します。そのため作成したHTMLテンプレートをブラウザで直接プリビューする事が可能で、手法としてはTapestry、Teeda Extension、Mayaa等と似ています。

Wicketが特徴的なのは、そのイベントハンドリング方法やコンポーネントの構成方法がSwingに近い手法で実現されていることです。設定にはXMLファイルを使用せず、Javaコード内でコンポーネントを継承した匿名クラスを作成し、必要な部分をオーバーライドするという方法でコンポーネントツリーを組み立てていきます。

また、Servlet/HTTPの動作はWicketフレームワークによって遮蔽されており、Wicketを使用する開発者からはHTTPのリクエストやレスポンス、リクエストパラメタなどをほぼ意識せずに開発できるように工夫されています。

このほか、クラスタ（分散環境）対応や、ボーダー(border)テンプレート対応、戻るボタンのサポート機能など、Webアプリ開発の際に必要になりそうな機能の多くを持っています。

コンテンツ

Wicket開発環境の構築 (Eclipse 3.2+Jetty+JettyLauncher+Maven 2)

WicketとMaven2を使った開発 (Eclipse 3.2+Jetty+JettyLauncher+Maven 2)

Wicket/Maven関連リンク集
WicketとWTPを使った開発 (Eclipse 3.2+WTP 1.5+Tomcat+Maven 2）

WicketとWTPを使った開発

sim_j — Tue, 16 Jan 2007 09:35:48 CST

Eclipse 3.2+WTP 1.5+MavenでWicket開発環境を作成する

ここでは、Wicketの開発環境としてEclipse 3.2+WTP 1.5+Maven2を使った開発の始め方を簡単に解説します。

Eclipse 3.2, WTP 1.5 , Tomcat 5.5, Maven 2の環境はセットアップ済みであることを前提にしています。Eclipse + WTP環境構築の方法は、以下のリンクを参考にしてください。

Eclipse(ClickIDE)環境の構築

Maven2の導入は以下のリンクを参考にしてください。バイナリを任意のディレクトリに展開して（展開先）/binにPATHを通し、環境変数JAVA_HOMEを設定するだけです。

Wicket開発環境の構築

ここでは、E:\work\wicketwtp\以下に開発環境を用意し、EclipseのワークスペースがE:\work\wicketwtp\workspaceにあるものとして説明をします。

EclipseワークスペースにM2_REPO変数を登録

まず、Eclipseでのビルド時にMavenのローカルリポジトリを参照できるようにM2_REPOというクラスパス変数を設定します。設定用のeclipse:add-maven-repoが用意されているので、ワークスペースを-Declipse.workspaceで指定して実行します。

E:\>mvn -Declipse.workspace="E:/work/wicketwtp/workspace" eclipse:add-maven-repo
（実際には一行で入力します）

これでEclipse上のクラスパス変数としてM2_REPOが設定されます。この操作はワークスペース毎に一度だけ実行すれば、再度実行する必要はありません。

プロジェクトディレクトリの作成とpom.xmlの編集

Eclipseワークスペースの下にプロジェクトディレクトリを作成します。ワークスペースに移動して、archetype:createゴールを実行します。

E:\>cd e:\work\wicketwtp\workspace

E:\work\wicketwtp\workspace>mvn archetype:create -DgroupId=com.example -Dversion=0.0.1 -DartifactId=wicketapp1 -DarchetypeArtifactId=maven-archetype-webapp

プロジェクトディレクトリが作成され、その中にpom.xmlが作成されますので、pom.xmlを自分の用件にあうように編集します。
まずwicketへの<dependency>を追加します。－①
また、JDK 1.5でコンパイルするためにmaven-compiler-pluginへ設定追加を行います。－②

maven-archetype-webappで作成したワークスペースはデフォルトではsrc/main/resourcesのみがソースフォルダとして登録されるので、これをsrc/main/javaに変更します。－③

最後に、<resources>を追加して、リソースのフィルタを変更しています。－④
これはWicketの場合、ソースフォルダにHTMLファイルを作成し、それがWARのclasses/にコピーされる必要があるためです。（デフォルトではソースフォルダにあるファイルは、コンパイル後のclassファイルのみコピーされ、HTMLファイルはコピーされない）

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>wicketapp1</artifactId>
<packaging>war</packaging>
<version>0.0.1</version>
<name>wicketapp1 Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency> 
<groupId>wicket</groupId>
<artifactId>wicket</artifactId>
<version>1.2.4</version>
<scope>compile</scope>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/main/java</sourceDirectory> 
<finalName>wicketapp1</finalName>
<plugins> 
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
</plugins>

<resources> 
<resource>
<filtering>false</filtering>
<directory>src/main/java</directory>
<includes>
<include>**</include>
</includes>
<excludes>
<exclude>**/*.java</exclude>
</excludes>
</resource>
</resources>
</build>

</project>

（太字の部分が追記した箇所です。また上記のpom.xmlファイルはここからダウンロード可能です）

プロジェクトをEclipseからインポートできるようにする

プロジェクトディレクトリの用意が出来たので、eclipse:eclipseゴールを使用してEclipseからインポート可能にします。まずプロジェクトディレクトリに移動して、-Dwtpversion=1.5と-DdownloadSources=trueを付けてeclipse:eclipseゴールを実行します。

E:\work\wicketwtp\workspace>cd wicketapp1
E:\work\wicketwtp\workspace\wicketapp>mvn -Dwtpversion=1.5 -DdownloadSources=true eclipse:eclipse
（もしうまく動かない場合は、-DeclipseProjectDir="E:/work/wicketwtp/workspace"でEclipseのワークスペースを指定してみてください）

eclipse:eclipseを実行すると、必要なファイル（wicket本体など）がEclipseプロジェクトから参照可能なようにセットアップされます。必要なファイルがローカルリポジトリに無い場合、自動的にダウンロードされます。また-DdownloadSource=trueを付けていますので、ソースもダウンロードされ、これもEclipseから参照可能なように設定されます。

次に、src\main\javaディレクトリを作成します。（デフォルトではsrc\main\resourcesしか作成されないため）

E:\work\wicketwtp\workspace\wicketapp1>mkdir src\main\java

プロジェクトのインポート

Eclipseを起動し、作成したプロジェクトをインポートします。
メニューのファイル⇒インポートを選択します。

「既存プロジェクトをワークスペースへ」を選択して「次へ」を押します。

「ルート･ディレクトリーの選択」で、作成したワークスペース（E:\work\wicketwtp\workspace\wicketapp1）を指定し、「終了」を押します。インポート後、初回のみダウンロードした"http://java.sun.com/dtd/web-app_2.3.dtd"へのライセンスの同意が求められますので、「同意します」を押します。

先ほど作成したsrc/main/javaフォルダがEclipseのソースフォルダとして登録されているはずです。src/main/resoucesはソースフォルダになっていないので、必要であればソースフォルダとして登録します。src/main/resoucesをパッケージ・エクスプローラー上で右クリックし、「ビルド･パス」⇒「ソース・フォルダーとして使用」を選択すれば登録できます。

プロジェクト全体は右図のようになっているはずです。wicketや、wicketが依存するcommons-logging等がソースコードと共にプロジェクトから参照可能なように設定されています。

アプリケーションの作成

単純に現在時刻を表示するだけのアプリケーションを作成して、動作確認を行います。まず、mvn archetype:createが作成したsrc/main/webapp/index.jspは不要なので削除します。

先にパッケージ名とアプリケーションクラスの名前を決めておく必要があります。ここではパッケージ名をcom.example.wicket、アプリケーションクラスをApplicationとします。

web.xmlファイルを編集して、Wicketのサーブレットクラスとアプリケーションクラスを定義します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>

<display-name>Wicket Application</display-name>

<context-param>
<param-name>configuration</param-name>
<param-value>development</param-value>
</context-param>

<servlet>
<servlet-name>wicketapp</servlet-name>
<servlet-class>wicket.protocol.http.WicketServlet</servlet-class>
<init-param>
<param-name>applicationClassName</param-name>
<param-value>com.example.wicket.Application</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>wicketapp</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>

</web-app>

（上記のweb.xmlファイルはここからダウンロード可能です）

あとは決めたパッケージ以下にクラスやHTMLテンプレートを作成していくだけです。HTMLテンプレートは対応するクラスと同じパッケージ（ディレクトリ）に作成する必要があります。src/main/webapp以下に作成しても動作しないので注意が必要です。
ここでは以下のように作成しました。

Application.java　（ダウンロード）
======================================================================
package com.example.wicket;

import wicket.protocol.http.WebApplication;

public class Application extends WebApplication {

@Override
public Class getHomePage() {
return Home.class;
}

}
======================================================================

Home.java　（ダウンロード）

======================================================================

package com.example.wicket;

import java.util.Date;

import wicket.markup.html.WebPage;
import wicket.markup.html.basic.Label;

public class Home extends WebPage {

private static final long serialVersionUID = 1L;

public Home() {
add(new Label("time",new Date().toString()));
}

}
======================================================================

Home.html　（ダウンロード）
======================================================================
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Current Time</title>
</head>
<body>
現在の日時は<span wicket:id="time">00:00:00</span>です。
</body>
</html>
======================================================================

WTPの機能を使ってTomcat上で起動する

WTPに登録してあるTomcat上で作成したアプリケーションを起動します。サーバビューを表示し、Tomcatを右クリック⇒「プロジェクトの追加および除去」を選択し、作成したwicketapp1を登録します。

登録できたら、サーバービューのデバッグボタン、もしくは実行ボタンを押しTomcatを起動します。起動後ブラウザからhttp://localhost:8080/プロジェクト名にアクセスする事でアプリケーションを実行します。

実行すると以下のように現在の時刻が表示されます。リロードすると時間が更新されるのが確認できます。

開発中は基本的にTomcatを立ち上げっぱなしで問題ありません。HTML,クラスの変更はTomcatのリスタート無しで動的に反映されます。

補足

ロギングについて

上記の方法ではロギングの設定がされていないので、情報がほとんどコンソールに出力されません。src/main/java以下にcommons-logging.propertiesとlog4j.propertiesを置く事でログが出力されるようになります。

commons-logging.propertiesには

org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger

とだけ書いてlog4jにロギングを任せます。

log4j.propertiesには、最低限以下のような設定が必要です。

log4j.rootLogger=DEBUG,Stdout
log4j.appender.Stdout=org.apache.log4j.ConsoleAppender
log4j.appender.Stdout.layout=org.apache.log4j.PatternLayout

log4j.logger.org=INFO
log4j.logger.wicket=INFO

warの作成

WTPの機能としてwarファイル作成機能があるので、それを使うと簡単にwarファイルが作成できます。プロジェクトを右クリック⇒エクスポートからwarを選択する事でwarが作成できます。
また、Mavenを使って、コマンドラインからmvn packageを実行することでもwarが作成できます。この場合は\target\ディレクトリ以下にwarファイルが作成されます。

WTPのHTMLエディタでwicket:idへの警告が出る場合

WTPのHTMLエディタを使ってWicketのHTMLテンプレートを作成していると、「属性名 (wicket:id) が未定義です。」という警告が出る場合があります。そのままにしておいても特に問題はありませんが、警告を消したい場合はwicketというネームスペースを適当に定義する事で警告を回避できます。（これが正しい方法ではないと思うのですが、他に良い方法が分からないのでこうしています）

WTPでHTMLファイルを作成する場合は、XHTMLのテンプレートに以下のネームスペースを追加したテンプレートを登録しておくと便利だと思います。

例）
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:wicket="http://wicket.sourceforge.net/ ">

Tapestry

sim_j — Sat, 13 Jan 2007 02:08:54 CST

進化を続けるWEBアプリケーションフレームワークの雄

コンテンツ

Home

sim_j — Mon, 08 Jan 2007 07:13:11 CST

数あるWEBアプリケーション用フレームワークの中で、特にビュー(VIEW)層の部分に工夫があるフレームワークについての覚書を書くWikiです。

とはいえ、最近のフレームワークは(MVCで言う）ビューだけというよりはコントローラーやモデルを含めた形で利用者に便宜を図るものが多いですし、もっと言えばMVC形式では無いものも出てきています。そのためビューに特徴があるというのはやや正確さを欠いた表現です。

TapestryやTeeda Extensionは、ピュアなHTMLファイルによるプリビュー性の高いビュー環境＋Servletに関する知識をあまり要求しない仕様が魅力的ですし、Clickによるプリビュー性など無視したような*.htmの中が$formだけ、のような割り切った方法も非常に魅力的です。

興味があるWEBアプリケーションフレームワーク

Tapestry5

sim_j — Fri, 05 Jan 2007 18:21:13 CST

Tapestry 5

Tapestry 5は現在（2007年1月)開発中のプロダクトで、まだリリースされていません。

Tapestry 4⇒5への変化は、これまでの3⇒4以上に極めて大きいものになる予定です。一番大きい変化はTapestryのコンポーネントがPOJOベースになってXMLファイル(*.page)が不要になる事ですが、それ以外にも色々と変化しています。

Tapestry 5の新機能・変更点

このページやその他の情報から、Tapestry 5の新機能・変更点を書き出すと

コンポーネント作成時にTapestryのクラスを継承しなくて良い
コンポーネントはAbstructクラスでない（POJOになる）
XMLファイル（*.page)が無くなり、Javaコード上のアノテーションで指定するように
jwcidは無くなり、代わりに、Tapestry用のネームスペースと新しいタグ、アトリビュートが用意された
新しいIoCコンテナ(DIコンテナ)
アプリケーションサーバを起動したままで、動的にHTMLテンプレート、Javaコードの変更が反映される（live class reloading機能)
高速化
HTMLテンプレートがWEBアプリケーションルートにも置けるように（以前はCLASSPATH上に置く必要があった）

具体的な内容は上記リンクや、このエントリ、スクリーンキャスト(動画デモ)などを見ると分かりやすいと思います。

Teeda Extension

sim_j — Thu, 28 Dec 2006 10:12:28 CST

規約重視の「さくさく」WEBアプリケーション開発フレームワーク

TeedaはSeasarプロジェクトで開発されているJSF実装の1つです。他のJSF実装と違いできるだけステートを持たないように（ステートレス）に作られているらしく、技術的に非常に興味深いのですが、このWikiではTeeda Extensionについての情報を書きたいと思っています。

Teeda EntensionはTeedaをコアに、HTMLテンプレートのビューを使用するようにしたJSF拡張のアプリケーションフレームワークです。「ページ駆動」とよばれる、HTMLのページとそれに対応するPOJOクラスによってWEBアプリケーションが作成可能になっています。

注目すべきは、idアトリビュートを指定するだけのプリビュー性の高いHTMLテンプレートと、徹底された規約重視設計による設定記述量の削減です。既約は細かく決まっていますがあまり不自由は感じません。規約（ルール）によって名前が決まる事が迷いをなくしてくれるので、クラス名の付け方などといった瑣末な事に悩まずに作成が進められる上に、設定ファイルの作成も不要のためテンポ良くアプリケーションが作成できます。

コンテンツ

Teeda関連リンク集

sim_j — Thu, 28 Dec 2006 08:51:29 CST

Teeda/Saesar関連のリンク集

Teeda

Teedaホームページです。ファイルのダウンロードなど。

Teeda/gettingStarted

Teeda Extensionによるアプリ開発の情報がまとまっています。

おおたに6号機の日々

Teedaの開発者、大谷さんのブログです。

設計と実装の狭間で。

Teeda Extensionアプリケーション開発に便利なプラグイン「Dolteng」の作者、佐藤さんのブログです。

Seasar

Seasarプロジェクトのホームページです。

NetBeansを使った開発

sim_j — Mon, 25 Dec 2006 10:11:05 CST

Clickを開発する場合は、Eclipse+ClickIDEがお勧めなのですが、NetBeans IDEでも快適に開発可能です。

NetBeans用にはまだプラグインなどの補助ツールは用意されていないため（作成の予定はあるようです）、通常のWEBアプリケーションとしてClickのアプリケーションを開発していく事になります。

ただNetBeansのWEBアプリケーション作成機能は非常に優れていますし、導入もアドオンやTomcatの別途導入が必要ない分、非常に簡単です。

ここではNetBeans 5.5 (日本語版)でClickフレームワークを使用したアプリケーションを開発する方法を、簡単に紹介します。

ダウンロードするファイル

NetBeansの場合、本体にTomcat等も含まれるので、本体とClickフレームワークだけで全てがそろいます。

	ダウンロード先	ファイル
NetBeans 5.5 (日本語版)	ja: Netbeans 日本語サイト	netbeans-5_5-windows-ja.exe
Clickフレームワーク	SourceForge	click-1.1.zip

開発方法

最初にNetBeans IDEをインストールし、次に適当なディレクトリ(例 E:\localなど)にclick*.zipを展開しておきます。

次にワークスペースとなるディレクトリを決め(例 E:\local\netbeans_workspace\など）、そこにclick*.zipを展開して出来たフォルダ内にあるquickstartフォルダを、ワークスペースにコピーし、自分が作成したいプロジェクトの名前にリネームします。click*.zipに含まれるquickstartフォルダはclickフレームワークのアプリケーションの雛形になっています。この例ではhelloという名前にリネームします。

ワークスペースフォルダを用意したらNetBeansを起動します。起動したら、メニューからファイル⇒新規プロジェクトを選択し、表示されたダイアログでは、カテゴリ「Web」の「既存のソースを使用する Web アプリケーション」プロジェクトを選択します。

場所に先ほど用意したhelloフォルダを指定します。その他はデフォルトのままで問題ないケースが多いでしょう。アプリケーションサーバにはバンドルされているTomcat 5.5.17を使用します。その他、好みに設定したら「次へ」をクリックします。

NetBeansは基本的にタスクが全てAntベースで作成されるので、Ant構築スクリプトが必要です。clickのquickstartフォルダにはAntビルド用のbuild.xmlが含まれていて、名前がバッティングするので、以下のようなダイアログが表示され、別の名前を使用する必要があります。ここではデフォルトで指定されているnbbuild.xmlのままで「了解」を押します。

最後のステップでWebページフォルダ（webapp以下)とソースパッケージフォルダ(src以下)が正しく設定されている事を確認して、「完了」を押します。

プロジェクトが作成されるので、clickのライブラリを登録します。プロジェクトのライブラリフォルダを右クリック⇒「Jar/フォルダを追加」で別の場所に展開していいるclick*.zipのdistフォルダ含まれるclick-1.1.jarとclick-extras-1.1.jarを追加します。

次にclick.xmlをダブルクリックで開き最低限の設定として、以下のように<click-app>に文字コードの設定を入れます。

<click-app charset="Shift_JIS">

これだけの設定で、すでに実行できるようになっています。

実行と開発の継続

実行するには、メニューの「実行」⇒「主プロジェクトを実行」（もしくはデバッグ）をクリックするか、ショートカットのF6キーを押します。すると、Tomcatが起動し、アプリケーションがデプロイされ、ブラウザが起動され、アプリケーションのトップURLを開きます。

これで動作する事が確認できましたので、あとは自分のアプリケーションを開発していくだけです。click.xmlファイルを修正し、不要なパッケージ、クラスを削除して開発を開始してください。

Eclipse+WTPの時と同じように、NetBeans環境でも一度立ち上げたTomcatを再起動する必要はほとんどありません。

HTMLファイルを修正した場合はTomcatを立ち上げっぱなしでも即時に反映されます。Javaのコードを修正した場合は再度F6を押すと（Tomcatを起動した状態でF6を押します）、変化したところだけ増分配備（差分をデプロイ）され、Tomcatの再起動無しに新しい内容が反映されます。

デバッグ実行中でもF5（デバッグ）やF6(実行）を押すことで、増分配備が行われます。

何かを修正して、動作を確認したければF6を押すだけという、この差分配備機能のおかげで非常に楽に開発する事ができます。

補足事項

NetBeansでの文字コード設定

上記の例では、Clickの設定でエンコードをSHIFT_JISにしています。NetBeansでのHTMLファイルなどのデフォルトエンコードは、OSの設定に依存しますので、Windows環境ではShift JISになり、これでShift JISで統一できています。

最初はEclipse+ClickIDEの時のように、HTMLのエンコードやClickの設定をUTF-8に統一するという方法で設定するつもりだったのですが、少し調べたところNetBeansでは

HTMLファイルでOSの設定以外の文字コードを指定するには明示的にファイル内に <meta http-equiv="content-type" content="text/html; charset=UTF-8">を書かないといけない
OSの設定以外の文字コードでコンパイルするにはIDE側のグローバルな設定を変更する必要がある。これは他のプロジェクトにも影響する

という2つの理由により、ちょっとUTF-8で統一するのは面倒なので、Shift JISにしています。
NetBeansでの文字コード設定については以下の記事が詳しいです。

Java ソースコードで UTF-8 エンコーディングを使う

Eclipse(ClickIDE)を使った開発

sim_j — Sun, 24 Dec 2006 19:52:13 CST

（このページの内容は、Eclipse(ClickIDE)環境の構築の続きです）

ここでは、Eclipse + ClickIDEを使った開発の始め方を説明します。Clickアプリケーションの作成方法ではなく、ClickIDEとWTPの使い方の最初の一歩を説明します。

Eclipseのパースペクティブ設定

Eclipseを使った開発方法は人それぞれで、色々な方法がありますが、ここではJavaパースペクティブを使用して開発を行います。（Java EEパースぺクティブではなく）

まず現在のパースペクティブがJavaになっている事を確認します。なっていない場合はメニューのウィンドウ⇒パースペクティブを開く⇒Javaを選択してパースペクティブをJavaに変更します。

その状態でウィンドウ⇒パースペクティブのカスタマイズを選択します。

まず「ショートカット」タブで、サブメニューに「新規」を選び、ショートカット・カテゴリーから「Click」にチェックを入れます。

「コマンド」タブに切り替え、使用可能なコマンド・グループから「Click Action Set」にチェックを入れ、OKを押します。

Eclipse+ClickIDEによる開発

ここではClickIDEを使った、基本的な開発の方法について説明します。

何も題材が無いと始められないので、ここでは単純に現在時刻を画面に表示するだけの「hello」プロジェクトを作成する事にします。(このhelloのソースコードの内容は、clickホームページのIntroductionの内容を、ほぼそのまま使っています）

プロジェクトの作成

まず、Eclipseを起動して、新規にプロジェクトを作成します。プロジェクトのタイプは「動的WEBプロジェクト」で作成します。

メニューのファイル⇒新規⇒プロジェクトで、「動的WEBプロジェクト」を選択し、次へを押します。

プロジェクト名はhelloにし、ターゲットランタイムには事前に登録したTomcat 5.5を指定し、次へをクリックします。

プロジェクトのファセットとしてClickにチェックを入れ、次へを押します。

最後はディレクトリの指定です。今回はデフォルトのままで終了を押します。

初回のみ、インターネット経由でXMLスキーマファイルのダウンロードが行われますので、「同意します」をクリックします。2回目以降はキャッシュ済みのものが使用されるので、ダウンロードは行われません。

ダウンロードが完了すると、J2EEパースペクティブへの変更ダイアログが出ますが、今回はJavaパースペクティブで実行するので、「いいえ」をクリックします。

このようにhelloプロジェクトが作成されます。TomcatやClickフレームワーク(click*jar)はすでに登録され、Clickの動作に必要なclick.xmlも用意されています。またweb.xmlファイルにも最低限必要な設定が作成されています。

HTMLテンプレートとページクラスの作成

Clickでは、HTMLで書かれたテンプレートとJavaクラス（ページクラス）を対で作成します。HTMLでビューを作成し、それに対応したページクラスでロジックを定義します。HTML内にはVelocityを使う事で動的に変化する内容を組みこむ事が可能です。

ＨＴＭＬテンプレートとページクラスの組み合わせは、以下のどちらかの方法で設定します。

click.xmlファイルに<page>タグで組み合わせを定義する
自動マッピング(auto mapping)機能を使用する

1.だとページ毎にclick.xmlに設定を追加しなければいけません。ClickIDEのおかげで非常に簡単に設定が追加できますが、ページが多くなってくると管理も大変になりますので2.の自動マッピングを使う方がお勧めです。

自動マッピングは、ページクラスを置くパッケージ名を設定する事で、HTMLへのパス(HTMLのファイル名)から対応するページクラスが自動的に決定される仕組みの事です。

たとえばページクラスを作成するパッケージをtest.pageとして、自動マッピングをONにした場合、以下のように対応するクラスが自動的に決定します。

（例）

URL	クラス
/hello.htm	test.page.Hello
/list-data.htm	test.page.ListData
/admin/control_page.htm	test.page.admin.ControlPage

自動マッピングと、click.xmlでの手動定義は組み合わせて使えますので、基本は自動マッピング機能を使用し、自動マッピングのルールで対応できない場合のみclick.xmlファイルに定義を追加するようにすると良いでしょう。

今回は、アプリケーション用のパッケージはhelloとし、hello.page以下にページクラスを作成するようにします。

click.xmlで自動マッピングを有効にします。パッケージエクスプローラー上のclick.xmlをダブルクリックするとClickIDEのClick設定エディタによってclick.xmlが開かれます。

全体タブで、文字コードがUTF-8になっている事を確認してください。また「ログの出力先」をconsoleに設定します。動作モードは開発中はdevelopmentかdebugで良いでしょう。モードの違いはここ（原文ではここ）のモードの欄に解説されています。

次にページタブで自動マッピングを設定します。click-appと書かれているところで右クリックをし、pages要素を作成します。pages要素の詳細にパッケージという欄があるのでそこにhello.pageと入力し、自動マッピングをtrueに設定します。

CTRL-sでセーブした後にclick.xmlを閉じます。

HTMLファイルと、Javaページクラスのペアを作成する

時刻を表示するdisplay-time.htmと対応するページクラスを作成します。プロジェクトを右クリックして新規⇒Clickページを選択します。

設定ダイアログでファイル名にdisplay-time.htmと入力します。するとClickIDEによって自動的に適切なJavaクラス名が設定されます。ソースフォルダなどは自動的に適切な値が設定されています。また一番下にある「click.xmlにマッピングを追加する」からチェックを外します。今回は自動マッピング機能が有効なのでclick.xmlにマッピングを追加する必要が無いためです。また、今回のweb.xmlの設定が*.htmをClickサーブレットにマッピングするようになっているのでHTMLファイルの拡張子を*.htmにします。

終了を押すと、HTMLテンプレートファイルとそのペアになるJavaソースファイルが作成されます。まずJavaソースコードにロジックを実装します。とはいっても単純にjava.util.Dateオブジェクトをpublicフィールドに定義してnewするだけです。今回はtimeという変数を定義します。

次に、HTMLファイルを編集します。display-time.htmファイルを開くとClickIDE内臓のclickテンプレートエディタでHTMLファイルが開かれています。HTMLのヘッダ部分には$importと書かれていますが、これは必要なCSSの参照等が入るのでそのままで問題ありません。

<body>タグ内にコンテンツを書きますが、今回は時刻を表示するだけですので

今の時刻は$timeです。

と書くだけです。$timeの部分がVelocityテンプレートで、対になっているJavaページクラスのtimeというプロパティを参照しています（今回はpublicフィールドのtimeを参照）。HTML内参照されたオブジェクトは単純にtoStringメソッドが呼び出され、その結果で$timeの部分を置き換えます。

HTMLを編集する際には、$と書いてからSHIFT+スペースを押すとClickIDEによって変数名が自動的に補完されます。これによってタイプミスによるエラーを防ぐ事ができ、開発効率が向上します。

HTMLとJavaソースコードが書けたらセーブします。これでコーディングは完了です。

Tomcatへプロジェクトを登録する

作成したhelloアプリケーションをTomcat上で実行します。まずWTPのサーバービューを表示します。メニューのウィンドウ⇒ビューの表示でダイアログを表示し、その中のサーバー⇒サーバーを選択します。

下部に空のサーバービューが表示されますので、右クリック⇒新規⇒サーバーを選択します。

新規サーバーダイアログの下部にあるサーバー・ランタイムのところが登録済みのApache Tomcat 5.5になっている事を確認して「次へ」を押します。

次にプロジェクトをTomcatに登録します。helloプロジェクトを選択して、「追加」を押し、「終了」を押します。

正しく登録されると以下のようになります。

Tomcatの設定を確認する

サーバービューのTomcat v5.5 サーバーをダブルクリックするとWTP上のTomcat 5.5の設定が表示されます。基本的にデフォルトのままで何も変更する必要は無いのですが、内容を確認しておきます。

まず概説タブでは「自動公開」の部分を確認します。以下のようにデフォルトを上書きして1秒で公開されるようになっているはずです。

次にモジュールタブに切り替えると、登録したプロジェクト（モジュール）がどのコンテキストパスで公開されるかと自動再ロードが有効かどうかが確認できます。特に自動再ロードはTomcatを再起動せずにclassファイルを読み直せるようにする設定ですので、開発中は使用可能になっている方が便利です。内容が確認できたら閉じます。

Tomcatを起動し、アプリケーションの動作を確認する

Tomcatはサーバービューから右クリック⇒始動でサーバが起動します。サーバビューに「始動済み」と表示されたら、以下のボタンでブラウザを起動して(もしくは別のブラウザでもOKです）、

（Eclipse内でブラウザを起動するボタン)

http://localhost:8080/hello/display-time.htm

にアクセスします。現在の時刻が表示されたら正しく動作しています。ブラウザをリロードすると時刻が更新される事を確認してください。

設定で確認したように、WTPでTomcatを起動した場合は基本的にTomcatを停止したり、リブートする必要はありません。Tomcatを起動したままでも*.htmファイルを修正すれば、ほぼ即時に反映されますし、Javaのソースコードを修正した場合でもビルド（ソースコードのセーブと同時に行われます）された数秒後にはTomcat側に反映されます。コンソールに以下のメッセージが出た場合は、新しいJavaクラスが反映されています。

情報: このコンテキストの再ロードを開始しました
[Click] [info ] initialized in development mode

ただし、開発の初期でまだほとんど出来ていない場合や、開発が進んだ時でも全てのファイルをリビルドする際などは一時的にTomcatを停止した方が良いでしょう。

以上でEclipse+ClickIDEで開発を始められると思います、リンク先にあるクイックスタートやベスト・プラクティスなどを読んでClickの学習を進めてください。

その他、補足情報

他のライブラリを追加するには

プロジェクト内で使用する他のライブラリなどをWTPの動的WEBプロジェクトに追加するには、パッケージエクスプローラーのWEB-INF/lib以下に追加したいライブラリ(jar)ファイルをエクスプローラーからドラッグ＆ドロップします。すると「Web App ライブラリー」に自動的に移動し、ビルドパスに登録され、かつデプロイ時に含まれるようになります。

<body>タグが無い場合にHTMLの補完をするには

ClickIDEに付属しているClickテンプレートエディタは非常に高機能でVelocityの変数だけでなく、HTMLの要素もSHIFT+スペースで補完できます。

しかし<body>タグ内でないと、ほとんどの要素が補完できません。これはHTMLエディタとして正しいのですが、Clickの場合、ボーダーテンプレートを使用するようになると、継承した先では<html>や<body>を書かずにコアとなるコンテンツのみ書くようになるので、そのままでは補完機能が使えません。

私の場合は*.htmファイルで（テンプレートを使っている場合は）、

## <body>
ここに内容
##</body>

と最初と最後にVelocityのコメントでダミーの<body>タグを書く事で補完機能を有効にしています。