ServletContext (Java Servlet 4.0)

```
public interface ServletContext
```
サーブレットがサーブレットコンテナと通信するために使用する一連のメソッドを定義します。例として、ファイルのMIMEタイプを取得したり、要求をディスパッチしたり、ログファイルに書き込んだりすることができます。
Java仮想マシンごとの"ウェブアプリケーション"ごとに1つのコンテキストがあります。 ("ウェブアプリケーション"は、/catalogなどのようにサーバーのURL名前空間の特定のサブセットの下に.warファイル経由でインストールことができるサーブレットとコンテンツの集合です。)
デプロイメントディスクリプタに"distributed"とつけられたウェブアプリケーションの場合は、各仮想マシンごとに1つのコンテキストインスタンスが存在します。この状況では、グローバルな情報を共有するための場所としてServletContextを使用することはできません（その情報は真にグローバルではない方が良いため）。代わりにデータベースのような外部リソースを使用してください。
ServletContextオブジェクトはServletConfigオブジェクト内に含まれており、サーブレットが初期化されたときにウェブサーバーがそれらを提供します。

作成者:

Various

関連項目:

Servlet.getServletConfig(), ServletConfig.getServletContext()

フィールドのサマリー

フィールド
修飾子とタイプ	フィールドと説明
`static String`	`ORDERED_LIBS` ウェブフラグメント名で順序付けられた(なし`<others/>`が使用されていない`<absolute-ordering>`の場合は除外されることがある) `WEB-INF/lib`内のJARファイルの名前のリストを含む(`java.util.List<java.lang.String>`型の)JARファイルの名前のリストを持つ`ServletContext`の属性の名前です。
`static String`	`TEMPDIR` `ServletContext`のためにサーブレットコンテナによって提供される(`java.io.File`e型の)プライベートテンポラリディレクトリを格納する`ServletContext`の属性の名です。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド abstractメソッド非推奨のメソッド
修飾子とタイプ	メソッドと説明
`FilterRegistration.Dynamic`	`addFilter(String filterName, Class<? extends Filter> filterClass)` 指定された名前とクラスタイプをこのServletContextに追加します。
`FilterRegistration.Dynamic`	`addFilter(String filterName, Filter filter)` 指定されたフィルターのインスタンスをこのServletContextに指定された`filterName`の下で登録します。
`FilterRegistration.Dynamic`	`addFilter(String filterName, String className)` このServletContextに指定された名前とクラス名でフィルターを追加します。
`ServletRegistration.Dynamic`	`addJspFile(String servletName, String jspFile)` 指定されたJSPファイルのサーブレットをこのServletContextに追加します。
`void`	`addListener(Class<? extends EventListener> listenerClass)` 指定されたクラスの型のリスナーをこのServletContextに追加します。
`void`	`addListener(String className)` このServletContextに指定されたクラスの名前のリスナーを追加します。
`<T extends EventListener> void`	`addListener(T t)` 指定されたリスナーをこのServletContextに追加します。
`ServletRegistration.Dynamic`	`addServlet(String servletName, Class<? extends Servlet> servletClass)` 指定された名前とクラスタイプをこのServletContextに追加します。
`ServletRegistration.Dynamic`	`addServlet(String servletName, Servlet servlet)` 指定されたサーブレットのインスタンスをこのServletContextに指定された`servletName`の下で登録します。
`ServletRegistration.Dynamic`	`addServlet(String servletName, String className)` このServletContextに指定された名前とクラス名でサーブレットを追加します。
`<T extends Filter> T`	`createFilter(Class<T> clazz)` 指定されたフィルタークラスをインスタンス化します。
`<T extends EventListener> T`	`createListener(Class<T> clazz)` 指定されたEventListenerクラスをインスタンス化します。
`<T extends Servlet> T`	`createServlet(Class<T> clazz)` 指定されたサーブレットクラスをインスタンス化します。
`void`	`declareRoles(String... roleNames)` `isUserInRole`での検証に使用されるロール名を定義します。
`Object`	`getAttribute(String name)` 指定された名前のサーブレットコンテナの属性を返します。
`Enumeration<String>`	`getAttributeNames()` このServletContextで使用可能な属性の名前の含まれた`Enumeration`を返します。
`ClassLoader`	`getClassLoader()` このサーブレットコンテキストに対応するウェブアプリケーションのクラスローダーを取得します。
`ServletContext`	`getContext(String uripath)` サーバー上の指定されたURLに対応する`ServletContext`オブジェクトを返します。
`String`	`getContextPath()` このウェブアプリケーションのコンテキストパスを返します。
`Set<SessionTrackingMode>`	`getDefaultSessionTrackingModes()` この`ServletContext`でデフォルトでサポートされるセッション追跡方法を取得します。
`int`	`getEffectiveMajorVersion()` このServletContextが表すアプリケーションが基づいているServlet仕様のメジャーバージョンを取得します。
`int`	`getEffectiveMinorVersion()` このServletContextが表すアプリケーションが基づいているServlet仕様のマイナーバージョンを取得します。
`Set<SessionTrackingMode>`	`getEffectiveSessionTrackingModes()` この`ServletContext`で有効なセッション追跡方法を取得します。
`FilterRegistration`	`getFilterRegistration(String filterName)` 指定された`filterName`のフィルターに対応するFilterRegistrationを取得します。
`Map<String,? extends FilterRegistration>`	`getFilterRegistrations()` このServletContextに登録されているすべてのフィルターに対応する(フィルターの名前がキーで空の可能性のある)FilterRegistrationオブジェクトのMapを取得します。
`String`	`getInitParameter(String name)` 指定されたコンテキスト全体のための初期化パラメーターの値を含む`String` を返します。
`Enumeration<String>`	`getInitParameterNames()` コンテキストの初期化パラメーターの名前を`String`オブジェクトの`Enumeration`として返します。
`JspConfigDescriptor`	`getJspConfigDescriptor()` このServletContextに対応するウェブアプリケーションの`web.xml`と`web-fragment.xml`ディスクリプターファイルから集約された`<jsp-config>`に関連する設定を取得します。
`int`	`getMajorVersion()` このサーブレットコンテナがサポートするServlet APIのメジャーバージョンを返します。
`String`	`getMimeType(String file)` 指定されたファイルのMIMEタイプを返します。
`int`	`getMinorVersion()` このサーブレットコンテナがサポートするServlet APIのマイナーバージョンを返します。
`RequestDispatcher`	`getNamedDispatcher(String name)` 指定された名前のサーブレットのラッパーとして動作する`RequestDispatcher`オブジェクトを返します。
`String`	`getRealPath(String path)` 指定された仮想のパスに対応する実際のパスを返します。
`String`	`getRequestCharacterEncoding()` この`ServletContext`でデフォルトでサポートするレスポンスの文字エンコーディングを取得します。
`RequestDispatcher`	`getRequestDispatcher(String path)` 指定されたパスにあるリソースのラッパーとして機能する`RequestDispatcher`のオブジェクトを返します。
`URL`	`getResource(String path)` 指定されたパスにマッピングされたリソースへのURLを返します。
`InputStream`	`getResourceAsStream(String path)` パスの所在地のリソースを`InputStream`オブジェクトとして返します。
`Set<String>`	`getResourcePaths(String path)` 最も長いサブパスが指定された引数のパスと一致するウェブアプリケーション内のリソースへのディレクトリに似た形式ですべてのパスのリストを返します。
`String`	`getResponseCharacterEncoding()` この`ServletContext`でデフォルトでサポートするレスポンスの文字エンコーディングを取得します。
`String`	`getServerInfo()` サーブレットが動作しているサーブレットコンテナの名前とバージョンを返します。
`Servlet`	`getServlet(String name)` 非推奨です。 Java Servlet API 2.1以降での直接の代替手段はありません。このメソッドはもともとは`ServletContext`からサーブレットを受け取るために定義されていました。このバージョンでは、このメソッドは必ず`null`を返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。このメソッドの代わりに、サーブレットは`ServletContext`クラスを利用して情報を共有し、一般的なサーブレットでないクラスのメソッドを呼び出すことで共有したビジネスロジックを実行できます。 In lieu of this method, servlets can share information using the `ServletContext` class and can perform shared business logic by invoking methods on common non-servlet classes.
`String`	`getServletContextName()` ウェブアプリケーションのデプロイメントディスクリプタのdisplay-name要素で指定されているこのServletContext に対応するこのウェブアプリケーションの名前を返します。
`Enumeration<String>`	`getServletNames()` 非推奨です。 Java Servlet API 2.1以降での代替手段はありません。このメソッドはもともとは`ServletContext`に登録されたすべてのサーブレット名前の`Enumeration`を返すものとして定義されていました。このバージョンでは、このメソッドは必ず空の`Enumeration`を返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。
`ServletRegistration`	`getServletRegistration(String servletName)` 指定された`servletName`のサーブレットに対応するServletRegistrationを取得します。
`Map<String,? extends ServletRegistration>`	`getServletRegistrations()` このServletContextに登録されているすべてのサーブレットに対応する(サーブレットの名前がキーで空の可能性のある)ServletRegistrationオブジェクトのMapを取得します。
`Enumeration<Servlet>`	`getServlets()` 非推奨です。 Java Servlet API 2.0以降での代替手段はありません。このメソッドはもともとは`ServletContext`に登録されたすべてのサーブレットの`Enumeration`を返すものとして定義されていました。このバージョンでは、このメソッドは必ず空の`Enumeration`を返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。
`SessionCookieConfig`	`getSessionCookieConfig()` この`ServletContext`のために作成されるセッション追跡Cookieのさまざまなプロパティを設定する事ができる`SessionCookieConfig`オブジェクトを取得します。
`int`	`getSessionTimeout()` この`ServletContext`でデフォルトでサポートするセッションがタイムアウトするまでの分を取得します。
`String`	`getVirtualServerName()` ServletContextがデプロイされている論理ホストの設定名を返します。
`void`	`log(Exception exception, String msg)` 非推奨です。 Java Servlet API 2.1から代わりに `log(String message, Throwable throwable)` を使用してくださいこのメソッドはもともとは例外のスタックトレースと例外の説明文をサーブレットのログファイルに書き込むために定義されていました。
`void`	`log(String msg)` 指定されたメッセージをログファイルに書き込みます、通常はイベントログです。
`void`	`log(String message, Throwable throwable)` サーブレットのログファイルに指定された`Throwable`に対する説明文とスタックトレースを書き込みます。
`void`	`removeAttribute(String name)` このServletContextから指定された名前の属性を取り除きます。
`void`	`setAttribute(String name, Object object)` このServletContextに指定された属性の名前でオブジェクトを設定します。
`boolean`	`setInitParameter(String name, String value)` このServletContextのコンテキスト初期化パラメーターの値を指定された名前で設定します。
`void`	`setRequestCharacterEncoding(String encoding)` このServletContextにリクエストの文字エンコーディングを設定します。
`void`	`setResponseCharacterEncoding(String encoding)` このServletContextにレスポンスの文字エンコーディングを設定します。
`void`	`setSessionTimeout(int sessionTimeout)` このServletContextにセッションがタイムアウトするまでの分を設定します。
`void`	`setSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes)` この`ServletContext`で有効になるセッション追跡方法を設定します。

- フィールドの詳細
  - TEMPDIR
```
static final String TEMPDIR
```
    ServletContextのためにサーブレットコンテナによって提供される(java.io.Filee型の)プライベートテンポラリディレクトリを格納するServletContextの属性の名です。
    
    関連項目:
    
    定数フィールド値
  - ORDERED_LIBS
```
static final String ORDERED_LIBS
```
    ウェブフラグメント名で順序付けられた(なし<others/>が使用されていない<absolute-ordering>の場合は除外されることがある) WEB-INF/lib内のJARファイルの名前のリストを含む(java.util.List<java.lang.String>型の)JARファイルの名前のリストを持つServletContextの属性の名前です。絶対順序または相対順序が指定されていない場合はnullです。
    
    関連項目:
    
    定数フィールド値
- メソッドの詳細
  - getContextPath
```
String getContextPath()
```
    このウェブアプリケーションのコンテキストパスを返します。
    コンテキストパスはリクエストのコンテキストを選択するために使用されるリクエストURIの一部分です。コンテキストパスは、常にリクエストURIの最初に来ます。このコンテキストがWebサーバーのURL名前空間の基底にマッピングされる"ルート"コンテキストの場合このパスは空の文字列になります。それ以外の場合、コンテキストがサーバーの名前空間の基底にマッピングされていない場合、パスは"/"で始まりますが"/"で終わることはありません。
    サーブレットコンテナは一つのコンテキストを複数のコンテキストパスにて一致させることができます。このような場合、HttpServletRequest.getContextPath()はリクエストによって使用される実際のコンテキストパスを返し、このメソッドによって返されるパスとは異なる場合があります。このメソッドによって返されるコンテキストパスはアプリケーションのプライマリもしくは優先コンテキストパスと見なす必要があります。
    
    戻り値:
    
    ウェブアプリケーションのコンテキスパス、ルートコンテキストの場合は""
    
    導入されたバージョン:
    
    Servlet 2.5
    
    関連項目:
    
    HttpServletRequest.getContextPath()
  - getContext
```
ServletContext getContext(String uripath)
```
    サーバー上の指定されたURLに対応するServletContextオブジェクトを返します。
    このメソッドは、サーブレットがサーバーのさまざまな部分のコンテキストにアクセスできるようにし、必要に応じてコンテキストからRequestDispatcherオブジェクトを取得できるようにします。指定されたパスは/で始まる必要があり、サーバーのドキュメントルートからの相対パスとして解釈され、このコンテナでホストされている他のWebアプリケーションのコンテキストルートと照合されます。
    セキュリティを意識した環境ではサーブレットコンテナは指定されたURLに対してnullを返すことがあります。
    
    パラメータ:
    
    uripath - このコンテナ内のほかのウェブアプリケーションのコンテキストパスを示すString
    
    戻り値:
    
    URLの名前に対応するServletContextのオブジェクト、存在しないかコンテナがアクセス制限を臨んだ場合はnull
    
    関連項目:
    
    RequestDispatcher
  - getMajorVersion
```
int getMajorVersion()
```
    このサーブレットコンテナがサポートするServlet APIのメジャーバージョンを返します。バージョン4.0に準拠するすべての実装でこのメソッドは4を返す必要があります。
    
    戻り値:
    
    4
  - getMinorVersion
```
int getMinorVersion()
```
    このサーブレットコンテナがサポートするServlet APIのマイナーバージョンを返します。バージョン4.0に準拠するすべての実装でこのメソッドは0を返す必要があります。
    
    戻り値:
    
    0
  - getEffectiveMajorVersion
```
int getEffectiveMajorVersion()
```
    このServletContextが表すアプリケーションが基づいているServlet仕様のメジャーバージョンを取得します。
    返される値はサーブレットコンテナがサポートするサーブレット仕様のメジャーバージョンを返すgetMajorVersion()とは異なる場合があります。
    
    戻り値:
    
    このServletContextが表すアプリケーションが基づいているServlet仕様のメジャーバージョン
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getEffectiveMinorVersion
```
int getEffectiveMinorVersion()
```
    このServletContextが表すアプリケーションが基づいているServlet仕様のマイナーバージョンを取得します。
    返される値はサーブレットコンテナがサポートするサーブレット仕様のマイナーバージョンを返すgetMinorVersion()とは異なる場合があります。
    
    戻り値:
    
    このServletContextが表すアプリケーションが基づいているServlet仕様のマイナーバージョン
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getMimeType
```
String getMimeType(String file)
```
    指定されたファイルのMIMEタイプを返します。MIMEタイプが不明な場合はnullを返します。 MIMEタイプはサーブレットコンテナの設定とアプリケーションのデプロイメントディスクリプタでの指定で決められます。一般的なMIMEタイプとしてはtext/htmlやimage/gifを含みます。
    
    パラメータ:
    
    file - ファイルの名前を示すString
    
    戻り値:
    
    ファイルのMIMEタイプを示すString
  - getResourcePaths
```
Set<String> getResourcePaths(String path)
```
    最も長いサブパスが指定された引数のパスと一致するウェブアプリケーション内のリソースへのディレクトリに似た形式ですべてのパスのリストを返します。
    サブディレクトリパスを示すパスは/で終わります。
    返されるパスは/から始まる、ウェブアプリケーションのルートからの相対パス、もしくはウェブアプリケーションの/WEB-INF/libディレクトリ内のJARファイルの/META-INF/resourcesディレクトリからの相対パスです。
    返されたSetはServletContextオブジェクトによって追跡されないため、返されたSetの変更はServletContextオブジェクトに反映されず、その逆もそうです。
    
    例として、ウェブアプリケーションが以下のとおりファイルを含むとします。
```
   /welcome.html
   /catalog/index.html
   /catalog/products.html
   /catalog/offers/books.html
   /catalog/offers/music.html
   /customer/login.jsp
   /WEB-INF/web.xml
   /WEB-INF/classes/com.acme.OrderServlet.class
   /WEB-INF/lib/catalog.jar!/META-INF/resources/catalog/moreOffers/books.html
 
```
    getResourcePaths("/")は {"/welcome.html", "/catalog/", "/customer/", "/WEB-INF/"}を返し、 getResourcePaths("/catalog/")は {"/catalog/index.html", "/catalog/products.html", "/catalog/offers/", "/catalog/moreOffers/"}を返すでしょう。
    パラメータ:
    
    path - /から始まる必要のあるマッチしたリソースで使用されている部分的なパス
    
    戻り値:
    
    ディレクトリ内を一覧化したものを含むSet、ウェうアプリケーション内に指定されたパスで始まるリソースが存在しない場合はnull a Set containing the directory listing, or null if there are no resources in the web application whose path begins with the supplied path.
    
    導入されたバージョン:
    
    Servlet 2.3
  - getResource
```
URL getResource(String path)
         throws MalformedURLException
```
    指定されたパスにマッピングされたリソースへのURLを返します。
    パスは/で始まり、現在のコンテキストルートからの相対パスとして解決できるかウェブアプリケーションの/WEB-INF/libディレクトリ内のJARファイルの/META-INF/resourcesディレクトリからの相対パスである必要があります。このメソッドはリクエストされたリソースを探すのに、最初にウェブアプリケーションのドキュメントルートを参照します。次に/WEB-INF/libの中のJARファイルの中身を参照します。 /WEB-INF/libの中のJARファイルを探す順番は未定義です。
    このメソッドを使用するとサーブレットコンテナは任意のソースからサーブレットでリソースを使用できるようになります。リソースは、ローカルやリモートのファイルシステム、データベース、.warファイル内に配置できます。
    サーブレットコンテナはリソースにアクセスするために必要なURLハンドラやURLConnectionオブジェクトを実装する必要があります。
    このメソッドはパスにリソースがマップされていない場合はnullを返します。
    一部のコンテナではURLクラスのメソッドを使用することでこのメソッドから返されたURLに書き込むことができます。
    リソースの内容が直接返されるため、.jspページを要求するとJSPのソースコードが返されることに注意してください。実行結果をインクルードするには代わりにRequestDispatcherを使用します。
    このメソッドはクラスローダーをベースにリソースを探すjava.lang.Class.getResourceとは目的が違います。このメソッドはクラスローダーを使用しません。
    
    パラメータ:
    
    path - リソースのパスを示すString
    
    戻り値:
    
    パスの位置のリソース、そのパスにリソースが存在しない場合はnull
    
    例外:
    
    MalformedURLException - パスが正しい形式でなかった
  - getResourceAsStream
```
InputStream getResourceAsStream(String path)
```
    パスの所在地のリソースをInputStreamオブジェクトとして返します。
    InputStream内のデータはどのようなタイプでも長さでもできます。パスはgetResourceと同じルールに従って指定される必要があります。このメソッドは指定されたパスにリソースが存在しない場合はnullを返します。
    getResourceメソッドで使用可能なコンテンツタイプやコンテンツの長さなどのようなメタ情報はこのメソッドを使用すると失われます。
    サーブレットコンテナはリソースにアクセスするために必要なURLハンドラやURLConnectionオブジェクトを実装する必要があります。
    このメソッドはクラスローダーを使用するjava.lang.Class.getResourceAsStreamとは違います。このメソッドはサーブレットコンテナにクラスローダーを使用せずに任意の場所からサーブレットでリソースを利用できるようにします。
    
    パラメータ:
    
    path - リソースのパスを示すString
    
    戻り値:
    
    サーブレットに返すInputStream、指定されたパスにリソースが存在しない場合はnull
  - getRequestDispatcher
```
RequestDispatcher getRequestDispatcher(String path)
```
    指定されたパスにあるリソースのラッパーとして機能するRequestDispatcherのオブジェクトを返します。 RequestDispatcherオブジェクトを使用することでリクエストを別のリソースに転送したり、リソースをレスポンスに含めることができます。リソースは動的なものでも静的なものでもかまいません。
    指定されたパス名は/で始まる必要があり、現在のコンテキストルートからの相対パスとして解釈されます。
    このメソッドはServletContextがRequestDispatcherを返せなかった場合はnullを返します。
    
    パラメータ:
    
    path - リソースのパス名を示すString
    
    戻り値:
    
    指定されたパスにあるリソースのラッパーとして機能するRequestDispatcherのオブジェクト、 ServletContextがRequestDispatcherを返せなかった場合はnull
    
    関連項目:
    
    RequestDispatcher, getContext(java.lang.String)
  - getNamedDispatcher
```
RequestDispatcher getNamedDispatcher(String name)
```
    指定された名前のサーブレットのラッパーとして動作するRequestDispatcherオブジェクトを返します。
    サーブレット(およびJSPページ)にはサーバー管理やウェブアプリケーションのデプロイメントディスクリプタを使用して名前を付けることができます。サーブレットのインスタンスはServletConfig.getServletName()を使用してその名前を取得できます。
    このメソッドはServletContextが何らかの理由でRequestDispatcherを返せなかった場合はnullを返します。
    
    パラメータ:
    
    name - ラップするサーブレットの名前を示すString
    
    戻り値:
    
    指定された名前のサーブレットのラッパーとして動作するRequestDispatcherオブジェクト、 ServletContextがRequestDispatcherを返せなかった場合はnull
    
    関連項目:
    
    RequestDispatcher, getContext(java.lang.String), ServletConfig.getServletName()
  - getServlet
```
@Deprecated
Servlet getServlet(String name)
                        throws ServletException
```
    非推奨です。 Java Servlet API 2.1以降での直接の代替手段はありません。
    このメソッドはもともとはServletContextからサーブレットを受け取るために定義されていました。このバージョンでは、このメソッドは必ずnullを返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。
    このメソッドの代わりに、サーブレットはServletContextクラスを利用して情報を共有し、一般的なサーブレットでないクラスのメソッドを呼び出すことで共有したビジネスロジックを実行できます。 In lieu of this method, servlets can share information using the ServletContext class and can perform shared business logic by invoking methods on common non-servlet classes.
    
    パラメータ:
    
    name - サーブレットの名前
    
    戻り値:
    
    指定された名前の javax.servlet.Servlet Servlet
    
    例外:
    
    ServletException - サーブレットの通常の処理で例外が発生した
  - getServlets
```
@Deprecated
Enumeration<Servlet> getServlets()
```
    非推奨です。 Java Servlet API 2.0以降での代替手段はありません。
    このメソッドはもともとはServletContextに登録されたすべてのサーブレットのEnumerationを返すものとして定義されていました。このバージョンでは、このメソッドは必ず空のEnumerationを返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。
    
    戻り値:
    
    javax.servlet.Servlet ServletのEnumeration
  - getServletNames
```
@Deprecated
Enumeration<String> getServletNames()
```
    非推奨です。 Java Servlet API 2.1以降での代替手段はありません。
    このメソッドはもともとはServletContextに登録されたすべてのサーブレット名前のEnumerationを返すものとして定義されていました。このバージョンでは、このメソッドは必ず空のEnumerationを返し、バイナリ互換性のためにのみ残されています。このメソッドはJava Servlet APIの未来のバージョンでは完全に削除される予定です。
    
    戻り値:
    
    javax.servlet.Servlet Servletの名前のEnumeration
  - log
```
void log(String msg)
```
    指定されたメッセージをログファイルに書き込みます、通常はイベントログです。ログファイルの名前と書式はサーブレットコンテナによって固有のものです。
    
    パラメータ:
    
    msg - ログファイルに書き込まれるメッセージを示すString
  - log
```
@Deprecated
void log(Exception exception,
                     String msg)
```
    非推奨です。 Java Servlet API 2.1から代わりに log(String message, Throwable throwable) を使用してください
    このメソッドはもともとは例外のスタックトレースと例外の説明文をサーブレットのログファイルに書き込むために定義されていました。
    
    パラメータ:
    
    exception - Exception エラー
    
    msg - 例外を説明するString
  - log
```
void log(String message,
         Throwable throwable)
```
    サーブレットのログファイルに指定されたThrowableに対する説明文とスタックトレースを書き込みます。ログファイルの名前と書式はサーブレットコンテナによって固有のものですが、通常はイベントログです。
    
    パラメータ:
    
    message - エラーや例外を説明するString
    
    throwable - エラーは例外のThrowable
  - getRealPath
```
String getRealPath(String path)
```
    指定された仮想のパスに対応する実際のパスを返します。
    例えば、pathがリクエストからの形式がhttp://<host>:<port>/<contextPath>/index.html (<contextPath>はこのServletContextに対応するコンテキストパス)にマップされている/index.htmlと等しいとき、このメソッドはサーバーのファイルシステムの絶対ファイルパスを返すでしょう。
    返される実際のパスは適切なパス区切り文字を含め、サーブレットコンテナが実行されているコンピュータとオペレーティングシステムに適した形式になります。
    アプリケーションの/WEB-INF/libディレクトリ内にバンドルされるJARファイル内の/META-INF/resources に含まれるリソースはコンテナが含まれるJARファイルをアンパックしたときにのみ考慮される必要があります。その場合は、パスとしてアンパックされた位置が返されるべきです。
    サーブレットコンテナが指定された指定された仮想のパスを実際のパスに変換できなかった場合はnullを返します。
    
    パラメータ:
    
    path - 実際のパスに変換する仮想のパス
    
    戻り値:
    
    実際のパス、変換が動作しない場合はnull
  - getServerInfo
```
String getServerInfo()
```
    サーブレットが動作しているサーブレットコンテナの名前とバージョンを返します。
    返される文字列の形式はservername/versionnumberです。例えば、JavaServer Web Development KitはJavaServer Web Dev Kit/1.0を返します。
    サーブレットコンテナはプライマリ文字列の後ろのカッコ内にJavaServer Web Dev Kit/1.0 (JDK 1.1.6; Windows NT 4.0 x86) のように追加の情報を出力するかもしれません。
    
    戻り値:
    
    最低でもサーブレットコンテナの名前とバージョン番号が含まれるString
  - getInitParameter
```
String getInitParameter(String name)
```
    指定されたコンテキスト全体のための初期化パラメーターの値を含むString を返します。パラメーターが存在しない場合はnullを返します。
    このメソッドは、ウェブアプリケーション全体に有用な設定情報を利用可能にすることができます。たとえば、ウェブマスターの電子メールアドレスまたは重要なデータを保持するシステムの名前を提供することができます。
    
    パラメータ:
    
    name - 値が要求されているパラメーターの名前を含むString
    
    戻り値:
    
    コンテキストの初期化パラメーターの値を含むString。コンテキストの初期化パラメーターが存在しない場合はnull
    
    例外:
    
    NullPointerException - 引数のnameがnull
    
    関連項目:
    
    ServletConfig.getInitParameter(java.lang.String)
  - getInitParameterNames
```
Enumeration<String> getInitParameterNames()
```
    コンテキストの初期化パラメーターの名前をStringオブジェクトのEnumerationとして返します。コンテキストに初期化パラメーターがない場合は空のEnumerationを返します。
    
    戻り値:
    
    コンテキストの初期化パラメーターの名前を含むStringオブジェクトのEnumeration
    
    関連項目:
    
    ServletConfig.getInitParameter(java.lang.String)
  - setInitParameter
```
boolean setInitParameter(String name,
                         String value)
```
    このServletContextのコンテキスト初期化パラメーターの値を指定された名前で設定します。
    
    パラメータ:
    
    name - 設定するコンテキスト初期化パラメーターの名前
    
    value - 設定するコンテキスト初期化パラメーターの値
    
    戻り値:
    
    このServletContextのコンテキスト初期化パラメーターを指定された名前と値で正常に設定できた場合はtrue、 ServletContextにすでに指定された名前で値がすでに存在していた場合は設定できずfalse
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了していた場合
    
    NullPointerException - パラメーターの名前がnull
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getAttribute
```
Object getAttribute(String name)
```
    指定された名前のサーブレットコンテナの属性を返します。属性が存在しない場合はnullを返します。
    属性を使用することでサーブレットコンテナはこのインターフェースによってまだ提供されていない追加情報をサーブレットに与えることができます。属性の情報についてはサーバーのドキュメントを参照してください。サポートされている属性の一覧はgetAttributeNamesを使用して取得できます。
    属性はjava.lang.Objectか、そのサブクラスとして返されます。
    属性名は、パッケージ名と同じ規則に従う必要があります。 Java Servlet API specificationではjava.*、javax.*、sun.*と一致する名前を予約しています。
    
    パラメータ:
    
    name - 属性の名前を指定するString
    
    戻り値:
    
    属性の値を含むObject、指定された名前と一致する属性が存在しない場合はnull
    
    例外:
    
    NullPointerException - 引数のnameがnull
    
    関連項目:
    
    getAttributeNames()
  - getAttributeNames
```
Enumeration<String> getAttributeNames()
```
    このServletContextで使用可能な属性の名前の含まれたEnumerationを返します。
    属性の名前から値を取得するためにはgetAttribute(java.lang.String)メソッドを使用してください。
    
    戻り値:
    
    属性の名前のEnumeration
    
    関連項目:
    
    getAttribute(java.lang.String)
  - setAttribute
```
void setAttribute(String name,
                  Object object)
```
    このServletContextに指定された属性の名前でオブジェクトを設定します。もし指定された名前がすでに属性として使用されている場合は、このメソッドは新しい属性として置き換えます。
    ServletContextにリスナーが設定されている場合、コンテナはリスナーに応じてそれらを通知します。
    もし値としてnullが渡された場合、removeAttribute()を呼び出した場合と同じ効果を及ぼします。
    属性名は、パッケージ名と同じ規則に従う必要があります。 Java Servlet API specificationではjava.*、javax.*、sun.*と一致する名前を予約しています。
    
    パラメータ:
    
    name - 属性の名前を指定するString
    
    object - 属性に設定する値を表すObject
    
    例外:
    
    NullPointerException - パラメーター名がnull
  - removeAttribute
```
void removeAttribute(String name)
```
    このServletContextから指定された名前の属性を取り除きます。取り除かれた後、続いてgetAttribute(java.lang.String)を呼び出して属性の値を取得しようとするとnullを返すでしょう。
    ServletContextにリスナーが設定されている場合、コンテナはリスナーに応じてそれらを通知します。
    
    パラメータ:
    
    name - 取り除かれる属性の名前を指定するString
  - getServletContextName
```
String getServletContextName()
```
    ウェブアプリケーションのデプロイメントディスクリプタのdisplay-name要素で指定されているこのServletContext に対応するこのウェブアプリケーションの名前を返します。
    
    戻り値:
    
    このウェブアプリケーションの名前、デプロイメントディスクリプタで宣言されてない場合はnull
    
    導入されたバージョン:
    
    Servlet 2.3
  - addServlet
```
ServletRegistration.Dynamic addServlet(String servletName,
                                       String className)
```
    このServletContextに指定された名前とクラス名でサーブレットを追加します。
    登録されたサーブレットは返されたServletRegistrationオブジェクトで詳細な設定を行うこともできます。
    指定されたclassNameはこのサーブレットコンテキストに対応するウェブアプリケーションに関連付けられたクラスローダーを使用してロードされます。
    ServletContextが指定されたservletNameのサーブレットのための準備段階のServletRegistrationをすでに含んでいた場合、 ServletRegistrationは(指定されたclassNameを割り当てることで)完了し、返します。
    このメソッドは指定されたclassNameのクラスについている ServletSecurity、 MultipartConfig、 javax.annotation.security.RunAs、 javax.annotation.security.DeclareRolesアノテーションの情報を読み取り、処理します。加えて、このメソッドは指定されたclassNameがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    パラメータ:
    
    servletName - サーブレットの名前
    
    className - サーブレットの完全修飾クラス名(FQCN)
    
    戻り値:
    
    登録されたサーブレットを詳細に設定するためのServletRegistrationオブジェクト、 ServletContextにすでに指定されたservletNameのサーブレットのためのServletRegistrationが完了したものが含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - servletNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addServlet
```
ServletRegistration.Dynamic addServlet(String servletName,
                                       Servlet servlet)
```
    指定されたサーブレットのインスタンスをこのServletContextに指定されたservletNameの下で登録します。
    登録されたサーブレットは返されたServletRegistrationオブジェクトで詳細に設定することができます。
    ServletContextが指定されたservletNameのサーブレットのための準備段階のServletRegistrationをすでに含んでいた場合、 ServletRegistrationは(指定されたサーブレットのインスタンスを指定されたclassNameで割り当てることで)完了し、返します。
    
    パラメータ:
    
    servletName - サーブレットの名前
    
    servlet - 登録するサーブレットのインスタンス
    
    戻り値:
    
    指定されたサーブレットを詳細に設定するために使用されるServletRegistrationのオブジェクト、 ServletContextが指定されたservletNameのサーブレットのための完了したServletRegistrationを含んでいる場合や同じサーブレットのインスタンスがこのServletContextや同じコンテナのほかのServletContextにすでに含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    IllegalArgumentException - 指定されたサーブレットのインスタンスがSingleThreadModelを実装しているか、servletNameがnullもしくは空の文字列
    
    導入されたバージョン:
    
    Servlet 3.0
  - addServlet
```
ServletRegistration.Dynamic addServlet(String servletName,
                                       Class<? extends Servlet> servletClass)
```
    指定された名前とクラスタイプをこのServletContextに追加します。
    登録されたサーブレットは返されたServletRegistrationオブジェクトで詳細に設定することができます。
    ServletContextが指定されたservletNameのサーブレットのための準備段階のServletRegistrationをすでに含んでいた場合、 ServletRegistrationは(指定されたservletClassをclassNameで割り当てることで)完了し、返します。
    このメソッドは指定されたservletClassについている ServletSecurity、 MultipartConfig、 javax.annotation.security.RunAs、 javax.annotation.security.DeclareRolesアノテーションの情報を読み取り、処理します。加えて、このメソッドは指定されたclassNameがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    パラメータ:
    
    servletName - サーブレットの名前
    
    servletClass - インスタンス化されるサーブレットのクラスオブジェクト
    
    戻り値:
    
    登録されたサーブレットを詳細に設定するためのServletRegistrationオブジェクト、 ServletContextにすでに指定されたservletNameのサーブレットのためのServletRegistrationが完了したものが含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - servletNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addJspFile
```
ServletRegistration.Dynamic addJspFile(String servletName,
                                       String jspFile)
```
    指定されたJSPファイルのサーブレットをこのServletContextに追加します。
    登録されたサーブレットは返されたServletRegistrationオブジェクトで詳細に設定することができます。
    ServletContextが指定されたservletNameのサーブレットのための準備段階のServletRegistrationをすでに含んでいた場合、 ServletRegistrationは(指定されたjspFileを割り当てることで)完了し、返します。
    
    パラメータ:
    
    servletName - サーブレットの名前
    
    jspFile - "/"で始まるウェブアプリケーション内のJSPファイルのフルパス
    
    戻り値:
    
    登録されたサーブレットを詳細に設定するためのServletRegistrationオブジェクト、 ServletContextにすでに指定されたservletNameのサーブレットのためのServletRegistrationが完了したものが含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - servletNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - createServlet
```
<T extends Servlet> T createServlet(Class<T> clazz)
                             throws ServletException
```
    指定されたサーブレットクラスをインスタンス化します。
    返されたサーブレットのインスタンスはServletContextのaddServlet(String,Servlet)を呼び出して登録する前に詳細なカスタマイズができます。
    指定されたサーブレットはインスタンス化するために使用される引数のないコンストラクタが定義されている必要があります。
    このメソッドは指定されたclazzについている ServletSecurity、 MultipartConfig、 javax.annotation.security.RunAs、 javax.annotation.security.DeclareRolesアノテーションの情報を読み取り、処理します。加えて、このメソッドは指定されたclazzがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    型パラメータ:
    
    T - 作られるサーブレットのクラス
    
    パラメータ:
    
    clazz - インスタンス化されるサーブレットクラス
    
    戻り値:
    
    新しいサーブレットのインスタンス
    
    例外:
    
    ServletException - 指定されたclazzのインスタンス化に失敗した
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getServletRegistration
```
ServletRegistration getServletRegistration(String servletName)
```
    指定されたservletNameのサーブレットに対応するServletRegistrationを取得します。
    
    パラメータ:
    
    servletName - サーブレットの名前
    
    戻り値:
    
    指定されたservletNameのサーブレットの(完了、もしくは準備段階の)ServletRegistration、その名前の下でServletRegistrationが存在しない場合はnull
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getServletRegistrations
```
Map<String,? extends ServletRegistration> getServletRegistrations()
```
    このServletContextに登録されているすべてのサーブレットに対応する(サーブレットの名前がキーで空の可能性のある)ServletRegistrationオブジェクトのMapを取得します。
    返されたMapは設定ファイルで定義されたサーブレットやアノテーションが付けられたサーブレットに対応するServletRegistrationオブジェクトと同じように addServletメソッドのいずれかや addJspFileメソッドで追加されたすべてに対応するすべてのServletRegistrationオブジェクトを含みます。
    許可されている場合、返されたMapへの変更はこのServletContextに影響してはなりません。
    
    戻り値:
    
    このServletContextに現在登録されているすべてのサーブレットに対応する(完了、もしくは準備段階の)ServletRegistrationオブジェクトのMap
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addFilter
```
FilterRegistration.Dynamic addFilter(String filterName,
                                     String className)
```
    このServletContextに指定された名前とクラス名でフィルターを追加します。
    登録されたフィルターは返されたFilterRegistrationオブジェクトで詳細な設定を行うこともできます。
    指定されたclassNameはこのサーブレットコンテキストに対応するウェブアプリケーションに関連付けられたクラスローダーを使用してロードされます。
    ServletContextが指定されたfilterNameのフィルターのための準備段階のFilterRegistrationをすでに含んでいた場合、 FilterRegistrationは(指定されたclassNameを割り当てることで)完了し、返します。
    このメソッドは指定されたclassNameのクラスがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    パラメータ:
    
    filterName - フィルターの名前
    
    className - フィルターの完全修飾クラス名(FQCN)
    
    戻り値:
    
    登録されたフィルターを詳細に設定するためのFilterRegistrationオブジェクト、 ServletContextにすでに指定されたfilterNameのフィルターのためのFilterRegistrationが完了したものが含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - filterNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addFilter
```
FilterRegistration.Dynamic addFilter(String filterName,
                                     Filter filter)
```
    指定されたフィルターのインスタンスをこのServletContextに指定されたfilterNameの下で登録します。
    登録されたフィルターは返されたFilterRegistrationオブジェクトで詳細に設定することができます。
    ServletContextが指定されたfilterNameのフィルターのための準備段階のFilterRegistrationをすでに含んでいた場合、 FilterRegistrationは(指定されたフィルターのインスタンスを指定されたclassNameで割り当てることで)完了し、返します。
    
    パラメータ:
    
    filterName - フィルターの名前
    
    filter - 登録されるフィルターのインスタンス
    
    戻り値:
    
    指定されたフィルターを詳細に設定するために使用されるFilterRegistrationのオブジェクト、 ServletContextが指定されたfilterNameのフィルターのための完了したFilterRegistrationを含んでいる場合や同じフィルターのインスタンスがこのServletContextや同じコンテナのほかのServletContextにすでに含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - filterNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addFilter
```
FilterRegistration.Dynamic addFilter(String filterName,
                                     Class<? extends Filter> filterClass)
```
    指定された名前とクラスタイプをこのServletContextに追加します。
    登録されたフィルターは返されたFilterRegistrationオブジェクトで詳細に設定することができます。
    ServletContextが指定されたfilterClassのフィルターのための準備段階のFilterRegistrationをすでに含んでいた場合、 FilterRegistrationは(指定されたfilterClassの名前で割り当てることで)完了し、返します。
    このメソッドは指定されたfilterClassがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    パラメータ:
    
    filterName - フィルターの名前
    
    filterClass - インスタンス化されるフィルターのクラスオブジェクト
    
    戻り値:
    
    登録されたフィルターを詳細に設定するためのFilterRegistrationオブジェクト、 ServletContextにすでに指定されたfilterNameのフィルターのためのFilterRegistrationが完了したものが含まれている場合はnull
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    IllegalArgumentException - filterNameがnullもしくは空の文字列
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - createFilter
```
<T extends Filter> T createFilter(Class<T> clazz)
                           throws ServletException
```
    指定されたフィルタークラスをインスタンス化します。
    返されたフィルターのインスタンスはServletContextのaddFilter(String,Filter)を呼び出して登録する前に詳細なカスタマイズができます。
    指定されたフィルターはインスタンス化するために使用される引数のないコンストラクタが定義されている必要があります。
    このメソッドは指定されたclazzがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    型パラメータ:
    
    T - 作られるフィルターのクラス
    
    パラメータ:
    
    clazz - インスタンス化されるフィルタークラス
    
    戻り値:
    
    新しいフィルターのインスタンス
    
    例外:
    
    ServletException - 指定されたclazzのインスタンス化に失敗した
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getFilterRegistration
```
FilterRegistration getFilterRegistration(String filterName)
```
    指定されたfilterNameのフィルターに対応するFilterRegistrationを取得します。
    
    パラメータ:
    
    filterName - フィルターの名雨
    
    戻り値:
    
    指定されたfilterNameのフィルターの(完了、もしくは準備段階の)FilterRegistration、その名前の下でFilterRegistrationが存在しない場合はnull
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getFilterRegistrations
```
Map<String,? extends FilterRegistration> getFilterRegistrations()
```
    このServletContextに登録されているすべてのフィルターに対応する(フィルターの名前がキーで空の可能性のある)FilterRegistrationオブジェクトのMapを取得します。
    返されたMapは設定ファイルで定義されたフィルターやアノテーションが付けられたフィルターに対応するFilterRegistrationオブジェクトと同じように addFilterメソッドのいずれかで追加されたすべてに対応するすべてのFilterRegistrationオブジェクトを含みます。
    返されたMapへの変更はこのServletContextに影響してはなりません。
    
    戻り値:
    
    このServletContextに現在登録されているすべてのフィルターに対応する(完了、もしくは準備段階の)FilterRegistrationオブジェクトのMap
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getSessionCookieConfig
```
SessionCookieConfig getSessionCookieConfig()
```
    このServletContextのために作成されるセッション追跡Cookieのさまざまなプロパティを設定する事ができるSessionCookieConfigオブジェクトを取得します。
    このメソッドを繰り返し読んだ場合、SessionCookieConfigの同じインスタンスが返されます。
    
    戻り値:
    
    このServletContextのために作成されるセッション追跡Cookieのさまざまなプロパティを設定する事ができるSessionCookieConfigオブジェクトを取得します。
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - setSessionTrackingModes
```
void setSessionTrackingModes(Set<SessionTrackingMode> sessionTrackingModes)
```
    このServletContextで有効になるセッション追跡方法を設定します。
    指定されたsessionTrackingModesはこのServletContextのこのメソッドの以前の呼び出しによって設定されたセッション追跡モードを置き換えます。
    
    パラメータ:
    
    sessionTrackingModes - このServletContextで有効になるセッション追跡方法
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    IllegalArgumentException - sessionTrackingModesでSessionTrackingMode.SSLがSessionTrackingMode.SSL以外のセッション追跡方法と組み合わせて指定された、サーブレットコンテナでサポートされていないセッション追跡方法をsessionTrackingModesで指定した
    
    導入されたバージョン:
    
    Servlet 3.0
  - getDefaultSessionTrackingModes
```
Set<SessionTrackingMode> getDefaultSessionTrackingModes()
```
    このServletContextでデフォルトでサポートされるセッション追跡方法を取得します。
    ServletContextオブジェクトによって返されたSetはServletContextへの参照を持っていないので変更はServletContextへ影響を与えません。逆もそうです。
    
    戻り値:
    
    このServletContextでデフォルトでサポートされるセッション追跡方法
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getEffectiveSessionTrackingModes
```
Set<SessionTrackingMode> getEffectiveSessionTrackingModes()
```
    このServletContextで有効なセッション追跡方法を取得します。有効なセッション追跡方法はsetSessionTrackingModesで提供されています。
    ServletContextオブジェクトによって返されたSetはServletContextへの参照を持っていないので変更はServletContextへ影響を与えません。逆もそうです。
    
    戻り値:
    
    このServletContextで有効なセッション追跡方法
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addListener
```
void addListener(String className)
```
    このServletContextに指定されたクラスの名前のリスナーを追加します。
    指定された名前のクラスはこのサーブレットコンテキストに対応するウェブアプリケーションのクラスローダーからロードされ、以下のインターフェースのうち一つ以上を実装する必要があります。
    このServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡されている場合、指定された名前のクラスは先に一覧化されたインターフェースに加えてServletContextListenerを実装することもできます。
    このメソッド呼び出しの一環として、コンテナは指定されたクラス名を持つ必要なインターフェイスの1つが実装されていることを保証されたクラスをロードする必要があります。
    指定された名前のクラスが呼び出される順序が宣言した順序に対応するリスナーのインターフェースを実装している場合 (つまり、ServletRequestListener、ServletContextListener、HttpSessionListenerを実装している場合) 新しいリスナーはそのインターフェースのリスナーの順序付きリストの最後に追加されます。
    このメソッドは指定されたclassNameがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    パラメータ:
    
    className - the fully qualified class name of the listener
    
    例外:
    
    IllegalArgumentException - 指定された名前のクラスが先のインターフェースを全く実装していない、 ServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡された時に指定された名前のクラスがServletContextListenerを実装していない
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addListener
```
<T extends EventListener> void addListener(T t)
```
    指定されたリスナーをこのServletContextに追加します。
    指定されたリスナーは以下のインターフェースのうち一つ以上を実装する必要があります。
    このServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡されている場合、指定されたリスナーは先に一覧化されたインターフェースに加えてServletContextListenerを実装することもできます。
    指定されたリスナーが呼び出される順序が宣言した順序に対応するリスナーのインターフェースを実装している場合 (つまり、ServletRequestListener、ServletContextListener、HttpSessionListenerを実装している場合) 新しいリスナーはそのインターフェースのリスナーの順序付きリストの最後に追加されます。
    型パラメータ:
    
    T - 追加されるEventListenerのクラス
    
    パラメータ:
    
    t - 追加されるリスナー
    
    例外:
    
    IllegalArgumentException - 指定されたリスナーが先のインターフェースを全く実装していない、 ServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡された時に指定されたリスナーがServletContextListenerを実装していない
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - addListener
```
void addListener(Class<? extends EventListener> listenerClass)
```
    指定されたクラスの型のリスナーをこのServletContextに追加します。
    指定されたlistenerClassは以下のインターフェースのうち一つ以上を実装する必要があります。
    このServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡されている場合、指定されたlistenerClassは先に一覧化されたインターフェースに加えてServletContextListenerを実装することもできます。
    指定されたlistenerClassが呼び出される順序が宣言した順序に対応するリスナーのインターフェースを実装している場合 (つまり、ServletRequestListener、ServletContextListener、HttpSessionListenerを実装している場合) 新しいリスナーはそのインターフェースのリスナーの順序付きリストの最後に追加されます。
    このメソッドは指定されたlistenerClassがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    パラメータ:
    
    listenerClass - インスタンス化されるリスナークラス
    
    例外:
    
    IllegalArgumentException - 指定されたlistenerClassが先のインターフェースを全く実装していない、 ServletContextがServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext)に渡された時に指定されたlistenerClassがServletContextListenerを実装していない
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - createListener
```
<T extends EventListener> T createListener(Class<T> clazz)
                                    throws ServletException
```
    指定されたEventListenerクラスをインスタンス化します。
    指定したEventListenerのクラスは ServletContextListener、 ServletContextAttributeListener、 ServletRequestListener、 ServletRequestAttributeListener、 HttpSessionAttributeListener、 HttpSessionIdListener、 HttpSessionListener のインターフェースのうち最低でも一つ実装する必要があります。
    返されたEventListenerインスタンスはaddListener(EventListener)の呼び出しによってこのServletContextに登録する前に、詳細なカスタマイズをすることができます。
    指定されたEventListenerクラスはインスタンス化に使用するための引数を持たないコンストラクタが定義されている必要があります。
    このメソッドは指定されたclazzがマネージドビーンを表す場合、リソースインジェクションをサポートします。マネージドビーンとリソースインジェクションについての詳細はJava EEプラットフォームとJSR 299の仕様を参照してください。
    
    型パラメータ:
    
    T - 作成されるEventListenerのクラス
    
    パラメータ:
    
    clazz - インスタンス化されるEventListenerクラス
    
    戻り値:
    
    新しいEventListenerのインスタンス
    
    例外:
    
    ServletException - 指定されたclazzのインスタンス化に失敗した
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    IllegalArgumentException - 指定したEventListenerのクラスが ServletContextListener、 ServletContextAttributeListener、 ServletRequestListener、 ServletRequestAttributeListener、 HttpSessionAttributeListener、 HttpSessionIdListener、 HttpSessionListener のいずれのインターフェースも実装していなかった場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getJspConfigDescriptor
```
JspConfigDescriptor getJspConfigDescriptor()
```
    このServletContextに対応するウェブアプリケーションのweb.xmlとweb-fragment.xmlディスクリプターファイルから集約された<jsp-config>に関連する設定を取得します。
    
    戻り値:
    
    このServletContextに対応するウェブアプリケーションのweb.xmlとweb-fragment.xmlディスクリプターファイルから集約された<jsp-config>に関連する設定、そのような設定が存在しない場合はnull
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.0
    
    関連項目:
    
    JspConfigDescriptor
  - getClassLoader
```
ClassLoader getClassLoader()
```
    このサーブレットコンテキストに対応するウェブアプリケーションのクラスローダーを取得します。
    セキュリティマネージャが存在し、呼び出し元のクラスローダーが要求されたクラスローダーと同じか継承元でない場合、セキュリティマネージャのcheckPermissionメソッドはRuntimePermission("getClassLoader")のパーミッションでクラスローダーへのアクセス権が付与されているかどうかチェックをするために呼び出されます。
    
    戻り値:
    
    このサーブレットコンテキストに対応するウェブアプリケーションのクラスローダー
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    SecurityException - セキュリティマネージャーがクラスローダーへのアクセスのリクエストを拒否した
    
    導入されたバージョン:
    
    Servlet 3.0
  - declareRoles
```
void declareRoles(String... roleNames)
```
    isUserInRoleでの検証に使用されるロール名を定義します。
    ServletRegistrationのsetServletSecurityメソッドや、 setRunAsRoleメソッドの呼び出しの結果、暗黙的に定義されているロールを定義する必要はありません。
    
    パラメータ:
    
    roleNames - 定義されるロール名
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    IllegalArgumentException - 引数のロール名のいずれかがnullかからの文字列だった
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    導入されたバージョン:
    
    Servlet 3.0
  - getVirtualServerName
```
String getVirtualServerName()
```
    ServletContextがデプロイされている論理ホストの設定名を返します。サーブレットコンテナは複数の論理ホストをサポートすることができます。このメソッドでは論理ホスト上に配置されているすべてのサーブレットコンテキストに同じ名前を返され、このメソッドによって返された名前は論理ホストごとに安定してまったく別であり、、サーバー構成情報と論理ホストの関連付けに使用するのに適しています。返される値は、論理ホストのネットワークアドレスまたはホスト名と同等であることが要求されていません。 The returned value is NOT expected or required to be equivalent to a network address or hostname of the logical host.
    
    戻り値:
    
    ServletContextがデプロイされている論理ホストの設定名を含む String
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 3.1
  - getSessionTimeout
```
int getSessionTimeout()
```
    このServletContextでデフォルトでサポートするセッションがタイムアウトするまでの分を取得します。
    
    戻り値:
    
    このServletContextでデフォルトでサポートするセッションがタイムアウトするまでの分
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - setSessionTimeout
```
void setSessionTimeout(int sessionTimeout)
```
    このServletContextにセッションがタイムアウトするまでの分を設定します。
    
    パラメータ:
    
    sessionTimeout - セッションがタイムアウトする分
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - getRequestCharacterEncoding
```
String getRequestCharacterEncoding()
```
    このServletContextでデフォルトでサポートするレスポンスの文字エンコーディングを取得します。このメソッドはデプロイメントディスクリプタやコンテナ固有の(コンテナ上のすべてのアプリケーション向けの)設定でリクエストの文字エンコーディングが指定されていない場合はnullを返します。
    
    戻り値:
    
    このServletContextでデフォルトでサポートするリクエストの文字エンコーディング
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - setRequestCharacterEncoding
```
void setRequestCharacterEncoding(String encoding)
```
    このServletContextにリクエストの文字エンコーディングを設定します。
    
    パラメータ:
    
    encoding - リクエストの文字エンコーディング
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - getResponseCharacterEncoding
```
String getResponseCharacterEncoding()
```
    このServletContextでデフォルトでサポートするレスポンスの文字エンコーディングを取得します。このメソッドはデプロイメントディスクリプタやコンテナ固有の(コンテナ上のすべてのアプリケーション向けの)設定でレスポンスの文字エンコーディングが指定されていない場合はnullを返します。
    
    戻り値:
    
    このServletContextでデフォルトでサポートするレスポンスの文字エンコーディング
    
    例外:
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0
  - setResponseCharacterEncoding
```
void setResponseCharacterEncoding(String encoding)
```
    このServletContextにレスポンスの文字エンコーディングを設定します。
    
    パラメータ:
    
    encoding - レスポンスの文字エンコーディング
    
    例外:
    
    IllegalStateException - このServletContextが初期化完了している場合
    
    UnsupportedOperationException - このServletContextがweb.xmlやweb-fragment.xmlで宣言されておらず、 WebListenerアノテーションもついてないServletContextListenerの ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent)メソッドに渡された場合
    
    導入されたバージョン:
    
    Servlet 4.0

Copyright © 1999-2017, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms. Portions Copyright © 1999-2002 The Apache Software Foundation. Portions Copyright © 2017- @megascus. Translated by @megascus.

インタフェース ServletContext

フィールドのサマリー

メソッドのサマリー

フィールドの詳細

TEMPDIR

ORDERED_LIBS

メソッドの詳細

getContextPath

getContext

getMajorVersion

getMinorVersion

getEffectiveMajorVersion

getEffectiveMinorVersion

getMimeType

getResourcePaths

getResource

getResourceAsStream

getRequestDispatcher

getNamedDispatcher

getServlet

getServlets

getServletNames

log

log

log

getRealPath

getServerInfo

getInitParameter

getInitParameterNames

setInitParameter

getAttribute

getAttributeNames

setAttribute

removeAttribute

getServletContextName

addServlet

addServlet

addServlet

addJspFile

createServlet

getServletRegistration

getServletRegistrations

addFilter

addFilter

addFilter

createFilter

getFilterRegistration

getFilterRegistrations

getSessionCookieConfig

setSessionTrackingModes

getDefaultSessionTrackingModes

getEffectiveSessionTrackingModes

addListener

addListener

addListener

createListener

getJspConfigDescriptor

getClassLoader

declareRoles

getVirtualServerName

getSessionTimeout

setSessionTimeout

getRequestCharacterEncoding

setRequestCharacterEncoding

getResponseCharacterEncoding

setResponseCharacterEncoding