application  
 
変数名 :

application

 
インターフェイス名 :

javax.servlet.ServletContext

 
拡張するクラス :

なし

 
実装するクラス :

内部コンテナ固有のクラス

 
JSP ページタイプ :

通常の JSP ページとエラーページの両方で利用可能

 
説明

ServletContext は、Web アプリケーション内で共有されるリソースを提供します。また、JSP アプリケーションスコープを表す属性値を保持します。属性値は、任意の有効な Java クラスのインスタンスとすることができます。ServletContext は、JSP ページまたはサーブレットがそのコンテナと通信するために使用する一連のメソッドも定義します。たとえば、ファイルの MIME タイプの取得、要求のディスパッチ、ログファイルへの書き込みなどのメソッドです。Web コンテナは、ServletContext インターフェイスの実装を提供します。

ServletContext には、Web サーバー内の特定の URL パスの接頭辞が割り当てられます。たとえば、コンテキストは http://www.mycorp.com/catalog 以下のすべてのリソースを管理するなどです。/catalog 要求パスで始まるすべての要求は、コンテキストパス と呼ばれ、このサーブレットコンテキストにルーティングされます。

Web アプリケーション内のサーブレットと JSP ページで利用できるのは、ServletContext の 1 つのインスタンスのみです。Web アプリケーションが配布可能であることを示す場合、各 Java 仮想マシンでアプリケーションごとに 1 つのインスタンスの ServletContext オブジェクトのみが使用されている必要があります。

getAttribute( )  
public Object getAttribute(String name)

指定された名前のサーブレットコンテキスト属性を返します。その名前の属性がない場合は、null を返します。コンテキスト属性はサーブレットまたは JSP ページで設定でき、JSP アプリケーションスコープを表すことができます。コンテナは属性を使用して、既に利用できない情報をこのインターフェイスのメソッドを通じて提供することもできます。

getAttributeNames()  
public java.util.Enumeration getAttributeNames()

このサーブレットコンテキスト内で利用できる属性名を含む String オブジェクトの Enumeration を返します。

getContext()  
public ServletContext getContext(String uripath)

Web コンテナで指定された URL に対応する ServletContext オブジェクトを返します。このメソッドを使用すると、サーブレットと JSP ページは、それ自身のコンテキスト以外のコンテキストにアクセスできます。URI のパスは "/" で始まる絶対パスとする必要があり、コンテナのドキュメントルートを基に解釈されます。セキュリティを重視した環境では、コンテナは特定の URL に対して null を返すことがあります。

getInitParameter()  
public String getInitParameter(String name)

名前付きコンテキスト全体の初期化パラメータの値を含む String を返します。このパラメータが存在しない場合は null を返します。コンテキスト初期化パラメータは Web アプリケーションの実装記述子で定義できます。

getInitParameterNames()  
public java.util.Enumeration getInitParameterNames()

コンテキストの初期化パラメータの名前を、String オブジェクトの Enumeration として返します。コンテキストに初期化パラメータが含まれていない場合は、空の Enumeration を返します。

getMajorVersion()  
public int getMajorVersion()

Web コンテナがサポートする Java Servlet API のメジャーバージョンを返します。Servlet 2.3 API に準拠するコンテナは 2 を返します。

getMimeType()  
public String getMimeType(String filename)

指定されたファイルの MIME タイプを返します。MIME タイプが不明な場合は null を返します。MIME タイプは、Web コンテナの構成によって指定され、Web アプリケーションの実装記述子で指定できます。

getMinorVersion()  
public int getMinorVersion()

Web コンテナがサポートする Java サーブレット API のマイナーバージョンを返します。Servlet 2.3 API に準拠するコンテナは 3 を返します。

getNamedDispatcher()  
public RequestDispatcher getNamedDispatcher(String name)

名前付きサーブレットまたは JSP ページの折り返しとして機能する RequestDispatcher オブジェクトを返します。Web アプリケーションの実装記述子では、サーブレットと JSP ページの名前を定義できます。

getRealPath()  
public String getRealPath(String path)

指定されたコンテキスト相対パスのファイルシステムパスを含む String を返します。コンテキストが WAR アーカイブから利用可能になっているときなど、Web コンテナが何らかの理由でファイルシステムパスへのパスを変換できない場合、このメソッドは null を返します。

getRequestDispatcher()  
public RequestDispatcher getRequestDispatcher(String path)

指定されたコンテキスト相対パスにあるリソースの折り返しとして機能する RequestDispatcher オブジェクトを返します。このリソースは動的 (サーブレットまたは JSP) とするか、静的 (通常の HTML ファイル) とすることができます。

getResource()  
public java.net.URL getResource(String path) throws MalformedURLException

指定されたコンテキスト相対パスにマップされるリソースの URL を返します。このメソッドを使用すると、Web コンテナは、データベースや WAR ファイルなど、ローカルファイルシステム以外のソースからサーブレットや JSP ページに対してリソースを利用可能にできます。

URL はりソースコンテンツに直接アクセスできるようにするので、JSP ページを要求すると、処理された結果ではなく、JSP ソースコードの URL が返されます。この代わりに RequestDispatcher を使用して、実行結果を含めてください。

このメソッドは、パス名にリソースがマップされていない場合、null を返します。

getResourceAsStream()  
public java.io.InputStream getResourceAsStream(String path)

指定されたコンテキスト相対パスにマップされたリソースを、InputStream オブジェクトとして返します。詳細については、getResource() メソッドを参照してください。

getServerInfo()  
public String getServerInfo()

サーブレットまたは JSP ページが servername/versionnumber の形式で String として実行されているサーブレットコンテナの名前とバージョン (たとえば、Tomcat/3.2) を返します。コンテナは、Java のバージョンやオペレーティングシステム情報などの他の省略可能な情報を、かっこ内に含むことができます。

log( )  
public void log(String message)
public void log(String message, Throwable cause)

指定されたメッセージを Web コンテナログファイルに書き込むか、指定された Throwable の指定されたメッセージとスタックトレースをサーブレットログファイルに書き込みます。ログファイルの名前とタイプは、コンテナによって異なります。

setAttribute( )  
public void setAttribute(String name, Object attribute)

このサーブレットコンテキストの指定された属性名に、オブジェクトをバインドします。指定された名前が既に属性に使用されている場合、このメソッドは古い属性を削除し、名前を新しい属性にバインドします。

getServlet() 使用されません
public Servlet getServlet(String name) throws ServletException

このメソッドは、元々は ServletContext からサーブレットを取得するために定義されました。Servlet 2.1 API 時点では、このメソッドは常に null を返し、バイナリの互換性を保つ目的のためだけに残されています。このメソッドは、将来のバージョンの Java Servlet API では完全に削除されます。

getServlets() 使用されません
public Enumeration getServlets()

このメソッドは、元々はこのサーブレットコンテキストに対して既知のすべてのサーブレットの Enumeration を返すために定義されました。Servlet 2.1 API 時点では、このメソッドは常に空の Enumeration を返し、バイナリの互換性を保つ目的のためだけに残されています。このメソッドは、将来のバージョンの Java Servlet API では完全に削除されます。

getServletNames() 使用されません
public Enumeration getServletNames()

このメソッドは、元々はこのコンテキストに対して既知のすべてのサーブレット名の Enumeration を返すために定義されました。Servlet 2.1 時点では、このメソッドは常に空の Enumeration を返し、バイナリの互換性を保つ目的のためだけに残されています。このメソッドは、将来のバージョンの Java Servlet API では完全に削除されます。

log( ) 使用されません
public void log(Exception exception, String message)

このメソッドは、元々は例外のスタックトレースと説明のエラーメッセージを Web コンテナログファイルに書き込むために定義されました。Servlet 2.1 API 時点では、この代わりに log(String, Throwable) を使用することをお勧めします。