Javaサーブレット リスナー

サーブレットリスナーは、ウェブアプリケーションの各イベント毎に呼ばれるもの。
（サーブレット2.3以降）

リスナーの種類

web.xmlに記述するリスナー

（Swingのリスナーだと、addListener()系のメソッドを使ってリスナーインスタンスをコンポーネントに登録するが、）
サーブレット系のリスナー（のほとんど）はweb.xmlにクラス名を記述することによって、そのリスナーが呼ばれるようになる。

リスナーはインターフェースなので、それを実装した具象クラスを作り、web.xmlのlistener要素にそのクラス名を記述する。
すると、そのリスナーに該当するイベントが発生した際に、実装したメソッドが呼ばれる。

サーブレットコンテキストリスナーの例

SampleServletContextListener.java：

package jp.hishidama.sample.listener;

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

public class SampleServletContextListener implements ServletContextListener {

	@Override
	public void contextInitialized(ServletContextEvent sce) {
		print("contextInitialized", sce);
	}

	@Override
	public void contextDestroyed(ServletContextEvent sce) {
		print("contextDestroyed", sce);
	}

	void print(String name, ServletContextEvent sce) {
		System.out.printf("■■" + this.getClass().getSimpleName() + "#" + name + "(%s)%n",
			sce.getServletContext().getServerInfo());
	}
}

web.xml：

<?xml version="1.0" encoding="Shift_JIS" ?>
<web-app 〜>
〜
	<listener>
		<listener-class>jp.hishidama.sample.listener.SampleServletContextListener</listener-class>
	</listener>
〜
</web-app>

listener要素

listener要素はweb-app要素の下に複数書くことが出来る（複数のリスナークラスを登録できる）。
また、複数のリスナーインターフェースを1つのクラスに実装して、listener要素ではその実装クラスだけを書く、というやり方も可能。

マルチスレッドに注意

web.xmlで定義するリスナーは、サーブレットやフィルターと同様に1インスタンスしか作られない。

ServletContextListenerに関しては（ウェブアプリの起動・終了時に呼ばれるものなので）たぶんマルチスレッドで呼ばれることは無いと思うが、
他のリスナーは複数スレッドから同時に呼ばれる可能性があるので、MTセーフ（スレッドセーフ）になるよう注意する必要がある。

→サーブレット系全般の注意点