Servlet 3.0で追加された機能と，アプリケーションサーバの機能を組み合わせた場合の仕様について説明します。

(a)　Webプリケーションのバージョン設定機能

Webアプリケーションのバージョン設定機能で，バージョンとして3.0は設定できません。

(b)　META-INF/resources以下のJSP事前コンパイル

Servlet 3.0仕様では，JSPファイルをJARファイルの中のMETA-INF/resourcesの階層に含めることができるようになりましたが，META-INF/resources内にJSPを含むWebアプリケーションの場合，JSPの事前コンパイルは実行できません。JSP事前コンパイルを実行した場合，META-INF/resources内のJSPは事前コンパイルされないで，リクエスト実行時にエラーとなります。

(c)　Servlet 3.0を使用したアプリケーションのリロード

Servlet 3.0仕様の機能を使用したアプリケーションをリロードする場合，次の制約があります。

META-INF/resourcesに静的コンテンツ（JSPも含む）を持つJARファイルを含むアプリケーションの場合，JARファイルを更新してリロードしても，JARファイルのMETA-INF/resources内の静的コンテンツは更新前のものにしかアクセスできません。META-INF/resourcesに静的コンテンツを持つJARファイルを含むアプリケーションをリロードした場合，KDJE39556-Wが出力されます。

注意

09-00-02より前のバージョンの場合，次のアプリケーションをリロードしたときの動作は保証されません。

• ServletContainerInitializerインタフェースの実装クラスを含むアプリケーションの場合。
  リロードした場合，KDJE39557-Wが出力されます。
  
• 動的サーブレット定義で追加したサーブレット，フィルタまたはリスナを含むアプリケーションの場合。
  リロードした場合，KDJE39558-Wが出力されます。
  

(d)　APIで定義したサーブレットでのrun-as機能

APIで定義したサーブレットでrun-as機能を使用できません。次の設定をした場合，無視されます。

• サーブレットのクラスで@RunAsアノテーションを使用する。
• ServletRegistration.DynamicインタフェースのsetRunAsRoleメソッドを呼び出す。

(e)　APIで定義したサーブレットまたはフィルタの実行時間の監視

APIで定義したサーブレットまたはフィルタでは，J2EEアプリケーションの実行時間の監視機能を使用できません。cosminexus.xmlに<method-observation-timeout>タグが設定されていても無視されます。

(f)　Webアプリケーションの呼び出し時のHTTPセッションの継続

Webアプリケーションの呼び出し時のHTTPセッションの継続については，Servlet 2.5仕様の場合と同じ動作となります。詳細は，「6.2.4(6)　Webアプリケーションの呼び出し時のHTTPセッションの継続について」を参照してください。

(g)　セッションのクッキー名を変更した場合のリダイレクタでのリクエストの振り分け

Webコンテナがクラスタ構成で配置される場合に，リダイレクタを使用してリクエストを振り分けることができます。リダイレクタは，各リクエストに付加されたセッションIDを参照して，同一のWebクライアントから来たリクエストが同一のWebコンテナに転送されるように，リクエストを振り分けます。ただし，セッションのクッキー名をデフォルトの「JSESSIONID」からほかの名称に変更した場合，同一のWebクライアントから来たリクエストを同一のWebコンテナに転送する動作は保証されません。

(h)　アノテーション参照抑止機能

Servlet3.0で追加されたアノテーションのうち，@HandlesTypesアノテーションはアノテーション参照抑止機能の対象になりません。アノテーション参照抑止機能が有効な場合でも処理されます。

Servlet 3.0とCDIを組み合わせて使用する場合，Servlet 3.0に対応したweb.xmlを使用してください。これ以外のバージョンのweb.xmlとCDIを組み合わせて使用できません。

APIで定義したフィルタまたはリスナでは，@PostConstructアノテーションまたは@PreDestroyアノテーションを使用できません。これらのアノテーションを使用した場合，無視されます。

Servlet 3.0仕様では，インクルードの対象がデフォルトサーブレット（静的コンテンツを提供するためにコンテナが用意しているサーブレット）で，対象のコンテンツがない場合，FileNotFoundException例外をスローすることになっています。また，その例外がユーザプログラムで処理されなかった場合，レスポンスはコミットされないで，ステータスコード500を返すことなっています。

アプリケーションサーバでは，この仕様はサポートされません。08-70以前のバージョンと同様にステータスコード404が返されます。

Servlet 3.0で新規に追加されたAPIやプロパティの入力文字に，エスケープシーケンス（\b，\t,，\n，\f，\r，\"，\'，\\）を使用しないでください。使用した場合，ログが途中で改行されるなど，表示が不正になることがあります。

動的サーブレット定義について，アプリケーションサーバで使用した場合にServlet 3.0仕様と異なる点について説明します。

(a)　サーブレット，フィルタ，またはリスナの定義

• APIおよびweb.xmlの両方でフィルタを追加した場合に，APIで定義されたほかのフィルタマッピングのisMatchAfterメソッドがfalseに設定されているときは，リクエスト処理の中でAPIの定義が先に呼ばれます。
• APIおよびweb.xmlの両方でリスナを定義した場合，リスナの生成のときはアプリケーションの開始時にweb.xmlで定義されたリスナが先に読み込まれます。リスナを削除するときは，APIの定義が先に読み込まれます。
• URLパターンに空文字（""）を指定してjavax.servlet.ServletRegistrationインタフェースのaddMapping(String... urlPatterns)メソッドを呼び出した場合，サーブレットはコンテキスト名だけでアクセスされます。コンテキスト名も空文字（""）の場合は，サーブレットにアクセスできません。
• すでにweb.xmlで定義された名称，または@WebServletアノテーションでサーブレットクラスが生成された名称と同じサーブレット名を指定して，addServlet()メソッドを呼び出さないでください。
• ユーザアプリケーションの中で，同じサーブレットに対してsetMultipartConfig()メソッドを呼び出し，@MultipartConfigアノテーションを指定した場合，setMultipartConfig()メソッドで指定した値が使用されます。
  同様に，ユーザアプリケーションの中で，同じサーブレットに対してsetServletSecurity()メソッドを呼び出し，@ServletSecurityアノテーションを指定した場合，setServletSecurity()メソッドで指定した値が使用されます。
  
• getRunAsRole()メソッドおよびsetRunAsRole(String roleName)メソッドを使用して，ロールの取得および設定はできません。また，ワーニングメッセージまたはエラーメッセージも出力されません。
• すでに登録されている名称でサーブレットまたはフィルタを登録した場合，アプリケーションの開始時にKDJE39552-Wが出力され，処理は続行されます。
• URLパターンに改行コードが含まれていた場合，アプリケーションの開始時にKDJE39555-Wが出力され，処理は続行されます。

(b)　ServletContainerInitializerインタフェースを使用した定義

アプリケーションサーバでのServletContainerInitializerインタフェースを使用した定義について，Servlet 3.0仕様と次の点が異なります。

• ServletContainerInitializerインタフェースを実装したクラスを含むJARファイルは次の場所に配置できます。
  
  1. アプリケーションに含まれるWARファイル内のWEB-INF/libディレクトリ
  2. WEB-INF/libディレクトリ以外の場所
  WEB-INF/libディレクトリ以外の場所に，ServletContainerInitializerインタフェースを実装したクラスを含むJARファイルを配置する場合，JARファイルの絶対パスをusrconf.propertiesの次のプロパティに指定します。
  

  webserver.ServletContainerInitializer_jar.include.path

  設定例

  webserver.ServletContainerInitializer_jar.include.path=C:/Program Files/xxx/foo/lib/bar.jar

• @HandlesTypesアノテーションのクラスの検索範囲は，ServletContainerInitializerインタフェースの実装クラスを含むWARの中です。WARのWEB-INF/classesディレクトリにあるクラス，およびWEB-INF/libディレクトリにあるJARファイルが対象となります。
• ServletContainerInitializerインタフェースを実装したクラスを含むJARファイルが読み込めないか処理できない場合，アプリケーションの開始時にKDJE39548-Eが出力され，アプリケーションの開始に失敗します。
• @HandlesTypesアノテーションで指定したクラスを継承(extends)や実装(implements)したクラス，または@HandlesTypesアノテーションで指定したクラスのアノテーションを付けているクラスを検索する際に，クラスのロードに失敗した場合，KDJE39549-Wが出力され，アプリケーションの開始処理は続行されます。
• webserver.ServletContainerInitializer_jar.include.pathに指定した，ServletContainerInitializerインタフェースを実装したクラスを含むJARファイルが見つからない場合，またはJARファイルもしくはファイルが読み込めない場合，アプリケーションの開始時にKDJE39553-Wが出力され，処理は続行されます。このメッセージはwebserver.ServletContainerInitializer_jar.include.pathに指定されたJARファイルごとに出力されます。
• webserver.ServletContainerInitializer_jar.include.pathに指定した，ServletContainerInitializerインタフェースを実装したクラスを含むJARファイルがクラスパスの中に見つからない場合，アプリケーションの開始時にKDJE39554-Wが出力され，処理は続行されます。このメッセージはwebserver.ServletContainerInitializer_jar.include.pathに指定されたJARファイルごとに出力されます。

また，javax.servlet.ServletContainerInitializerファイルに定義する，ServletContainerInitializerインタフェースの実装クラスの情報は，次のように読み込まれます。

• 1行目に記述されたクラスだけが読み込まれ，2行目以降に記述されたクラスは無視されます。

ファイルアップロードについて，アプリケーションサーバで使用した場合にServlet 3.0仕様と異なる点について説明します。

• web.xmlおよび@MultipartConfigアノテーションの両方でmultipart config要素を設定した場合，web.xmlの定義が優先されます。
• リクエストタイプがmultipart/form-data以外のリクエストでファイルアップロードを実施した場合，javax.servlet.ServletException例外がスローされます。ファイルアップロードを実施するリクエストのタイプと実行結果を次の表に示します。
  

  表6-14　ファイルアップロードを実施するリクエストのタイプと実行結果

  web.xmlまたは@MultipartConfigアノテーションを指定したリクエストのタイプ	実行結果
  mime-multipart以外	javax.servlet.ServletException例外がスローされます。
  multipart/form-data以外のmime-multipart	javax.servlet.ServletException例外がスローされます。
  multipart/form-data	ファイルアップロードが実行されます。例外は発生しません。

• MultipartConfigElementがプログラムで定義された場合，web.xmlで定義された場合と同じ動作になります。ただし，空文字（""）がlocationに指定された場合，ファイルがWebアプリケーションの作業ディレクトリに格納されます。
• アップロードされたファイルが，web.xmlの<file-size-threshold>タグまたは@MultipartConfigアノテーションのfileSizeThreshold属性で指定した値よりも大きいサイズの場合，リクエスト内のオブジェクトの一部分に対応する一時ファイルが生成されます。一時ファイルの名称は，「upload」から始まる，一意に識別される名称で，拡張子は「.tmp」です。
  例：upload__5f8d5c62_1316c5ef08b__8000_00000012.tmp
  一時ファイルはリクエストの処理の最後に削除されます。ただし，一時ファイルが開かれたままの場合，J2EEサーバが正常に停止されなかった場合，システムダウンした場合など，一時ファイルが削除されないケースがあります。このような場合は，locationで指定した場所から一時ファイルを手動で削除する必要があります。
  ユーザが手動で作成したファイルと同じ名称の一時ファイルが生成された場合は，ユーザが作成したファイルが上書きされます。
  
• Partオブジェクトはリクエスト内で利用できます。Partオブジェクトはリクエストが完了した時点で削除されます。あとで利用するためにセッションの中でPartオブジェクトを保持しても，動作は保証されません。

静的リソースの配置について，アプリケーションサーバで使用した場合にServlet 3.0仕様と異なる点について説明します。

• 静的リソースが含まれるJARファイルが読み込めないか処理できない場合，アプリケーションの開始時にKDJE39548-Eが出力され，アプリケーションの開始に失敗します。
• 指定したJARファイルに形式不正があった場合，アプリケーションの開始時にKDJE39550-Eが出力され，処理は続行されます。
• WEB-INF/libに不正なJARファイル，または読み込めないファイルが含まれていた場合，アプリケーションの開始時にKDJE39551-Wが出力され，そのJARファイルを無視して処理が続行されます。

APIについて，アプリケーションサーバで使用した場合にServlet 3.0仕様と異なる点について説明します。

• アプリケーションサーバでは，Servlet 3.0仕様で追加されたAPIのうち，次の表に記載されていないAPIを使用できます。APIの詳細については，Servlet 3.0の仕様書を参照してください。
  次の表に記載された非サポートのAPIを使用した場合，java.lang.UnsupportedOperationException例外がスローされます。
  

  表6-15　非サポートのAPI（Servlet 3.0）

  項番	パッケージ	クラス	インタフェース/クラス	メソッド	機能
  1	javax.servlet	AsyncContext	インタフェース	すべてのメソッド	非同期サーブレット
  2		AsyncListener	インタフェース	すべてのメソッド	非同期サーブレット
  3		ServletContext	インタフェース	getJspConfigDescriptor	JSP
  4		ServletRequest	インタフェース	startAsync	非同期サーブレット
  5				isAsyncStarted	非同期サーブレット
  6				isAsyncSupported	非同期サーブレット
  7				getAsyncContext	非同期サーブレット
  8				getDispatcherType	非同期サーブレット
  9		AsyncEvent	クラス	すべてのメソッド	非同期サーブレット
  10		ServletRequestWrapper	クラス	startAsync	非同期サーブレット
  11				isAsyncStarted	非同期サーブレット
  12				isAsyncSupported	非同期サーブレット
  13				getAsyncContext	非同期サーブレット
  14				getDispatcherType	非同期サーブレット
  15		Registration	インタフェース	setAsyncSupported	非同期サーブレット
  16	javax.servlet.descriptor	JspConfigDescriptor	インタフェース	すべてのメソッド	JSP
  17		JspPropertyGroupDescriptor	インタフェース	すべてのメソッド	JSP
  18		TaglibDescriptor	インタフェース	すべてのメソッド	JSP

• Servlet 2.5仕様に対応するWebアプリケーションで，Servlet 3.0で追加されたAPIは使用できません。使用した場合，チェックされないため動作は保証されません。
• SessionTrackingModeでは，SSLは使用できません。アプリケーションサーバではCOOKIEとURLだけ使用できます。

Servlet 3.0では，次のアプリケーションの場合，web.xmlを省略できます。

• 静的コンテンツおよびJSPだけを含むWebアプリケーション（サーブレット，フィルタ，およびリスナを含まない）
• サーブレット，フィルタ，リスナをアノテーションで定義したWebアプリケーション

セッションIDを示すHTTP Cookie名を変更する場合，Cookie名に「csfcfc」を指定できません。

また，使用できる文字に次の条件があります。条件に違反した場合，KDJE39559-Wが出力されます。セッションの不正な動作の原因になることがあるため，条件に合った文字を使用してください。

• ASCII文字を使用してください。ただし，次の文字は使用できません。
  「#」，「(」，「)」，「<」，「>」，「@」，「,」，「;」，「:」，「\」，「/」，「"」，「[」，「]」，「?」，「=」，「{」，「}」
  
• 空白，および制御文字は使用できません。
• 文字列の先頭に「$」は使用できません。

WebアプリケーションでHTTP Cookieを使用する場合，次の名称を指定できません。なお，大文字と小文字は区別されません。

• HTTPセッションのセッションIDで使用するHTTP Cookieの名称。デフォルトは「JSESSIONID」。
• グローバルセッションを表すHTTP Cookieの名称。デフォルトは「GSESSIONID」。
• J2EEサーバのサーバID付加機能によってサーバIDを付加したHTTP Cookieの名称と同じ名称。
• J2EEサーバ内部で使用するHTTP Cookieの名称「csfcfc」。

web.xmlの<servlet-class>要素を省略する場合，@WebServletアノテーションを指定したjavax.servlet.http.HttpServletのサブクラスをWebアプリケーションに含め，name属性に<servlet-class>要素を省略したサーブレットのサーブレット名を設定する必要があります。該当するHttpServletクラスがない場合は，KDJE39339-Eが出力され，サーブレットクラスのロードに失敗します。

web.xmlの<filter-class>要素を省略する場合，@WebFilterアノテーションを指定したjavax.servlet.Filterの実装クラスをWebアプリケーションに含め，filterName属性に<filter-class>要素を省略したフィルタのフィルタ名を設定する必要があります。該当するFilterクラスがない場合は，KDJE39340-Eが出力され，アプリケーションの開始に失敗します。

セッションIDを示すHTTP CookieのPath属性を変更する場合，別のWebアプリケーションとセッションIDを示すHTTP Cookie名やPath属性が重複すると，HTTP CookieのセッションIDを示す値が上書きまたは削除されるなどの理由で，HTTPセッションが正しく引き継がれなくなることがあります。

セッションIDを示すHTTP CookieのPath属性とDomain属性に使用できる文字には次の条件があります。条件に違反した場合，KDJE39559-Wが出力されます。セッションの不正な動作の原因になることがあるため，条件に合った文字を使用してください。

• Path属性には，ASCII文字だけが使用できます。ただし，制御文字およびセミコロン（;）は使用できません。
• Domain属性には，英数字，ハイフン（-）およびピリオド（.）だけが使用できます。