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

生徒

「先生、JakartaEEのJSPファイルってどういう構造になっているんですか？」

先生

「JSPファイルには大きく分けてディレクティブとスクリプトレットという要素があり、それぞれ役割が異なります。」

生徒

「ディレクティブとスクリプトレットって聞いたことはあるんですが、実際には何をするものなんですか？」

先生

「それでは、JSPファイルの基本構造をわかりやすく説明していきましょう。」

1. JSPファイルの基本構造とは？

JakartaEEのJSPファイルは、通常のHTMLファイルにサーバーサイドの処理を追加できる仕組みを持っています。JSPの拡張子は.jspで、サーバーに配置すると自動的にサーブレットへ変換されます。JSPはHTMLコードとJavaコードを混在させることができるため、画面表示とロジックを簡単に組み合わせられるのが特徴です。

基本的なJSPファイルの中には、HTML部分に加えて、ディレクティブやスクリプトレットが含まれます。これらを理解することが、JSPを正しく扱う第一歩となります。

2. ディレクティブ（Directive）とは？

ディレクティブは、JSP全体の設定を指定するための仕組みです。ページ全体に影響を与えるもので、コンパイル時にJSPコンテナへ指示を出します。最も代表的なのは<%@ page %>ディレクティブです。

例えば、文字コードやインポートするクラスを設定する場合に使います。


<%@ page contentType="text/html; charset=UTF-8" language="java" %>
<%@ page import="java.util.Date" %>

このように書くことで、文字コードをUTF-8に設定したり、JavaのDateクラスを利用できるようにしたりできます。JSPを使ったWebアプリケーションでは、ページディレクティブを必ず目にすることになるでしょう。

3. スクリプトレット（Scriptlet）とは？

スクリプトレットは、JSPの中で直接Javaコードを書ける仕組みです。書き方は<% ... %>の中にJavaコードを記述します。例えば現在の日付を表示するコードは次のようになります。


<html>
<head><title>スクリプトレットの例</title></head>
<body>
    <h1>今日の日付</h1>
    <%
        java.util.Date now = new java.util.Date();
        out.println("現在の日時は: " + now);
    %>
</body>
</html>

このようにスクリプトレットを使うと、Javaコードで処理した結果を直接ページに出力できます。ただし、スクリプトレットを多用するとHTMLとJavaが混ざりすぎて読みづらくなるため、基本的な使い方だけを覚えておきましょう。

4. 宣言（Declaration）との違い

JSPではスクリプトレットに似た書き方で宣言を行うこともできます。宣言は<%! ... %>を使い、クラスレベルで変数やメソッドを定義します。


<%! 
    private int count = 0;
    public String message() {
        return "アクセス数: " + (++count);
    }
%>
<html>
<body>
    <p><%= message() %></p>
</body>
</html>

このように宣言を使えば、JSP内にメソッドを定義して再利用することもできます。ただし、構造が複雑になるため、初心者はまずスクリプトレットとディレクティブを優先的に理解すると良いでしょう。