Mergedoc
Translation

javax.servlet
クラス GenericServlet

java.lang.Object
  上位を拡張 javax.servlet.GenericServlet
すべての実装されたインタフェース:
java.io.Serializable, Servlet, ServletConfig
直系の既知のサブクラス:
HttpServlet

public abstract class GenericServlet
extends java.lang.Object
implements Servlet, ServletConfig, java.io.Serializable

プロトコルに依存しない一般的な Servlet を定義しています。 Web サーバ上で使用する HTTP を扱う Servlet を記述するには、このクラスではなく HttpServlet を継承します。

GenericServletServletServletConfig インタフェースを実装しています。 HttpServlet のような特定のプロトコルに特化したサブクラスを継承する方法が一般的ですが、GenericServlet を Servlet が直接継承することもあります。

GenericServlet を使うと簡単に Servlet を記述できるようになります。 このクラスはライフサイクルに関係するメソッドである initdestroyServletConfig インタフェースのメソッドについては簡易的な実装を提供しています。 また、GenericServletServletContext インタフェースで定義されている log メソッドの実装も提供しています。

プロトコルに依存しない一般的な Servlet を記述するには、抽象メソッドの service をオーバライドするだけです。

作成者:
Various
関連項目:
直列化された形式

コンストラクタの概要
GenericServlet()
          なにも実行しません。
 
メソッドの概要
 void destroy()
          Servlet コンテナが呼び出すメソッドです。
 java.lang.String getInitParameter(java.lang.String name)
          name で指定された初期値を表す String を返します。
 java.util.Enumeration getInitParameterNames()
          ひとつの Servlet に設定されている初期値の名前を表す String オブジェクトの Enumeration を返します。
 ServletConfig getServletConfig()
          この Servlet の ServletConfig オブジェクトを返します。
 ServletContext getServletContext()
          この Servlet が動作している ServletContext への参照を返します。
 java.lang.String getServletInfo()
          作者、バージョン、著作権といった Servlet に関する情報を返します。
 java.lang.String getServletName()
          この Servlet のインスタンスの名前を返します。
 void init()
          利便性を考慮して提供されたメソッドです。
 void init(ServletConfig config)
          Servlet コンテナが呼び出すメソッドです。
 void log(java.lang.String msg)
          Servlet のログファイルに指定したメッセージを出力します。
 void log(java.lang.String message, java.lang.Throwable t)
          補足説明的なメッセージを出力しますが、Throwable 例外を与えられるスタックトレースもログファイルに出力します。
abstract  void service(ServletRequest req, ServletResponse res)
          Servlet コンテナが実行します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

GenericServlet

public GenericServlet()
なにも実行しません。Servlet の初期化は常に init メソッドの中で行います。

メソッドの詳細

destroy

public void destroy()
Servlet コンテナが呼び出すメソッドです。 この Servlet がサービス提供を停止するときに呼び出されます。 Servlet.destroy() を参照してください。

定義:
インタフェース Servlet 内の destroy

getInitParameter

public java.lang.String getInitParameter(java.lang.String name)
name で指定された初期値を表す String を返します。 該当する初期値が無い場合は null を返します。 ServletConfig.getInitParameter(java.lang.String) を参照してください。

このメソッドは利便性を考慮して提供されたものです。 実際には、各 Servlet が維持している ServletConfig オブジェクトから指定のパラメータ値を取得しています。

定義:
インタフェース ServletConfig 内の getInitParameter
パラメータ:
name - 初期値の名前を指定する String
戻り値:
String 初期値を表わす String

getInitParameterNames

public java.util.Enumeration getInitParameterNames()
ひとつの Servlet に設定されている初期値の名前を表す String オブジェクトの Enumeration を返します。 Servlet に初期値が設定されていない場合は空の Enumeration を返します。 ServletConfig.getInitParameterNames() を参照してください。

このメソッドは利便性を考慮して提供されたものです。 実際には、各 Servlet が維持している ServletConfig オブジェクトからパラメータ名前を取得しています。

定義:
インタフェース ServletConfig 内の getInitParameterNames
戻り値:
Enumeration ひとつの Servlet に設定されている初期値の名前を表す String オブジェクトの列挙

getServletConfig

public ServletConfig getServletConfig()
この Servlet の ServletConfig オブジェクトを返します。

定義:
インタフェース Servlet 内の getServletConfig
戻り値:
ServletConfig この Servlet を初期化した ServletConfig オブジェクト
関連項目:
Servlet.init(javax.servlet.ServletConfig)

getServletContext

public ServletContext getServletContext()
この Servlet が動作している ServletContext への参照を返します。 ServletConfig.getServletContext() を参照してください。

このメソッドは利便性を考慮して提供されたものです。 実際には、各 Servlet が維持している ServletConfig オブジェクトからコンテキストを取得しています。

定義:
インタフェース ServletConfig 内の getServletContext
戻り値:
ServletContext init メソッドの実行によりこの Servlet に渡される ServletContext オブジェクト
関連項目:
ServletContext

getServletInfo

public java.lang.String getServletInfo()
作者、バージョン、著作権といった Servlet に関する情報を返します。 デフォルトではこのメソッドは空の文字列を返すだけです。 このメソッドをオーバライドして意味のある値が返るようにしてください。 Servlet.getServletInfo() を参照してください。

定義:
インタフェース Servlet 内の getServletInfo
戻り値:
String この Servlet に関する情報。デフォルトでは空文字列

init

public void init(ServletConfig config)
          throws ServletException
Servlet コンテナが呼び出すメソッドです。 この Servlet がサービスを開始できる状態になったことを示します。 Servlet.init(javax.servlet.ServletConfig) を参照してください。

このメソッドの実装は ServletConfig のオブジェクトを Servlet コンテナから受け取り、クラス内部に維持し、必要なときに使えるようにしています。 このメソッドをオーバライドする場合は、super.init(config) を呼び出さなければいけません。

定義:
インタフェース Servlet 内の init
パラメータ:
config - この Servlet 設定情報を含んでいる ServletConfig オブジェクト
例外:
ServletException - Servlet の正常な処理が妨げられた場合に発生する例外
関連項目:
UnavailableException

init

public void init()
          throws ServletException
利便性を考慮して提供されたメソッドです。 このメソッドをオーバライドすれば super.init(config) を実行する必要はありません。

init(ServletConfig) をオーバライドせずに、このメソッドをオーバライドすれば自動的に GenericServlet.init(ServletConfig config) から呼び出されます。 ServletConfig オブジェクトは getServletConfig() メソッドを実行することで取得できます。

例外:
ServletException - Servlet の正常な処理が妨げられた場合に発生する例外

log

public void log(java.lang.String msg)
Servlet のログファイルに指定したメッセージを出力します。 Servlet の名前がメッセージの前に追加されます。 ServletContext.log(String) を参照してください。

パラメータ:
msg - ログファイルに出力するメッセージを指定する String オブジェクト

log

public void log(java.lang.String message,
                java.lang.Throwable t)
補足説明的なメッセージを出力しますが、Throwable 例外を与えられるスタックトレースもログファイルに出力します。 このとき Servlet の名前がメッセージの前に追加されます。 ServletContext.log(String, Throwable) を参照してください。

パラメータ:
message - エラーや例外の説明する String
t - java.lang.Throwable 型のエラー、あるいは例外

service

public abstract void service(ServletRequest req,
                             ServletResponse res)
                      throws ServletException,
                             java.io.IOException
Servlet コンテナが実行します。このメソッドにより Servlet がリクエストに対する応答を返します。 Servlet.service(javax.servlet.ServletRequest, javax.servlet.ServletResponse) を参照してください。

このメソッドは abstract 宣言されています。 HttpServlet などのサブクラスでオーバライドしなければなりません。

定義:
インタフェース Servlet 内の service
パラメータ:
req - クライアントのリクエストを表している ServletRequest オブジェクト
res - Servlet からのレスポンスになる ServletResponse オブジェクト
例外:
ServletException - Servlet の正常な処理が妨げられた場合に発生する例外
java.io.IOException - 入出力関連処理で発生する例外

getServletName

public java.lang.String getServletName()
この Servlet のインスタンスの名前を返します。 ServletConfig.getServletName() を参照してください。

定義:
インタフェース ServletConfig 内の getServletName
戻り値:
この Servlet インスタンスの名前

Mergedoc
Translation

Copyright © 2000- The Apache Software Foundation. All rights Reserved.