先生と生徒の会話形式で理解しよう

生徒

「先生、Jakarta サーブレットとJakarta Faces(JSF)って両方ともJakarta EEで使われる仕組みだと思うんですが、一緒に使うとどんな利点があるんですか？」

先生

「いい質問だね。Jakarta サーブレットはリクエスト処理やデータ管理を担当して、Jakarta Faces(JSF)はUIコンポーネントを使った画面構築を担当するんだ。統合することでビジネスロジックと画面をスムーズに連携できるんだよ。」

生徒

「なるほど！サーブレットでデータを処理して、その結果をJSFに渡してUIに反映させる流れですね。」

先生

「その通り。ではJakarta サーブレットとJakarta Faces(JSF)の統合方法や具体的な利用例を見ていこう。」

1. Jakarta サーブレットとJakarta Faces(JSF)の役割

Jakarta サーブレットは、Webアプリケーションにおけるリクエスト処理の基盤です。フォーム送信やURLアクセスなどのHTTPリクエストを受け取り、必要な処理を実行します。一方でJakarta Faces(JSF)はコンポーネント指向のフレームワークであり、UIを構築するための仕組みを提供します。両者を組み合わせることで、サーブレットがデータ処理を行い、その結果をJSFのUIコンポーネントにバインドすることが可能になります。

2. Jakarta サーブレットとJSFの統合の基本構成

Jakarta EE環境では、サーブレットとJSFは統合的に動作します。通常、faces-servletと呼ばれるJSF専用のサーブレットがリクエストを受け取り、バックエンドで処理を行います。また、必要に応じて独自のJakarta サーブレットを用意し、JSFにデータを渡すことも可能です。このようにして、ビジネスロジックとUIを分離しながら統合的に管理できます。

3. web.xmlでのサーブレットとJSFの統合設定

Jakarta サーブレットとJSFを統合するためには、web.xmlにFacesServletの設定を記述します。これにより、特定のURLパターンをJSFが処理できるようになります。


<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee" version="10">
    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>*.xhtml</url-pattern>
    </servlet-mapping>
</web-app>

4. Jakarta サーブレットからJSFへのデータ連携

サーブレットで処理したデータをJSFに渡すには、リクエストスコープやセッションスコープにデータを保存し、JSFのEL式で参照します。以下のサンプルでは、サーブレットでユーザー名を設定し、JSFページで表示します。


@WebServlet("/user")
public class UserServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws IOException, ServletException {
        request.setAttribute("username", "花子");
        request.getRequestDispatcher("/user.xhtml").forward(request, response);
    }
}


<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://xmlns.jcp.org/jsf/html">
<h:head>
    <title>ユーザーページ</title>
</h:head>
<h:body>
    <h1>ようこそ、#{requestScope.username}さん！</h1>
</h:body>
</html>

5. Jakarta Faces(JSF)マネージドBeanとの連携

Jakarta サーブレットはリクエスト処理の中心ですが、より高度な連携を行う場合はJSFのマネージドBeanを利用します。マネージドBeanは@Namedや@SessionScopedといったアノテーションで定義され、UIコンポーネントから直接アクセスできます。サーブレットで処理したデータをBeanに保存することで、JSFページで自然に利用できます。


import jakarta.enterprise.context.SessionScoped;
import jakarta.inject.Named;
import java.io.Serializable;

@Named
@SessionScoped
public class UserBean implements Serializable {
    private String name;

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
}