Servlet 2.4仕様で追加されたX-Powered-Byヘッダはレスポンスに追加されません。

javax.servlet.ServletRequestクラス，およびjavax.servlet.ServletContextクラスのgetRequestDispatcherメソッドで取得したjavax.servlet.RequestDispatcherクラスのforwardメソッドを実行すると，リクエストオブジェクトには次のキーの属性が追加されます。ただし，javax.servlet.ServletContextクラスのgetNamedDispatcherメソッドで取得したRequestDispatcherオブジェクトのforwardメソッドでは追加されません。

• javax.servlet.forward.request_uri
• javax.servlet.forward.context_path
• javax.servlet.forward.servlet_path
• javax.servlet.forward.path_info^※1
• javax.servlet.forward.query_string^※2

注※1

Webコンテナが受信したHTTPリクエストが追加のパス情報を含まない場合，この属性は追加されません。

注※2

Webコンテナが受信したHTTPリクストのリクエストURIがクエリ文字列を含まない場合，この属性は追加されません。

これらの属性は，Webコンテナによって追加されます。javax.servlet.ServletRequestAttributeListenerに属性追加のイベントは通知されません。追加される属性の値については，Servlet 2.4仕様書を参照してください。

javax.servlet.SingleThreadModelインタフェースは，Servlet 2.4仕様から非推奨となっています。

Cosminexusでは，Webアプリケーションのバージョンに関係なく，javax.servlet.SingleThreadModelインタフェースを使用できます。ただし，Servlet 2.4仕様を参照し，非推奨となった理由に注意して使用してください。

javax.servlet.ServletResponseクラスのsetLocaleメソッドによって，HTTPレスポンスのContent-Typeヘッダに文字エンコーディングが設定されます。Servlet 2.4仕様では，設定される文字エンコーディングが有効となる条件が変更されています。

Cosminexusで有効となる条件を，Servlet 2.4とServlet 2.3に分けて示します。

Servlet 2.4

次のすべての条件を満たす必要があります。

• HTTPレスポンスがコミットされる前であること。
• getWriterメソッドの呼び出し前であること。
• setCharacterEncodingメソッドの呼び出し前であること。
• setContentTypeメソッドによって文字エンコーディングが設定されていないこと。

条件に反する場合，setLocalメソッドは，ServletResponseクラスにロケールを設定するだけで，レスポンスの文字エンコーディングは設定しません。

Servlet 2.3

次の条件を満たす必要があります。

• HTTPレスポンスがコミットされる前であること^※。

注※

• レスポンスがコミットされる前の場合，getWriterメソッドの呼び出し前後に関係なく，文字エンコーディングが設定されます。
• レスポンスがコミットされる前の場合，setContentTypeメソッドで文字エンコーディングが設定されているかどうかに関係なく，文字エンコーディングが設定されます。

javax.servlet.UnavailableException例外は永久的に利用できないことを示します。javax.servlet.UnavailableException例外をthrowしたサーブレット，JSPにアクセスした場合のHTTPレスポンスコードの仕様が，Servlet 2.4仕様で追記されています。

Cosminexusでこの例外をthrowしたサーブレット，JSPにアクセスした場合のHTTPレスポンスコードを，Servlet 2.4とServlet 2.3に分けて示します。

Servlet 2.4

404エラーとなります。

Servlet 2.3

503エラーとなります。

javax.servlet.http.HttpSessionListenerインタフェースのsessionDestroyedメソッドを呼び出すタイミングが，Servlet 2.4仕様で変更されています。

Cosminexusでこのメソッドを呼び出す場合のタイミングを，Servlet 2.4とServlet 2.3に分けて示します。

Servlet 2.4

セッションが破棄される前に実行されます。

Servlet 2.3

セッションが破棄されたあとに実行されます。

なお，セッションタイムアウトが無効のとき，次の順序でセッションに関するリスナが通知されます。Webアプリケーションのバージョンごとに，順序を示します。

Servlet2.4の場合

1. javax.servlet.http.HttpSessionListenerインタフェースのsessionDestroyed()メソッド
2. javax.servlet.http.HttpSessionBindingListenerインタフェースのvalueUnbound()メソッド
3. javax.servlet.http.HttpSessionAttributeListenerインタフェースのattributeRemoved()メソッド

Servlet2.3の場合

1. javax.servlet.http.HttpSessionBindingListenerインタフェースのvalueUnbound()メソッド
2. javax.servlet.http.HttpSessionAttributeListenerインタフェースのattributeRemoved()メソッド
3. javax.servlet.http.HttpSessionListenerインタフェースのsessionDestroyed()メソッド

javax.servlet.http.HttpServletResponseクラスのsendRedirectメソッドを使用する条件が，Servlet 2.4仕様で変更されています。

Cosminexusでこのメソッドを正常に実行するには，次の条件をすべて満たす必要があります。

• 実行するタイミングが，レスポンスがコミットされる前であること。
• 引数に適切なURLを指定すること。

この条件を満たさない場合のエラー制御を，Servlet 2.4とServlet 2.3に分けて示します。

Servlet 2.4

条件を満たさない場合は，java.lang.IllegalStateException例外がthrowされます。

Servlet 2.3

• レスポンスがすでにコミットされている場合
  java.lang.IllegalStateException例外がthrowされます。
  
• 引数に不正なURLが指定された場合
  レスポンスコードが404になります。
  

Servlet 2.4仕様では，HTTPステータスコードの302を示す定数として，javax.servlet.http.HttpServletResponseクラスに「SC_FOUND」が追加されています。また，下位互換性のため，Servlet 2.3仕様で定義されていた「SC_MOVED_TEMPORARILY」はそのまま使用できます。

Cosminexusでは，Webアプリケーションのバージョンに関係なく，「SC_FOUND」および「SC_MOVED_TEMPORARILY」を使用できます。

なお，ステータスメッセージの「Found」がWebコンテナで使用されるのは，次の場合です。

• Webアプリケーションで302を返す場合
• デフォルトエラーページが出力された場合（HTML本文中）

Servlet 2.4仕様では，サービスメソッド実行中のjavax.servlet.http.HttpSessionクラスでのタイムアウトについて仕様が追記されています。

Cosminexusでは，Webアプリケーションのバージョンに関係なく，Webアプリケーションでのリクエスト処理を実行している間は，HttpSessionはタイムアウトされません。

また，Webアプリケーション単位またはURLグループ単位の同時実行スレッド数制御によって，リクエストが実行待ち状態の場合も，HttpSessionはタイムアウトされません。ただし，Webコンテナ単位での同時実行スレッド数制御による実行待ち状態の場合は，HttpSessionはタイムアウトされるので注意してください。

Servlet 2.4仕様では，リスナで例外が発生した場合についての記述が追加されています。

Cosminexusを使用している場合で，リスナで例外が発生した場合の制御を，Servlet 2.4とServlet 2.3に分けて示します。

Servlet 2.4

該当するイベントを処理するリスナが複数あっても，例外を発生したリスナ以降のリスナは，実行されません。

Servlet 2.3

発生した例外はWebコンテナによってcatchされます。複数のリスナが登録されている場合，例外がcatchされたあとに，正常時と同様に登録されているリスナが順次実行されます。

Webアプリケーションで外部のライブラリを使用する場合に記載するMANIFESTファイルの扱いについて，Servlet 2.4仕様では記述が変更されています。

Cosminexusでは，Webアプリケーションのバージョンに関係なく，MANIFESTファイルの存在，およびMANIFESTファイルの内容は確認されません。

サーブレットのバージョンが異なるWebアプリケーション間で，クロスコンテキストを使用したリクエストをforwardしたあとの動作，およびincludeしたあとの動作を，次の表に示します。

表4-50　forward後およびinclude後の動作

項番	Servlet 2.4仕様の追加機能／Webアプリケーションのバージョンで違いのある機能	リクエストのforward先／include先の動作
		2.4から2.3にforward／include※1	2.3から2.4にforward／include※2
1	forward時またはinclude時のフィルタ適用	forward後／include後のサーブレット，またはJSPから，さらにforwardまたはincludeする場合，Servlet 2.4仕様が適用され，フィルタは使用できます。	forward後／include後のサーブレット，またはJSPからさらにforwardまたはincludeする場合，Servlet 2.3仕様が適用され，フィルタは使用できません。
2	javax.servlet.ServletRequestAttributeListenerの呼び出し	Servlet 2.4仕様が適用され，リクエストへの属性追加時にリスナが使用できます。	Servlet 2.3仕様が適用され，リクエストへの属性追加時にリスナは使用できません。
3	JSPのコンパイル	Servlet 2.3に対応したアプリケーションとしてJSPコンパイルを実行します。	Servlet 2.4に対応したアプリケーションとしてJSPコンパイルを実行します。
4	javax.servlet.ServletResponseクラスのsetLocaleメソッド	Servlet 2.4仕様が適用され，次に示す条件をすべて満たす場合，文字エンコーディングの設定が有効となります。 レスポンスがコミットされる前であること。 getWriterメソッドの呼び出し前であること。 setCharacterEncodingメソッドの呼び出し前であること。 serContentTypeメソッドで文字エンコーディングが設定されていないこと。	Servlet 2.3仕様が適用され，レスポンスがコミットされる前である場合，文字エンコーディングの設定が有効となります。
5	永久的に利用できないことを示すjavax.servlet.UnavailableException例外をthrowしたサーブレット，JSPへのディスパッチ	Servlet 2.3仕様が適用され，ステータス503を設定したレスポンスが返されます。	Servlet 2.4仕様が適用され，ステータス404を設定したレスポンスが返されます。
6	javax.servlet.http.HttpSessionListenerインタフェースのsessionDestroyedメソッド	Servlet 2.4仕様が適用され，HTTPセッションが破棄される前に実行されます。	Servlet 2.3仕様が適用され，HTTPセッションが破棄されたあとに実行されます。
7	javax.servlet.http.HttpServletResponseクラスのsendRedirectメソッドに不正なURLを指定	Servlet 2.4仕様の仕様が適用され，java.lang.IllegalStateException例外がthrowされます。	Servlet 2.3の仕様が適用され，ステータス404がレスポンスに設定されます。
8	使用するリスナ定義	次に示すリスナの場合，forward先またはinclude先のアプリケーションで定義されたリスナが動作します。 javax.servlet.ServletContextAttributeListener 次に示すリスナの場合，forwardまたはincludeを呼び出したアプリケーションで定義されたリスナが動作します。 javax.servlet.ServletRequestAttributeListener javax.servlet.http.HttpSessionListener javax.servlet.http.HttpSessionAttributeListener	次に示すリスナの場合，forward先またはinclude先のアプリケーションで定義されたリスナが動作します。 javax.servlet.ServletContextAttributeListener 次に示すリスナの場合，forwardまたはincludeを呼び出したアプリケーションで定義されたリスナが動作します。 javax.servlet.http.HttpSessionListener javax.servlet.http.HttpSessionAttributeListener
9	該当するイベントを処理するリスナがweb.xmlで複数定義されていた場合に，forwardもしくはinclude先のアプリケーション内でリスナが例外を発生したときの動作	次に示すリスナの場合，Servlet 2.4仕様が適用され，例外を発生したリスナ以降のリスナは実行されません。 javax.servlet.ServletRequestAttributeListener javax.servlet.http.HttpSessionListener javax.servlet.http.HttpSessionAttributeListener 次に示すリスナの場合，Servlet 2.3仕様が適用され，発生した例外をキャッチし，その後正常時と同様に登録されている次のリスナへ処理が移ります。 javax.servlet.ServletContextAttributeListener	次に示すリスナの場合，Servlet 2.4仕様が適用され，例外を発生したリスナ以降のリスナは実行されません。 javax.servlet.ServletContextAttributeListener 次に示すリスナの場合，Servlet 2.3仕様が適用され，発生した例外をキャッチし，その後正常時と同様に登録されている次のリスナへ処理が移ります。 javax.servlet.http.HttpSessionListener javax.servlet.http.HttpSessionAttributeListener
10	web.xmlで指定されたエラーページを表示したレスポンスのステータスコード	Servlet 2.4仕様が適用され，エラー発生時のステータスコードのレスポンスが返されます。	Servlet 2.3仕様が適用され，ステータス200のレスポンスが返されます。

注※1

Servlet 2.4に対応したアプリケーションからServlet 2.3に対応したアプリケーションにforwardまたはincludeした場合を表します。

注※2

Servlet 2.3に対応したアプリケーションからServlet 2.4に対応したアプリケーションにforwardまたはincludeした場合を表します。