クラス FacesServlet

メソッドの詳細

• init

  public void init(ServletConfig servletConfig) throws ServletException

  必要なファクトリインスタンスを取得します。

  次で指定:

  インターフェース Servlet の init 

  パラメーター:

  servletConfig - サーブレットの構成および初期化パラメーターを含む ServletConfig オブジェクト

  例外:

  ServletException - 何らかの理由で、この Faces アプリケーションの起動が失敗した場合。これには、この init() メソッドの処理前または処理中に解析される構成ファイルのエラーが含まれます。

  関連事項:

  • UnavailableException
  • Servlet.getServletConfig()

• service

  public void service(ServletRequest req, ServletResponse resp) throws IOExceptionSE, ServletException

  受信リクエストを処理し、以下の仕様に従って対応するレスポンスを作成します。

  このメソッドの request および response 引数がそれぞれ HttpServletRequest および HttpServletResponse のインスタンスでない場合、このメソッドを呼び出した結果は未定義です。

  このメソッドは、レスポンス引数（HttpServletResponse にキャスト）で sendError メソッドを呼び出し、コード HttpServletResponse.SC_NOT_FOUND を引数として渡すことにより、次の文字列を含むリクエストにレスポンスする必要があります。

   
   /WEB-INF/
   /WEB-INF
   /META-INF/
   /META-INF
   
   

  このメソッドの仕様で前述したいずれのケースもこのリクエストのサービスに適用されない場合、リクエストを処理するには次のアクションを実行する必要があります。

  このリクエストの FacesContext インスタンスを取得します。

  Application.getResourceHandler() を呼び出して、このリクエストの ResourceHandler を取得します。ResourceHandler.isResourceRequest(jakarta.faces.context.FacesContext) を呼び出します。これが true を返す場合、ResourceHandler.handleResourceRequest(jakarta.faces.context.FacesContext) を呼び出します。これが false を返す場合は、Lifecycle.attachWindow(jakarta.faces.context.FacesContext)、Lifecycle.execute(jakarta.faces.context.FacesContext)、Lifecycle.render(jakarta.faces.context.FacesContext) の順に呼び出します。どちらの場合も FacesException がスローされた場合は、FacesException から原因を抽出します。原因が null の場合は、FacesException からメッセージを抽出し、それを新しい ServletException インスタンスの内部に置き、FacesException インスタンスを根本原因として渡してから、ServletException インスタンスを再スローします。原因が ServletException のインスタンスである場合、原因を再スローします。原因が IOException のインスタンスである場合、原因を再スローします。それ以外の場合は、新しい ServletException インスタンスを作成し、最初の引数として原因からのメッセージを渡し、2 番目の引数として原因自体を渡します。

  実装では、FacesContext.release() がこのリクエストの Jakarta Faces 関連部分の処理で可能な限り遅く、finally ブロック内で呼び出されるようにする必要があります。

  次で指定:

  インターフェース Servlet の service 

  パラメーター:

  req - 処理中の Jakarta Servlet リクエスト

  resp - 作成している Jakarta Servlet レスポンス

  例外:

  IOExceptionSE - 処理中に入出力エラーが発生した場合

  ServletException - 処理中に Jakarta Servlet エラーが発生した場合

• destroy

  public void destroy()

  起動時に取得したすべてのリソースを解放します。

  次で指定:

  インターフェース Servlet の destroy 

• getServletConfig

  public ServletConfig getServletConfig()

  このサーブレットの ServletConfig インスタンスを返します。

  次で指定:

  インターフェース Servlet の getServletConfig 

  戻り値:

  このサーブレットを初期化する ServletConfig オブジェクト

  関連事項:

  • Servlet.init(jakarta.servlet.ServletConfig)

• getServletInfo

  public StringSE getServletInfo()

  このサーブレットに関する情報を返します。

  次で指定:

  インターフェース Servlet の getServletInfo 

  戻り値:

  サーブレット情報を含む String