Struts2を学び始めると、まず最初に戸惑うのが「いつのまにか値が入っている」現象ではないでしょうか？
-
setSession()が呼ばれてないのにsessionが使える… -
userIdプロパティにHTMLフォームの値が勝手に入ってる… - どこで何が実行されてるのか分からない…
今回はこの“Struts2の魔法のような機能”の正体を暴きつつ、Struts2の基本思想（ステートレス設計）と自動注入の仕組みについて、図解なしでも理解できるように丁寧に解説していきます。
🧭 本シリーズについて：Struts2「機能説明編」スタート！
このブログシリーズでは、Struts2で掲示板アプリケーションを構築していく過程を記録していますが、それに先立って、Struts2が持つ便利な機能や基本動作を体系的にまとめる「Struts2機能説明編」をスタートしました！
- Vol.11.0：【保存版】Struts2が提供してくれる便利機能まとめ9選（MVC/自動バインディング/OGNLなど）
- Vol.11.1：← 今回この記事（自動注入とステートレスAction）
この「機能説明編」では、Struts2の仕組みや挙動を一つひとつ分解して、初心者でも理解しやすいようにまとめていきます！
🧩 ステートレスActionって何？
Struts2では、リクエストごとに 毎回新しいActionインスタンスが生成されます。
つまり、Actionクラスは「ステートレス」な設計になっています。
📌 ステートレス（Stateless）とは？
| 特徴 | 説明 |
|---|---|
| 状態を保持しない | 前のリクエストの値を持ち越さない |
| 毎回クリーンなインスタンスで実行される | 前のプロパティ値や処理状態は引き継がれない |
| マルチスレッドでも安全 | 共有状態がないのでスレッドセーフ |
⚙️ 「自動注入」って何が行われてるの？
Struts2のActionクラスは、次のような仕組みで「値が勝手に設定される」ようになっています。
✅ 例：SessionAwareを実装するだけでセッションが使える！
public class SampleAction implements SessionAware {
private Map<String, Object> session;
@Override
public void setSession(Map<String, Object> session) {
this.session = session;
}
}
🤔 でも…setSession()ってどこで呼ばれてるの？
実は、これは Interceptor（インターセプター） による「自動注入」の仕業です！
🛠 Interceptorの仕組み
Struts2のリクエスト処理の大まかな流れは次の通り：
リクエスト受信 → Actionインスタンス生成 → Interceptor群の処理 → execute() 実行 → 結果ビューへ
Interceptorの役割（一部抜粋）
| Interceptor名 | 機能 |
|---|---|
params |
リクエストパラメータ → プロパティへの自動バインディング |
servlet-config |
ServletRequestAware などのセット |
session |
SessionAware インタフェースに基づいてセッション注入 |
validation |
入力チェック処理 |
workflow |
エラー処理フロー制御 |
token |
重複送信防止 |
つまり、Actionクラスの前処理をInterceptorが一手に引き受けてくれているのです。
🧱 BaseActionで共通処理を集約
Struts2では、Actionクラスごとに同じような処理を書かないように、共通処理を BaseAction(基定クラス) にまとめるのが定石です。
例：BaseAction.java
public class BaseAction extends ActionSupport
implements SessionAware, ServletRequestAware {
protected Map<String, Object> session;
protected HttpServletRequest request;
@Override
public void setSession(Map<String, Object> session) {
this.session = session;
}
@Override
public void setServletRequest(HttpServletRequest request) {
this.request = request;
}
}
これを継承するだけで、どのActionでもセッションやリクエストが自動注入されます。
🎯 まとめ：Struts2の“魔法”をちゃんと理解しよう！
| 理解のポイント | 内容 |
|---|---|
| Actionはステートレス | 毎回クリーンな状態で生成される |
| 自動注入はInterceptorの仕組み | セッションやリクエスト、パラメータなどを自動でセットしてくれる |
| BaseActionで効率化 | 継承によって共通処理を一元化できる |
🧭 関連記事（Vol.11.xxxシリーズ）
| 連番 | タイトル | 内容分類 |
|---|---|---|
| Vol.11.0 | Struts2が提供してくれる便利機能まとめ9選 | 導入＆概要 |
| Vol.11.2 | UX改善に効く！アクション層設計と入力制御の極意（プロローグ） | UX設計・アクション層総論 |
| Vol.11.2.1 | 【実践編】Struts2アクション層の役割と設計パターン（Command型 / UIアクション分離など） | アクション設計パターン |
| Vol.11.2.2 | 【UX重視】戻るボタン・キャンセル処理の設計手法と「戻り先管理」のスマート実装 | 戻り先制御とUX設計 |
| Vol.11.2.3 | 【設計ノウハウ】多画面遷移時のパラメータ受け渡し・保持戦略（セッション vs hidden vs URL） | パラメータ多重管理 |
| Vol.11.2.4 | 【実践ガイド】ユーザー操作を考慮したアクション遷移設計（リダイレクト vs フォワードの使い分け） | UX遷移設計／Result制御 |
| Vol.11.2.5 | 【トラブル防止】アクション層の共通処理とメンテナブルなBaseAction設計 | アクション共通化／保守性 |
| Vol.11.3 | Struts2の defaultStack とは？Interceptorの中身を詳しく追ってみる | Interceptor |
| Vol.11.3.2 | 🔧 Vol.11.3.2 独自Interceptorの作り方と使い所 Struts2のカスタマイズを“実践で使えるレベル”に一歩進めよう | Interceptor |
| Vol.11.4 | 入門者のための「パラメータ自動バインディング」完全理解ガイド | 自動バインディング |
| Vol.Vol.11.4.1 | 入門者のための自動バインディング実践パターン集 | 自動バインディング |
| Vol.11.5 | Struts2の構成理解が“実務レベル”へと進化する決定版 | 設定ファイル構造 |
| Vol.11.5.1 | Struts2の“画面遷移の全体像”を理解するためのマイルストーン記事 | 設定ファイル構造 |
| Vol.11.6 | ActionSupport の便利メソッドと国際化対応 | ユーティリティ / i18n |
| Vol.11.7 | validate() / input 戦略とUX設計 | 開発スタイルの違い |
| Vol.11.8 | アノテーションベースの設定 vs XML定義の比較 | 開発スタイルの違い |
| Vol.11.9 | バリデーション完全解説（XML / アノテーション） | バリデーション（※Vol.8補完） |
| Vol.11.10 | Struts2の「OGNL」ってなに？しくみと使い方をやさしく解説 | 式言語OGNL解説 |
| Vol.11.11 | ModelDriven インターフェースの使いどころと注意点 | Model駆動開発 |
| Vol.11.12 | SessionAware と RequestAware でセッション/リクエスト管理 | セッション管理 |
| Vol.11.13 | Resultタイプ完全解説（dispatcher / redirect / stream など） | 遷移パターン理解 |
| Vol.11.14 | Vol.11.14 ValueStackの中身を理解する – 画面とActionの橋渡し役 | Action |
| Vol.11.15 | Interceptorチェーンを自作してみよう（ログ / 認証フィルタ） | Interceptor |
| Vol.11.16 | エラー処理と例外ハンドリングの実践パターン | ハンドリング設計 |
| Vol.11.17 | Struts2でファイルアップロード機能を実装する方法 | 実装系Tips |
| Vol.11.18 | 非同期通信（AJAX）とStruts2の連携方法 | フロント連携編 |
| Vol.11.19 | セキュリティ対策（CSRF, XSS, パラメータ偽装） | セキュリティ対策 |
| Vol.11.20 | 複数フォームを安全に扱う！セッション管理と動的フォームの考え方 | セッション管理 |
| Vol.11.21 | Struts2でJSONを返す！REST API連携と非同期通信の基本設計 | セッション管理 |
| Vol.11.22 | 本番環境構成とセキュリティ設計（Apache+Tomcat+Struts2連携） | 外部公開 |
🙌 おわりに
Struts2は古いフレームワークと思われがちですが、基本設計は非常に堅牢で、学ぶ価値のある技術です。
今回の記事で少しでも「なるほど！」「モヤモヤが晴れた！」と思っていただけたなら嬉しいです。
次回以降もStruts2の奥深い機能を掘り下げていきますので、ぜひフォロー＆LGTMよろしくお願いします！