VelocityServlet は Velocity のサブプロジェクトです[訳注: この記述はVelocityToolsができる前の古い記述です]。 ウェブアプリケーションでテンプレートをレンダリングできるスタンドアロンの Velocity サーブレットを作成することが目的です。

このサブプロジェクトの対象は、サーブレットベースのウェブアプリケーションフレームワークのビューレイヤテクノロジとして Velocity を使用しようとするウェブアプリケーション開発者です。 VelocityServlet は以下の主な機能を提供します:

• VelocityViewServlet は Velocity のテンプレートをレンダリングするスタンドアロンの Java サーブレットを提供します。 クラスの名前は org.apache.velocity.tools.view.servlet.VelocityViewServlet です。 これはウェブクライアントから直接、または他のサーブレットからリクエストがフォワードされたときに、テンプレートのレンダリングのために呼び出されます。 使い方は JSP をレンダリングする JSPServlet によく似ています。
• VelocityViewServlet は ServletRequest の属性、 HttpSession の属性、 ServletContext の属性を Velocity コンテキストを通して、自動的にテンプレートデザイナに提供します。 明示的に Velocity コンテキストを設定する必要はありません。
• VelocityViewServlet はツールボックスをサポートしています。 ツールボックスには、 Velocity コンテキストを通して、自動的にテンプレートデザイナに提供されるビューツール (ビューのヘルパー) のセットを定義することができます。
• Velocity のログ出力はウェブアプリケーションのログ機構へリダイレクトすることが可能です。 デフォルトでは、ログはサーブレット API で提供されているログ機能へ出力されます。

VelocityViewServlet を使用し、特定のビューテクノロジに依存しないウェブアプリケーションを作成することが可能になります。 JSP から Velocity テンプレートへ、ウェブアプリケーションのビューレイヤテクノロジのストレートな移行を可能にします。

VelocityViewServlet を適用する典型的なケースとしては、サーブレットベースウェブのウェブアプリケーションフレームワークを併用することです。 VelocityStruts は Velocity を Struts の世界へ統合する Velocity のサブプロジェクトであり、 VelocityViewServlet の利点を享受することのできる最初のアプリケーションです。

追加予定

• 例
• サーブレットの設定
• ツールボックスの設定
• Javadoc