javax.servlet.GenericServlet
javax.servlet.http.HttpServlet
org.apache.struts.action.ActionServlet
|
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
ActionServletは、 "モデル2"として一般に知られている、 WEBアプリケーションのためのモデル-ビュー-コントローラ(MVC)デザインパターンの"コントローラ"を提供します。 この命名の起源はJavaServerPages仕様の0.92の記述であり、 (他に適当な名前がないため)それ以来ずっと続いています。
"モデル2"アプリケーションのアーキテクチャは概ね次の通りです。:
RequestProcessorオブジェクトへリクエストの扱いを移譲します。
このコンポーネントはMVCアーキテクチャの"コントローラ"コンポーネントを実現します。RequestProcessorは、
要求されたビジネスロジックを処理するActionクラスを選択して実行するか、
または別のリソースへレスポンスを移譲します。Actionクラスは、
アプリケーションのユーザとの相互作用の状態を扱うことができます。
この典型例として、
(どれぐらいの期間必要かにより)リクエストまたはセッション属性に蓄積されるJavaBeansを生成したり変更する事があります。
この様なJavaBeansは、MVCアーキテクチャの"モデル"コンポーネントを実現します。Actionクラスは、
レスポンスを扱うべきリソースを指すActionForwardを一般に返します。
Actionがnullを返さない場合、
ユーザインタフェースの遷移先のページを生成するために、
(RequestDispatcher.forwardまたはResponse.sendRedirectを活用して)
RequestProcessorは、指定されたリソースへフォワードまたはリダイレクトします。RequestsProcessorの標準バージョンは、
各HTTPリクエストに対する以下のようなロジックを実装しています。
このオブジェクトをサブクラス化して独自の処理を実装するために、
いくつかまたは全ての機能をオーバーライドすることができます。
Actionインタフェースを実装した)
対応するアクションクラスのクラス名を決定します。Actionクラスへ最初のリクエストがあると、
そのクラスのインスタンスを生成するとともに将来に備えてキャッシュします。ActionForm Beanのプロパティを設定します。Actionクラスのexecuteメソッドを呼び出し、
使用されるマッピングを参照して、
(もしあれば)関連したフォームBeanと、
リクエストとレスポンスがサーブレットコンテナによりコントローラに渡されます。
(そのためサーブレットコンテキストと同様に、
マッピング自身のどのような限定されたプロパティへもアクセスを提供します。)ActionServletの標準バージョンは、
Webアプリケーション用の配備記述ファイル(/WEB-INF/web.xml)で規定された、
以下のサーブレット初期化パラメータをもとに初期化されます。
このサーブレットのサブクラスでは、
追加の初期化パラメータを自由に定義できます。
ModuleConfigインタフェースの実装を生成するために使用されるModuleConfigFactoryのクラス名です。
[org.apache.struts.config.impl.DefaultModuleConfigFactory]
java.lang.Integerの様な)数値型に関するラッパクラスは(0ではなく)nullに設定されます。
(Struts 1.1以降) [false] struts-config.xmlファイルを処理するDigesterに加えるべき、
org.apache.commons.digester.RuleSetインスタンスに追加する十分適格なクラス名のカンマで区切られたリストです。
デフォルトでは、
標準設定要素のRuleSetがロードされるだけです。
(Struts 1.1以降)
| フィールドの概要 | |
protected java.lang.String |
config
デフォルトモジュールのための設定リソースへのコンテキスト相対パスのカンマで区切られたリスト。 |
protected org.apache.commons.digester.Digester |
configDigester
Struts設定ファイルからModuleConfigオブジェクトを生成するために使用されるDigester。 |
protected boolean |
convertNull
ラッパクラス型に関するフォームBeanのプロパティにおける振る舞いの下位互換性の対応要求フラグ。 |
protected org.apache.commons.collections.FastHashMap |
dataSources
もしあれば、 保存される際のサーブレットコンテキスト属性名をキーとする、 このモジュールで設定されたJDBCデータソース。 |
protected MessageResources |
internal
内部リソースのためのリソースオブジェクト。 |
protected java.lang.String |
internalName
内部リソースの基本クラス名。 |
protected static org.apache.commons.logging.Log |
log
Commons Loggingのインスタンス。 |
protected RequestProcessor |
processor
全てのリクエストを処理するために使用する RequestProcessorのインスタンス。 |
protected java.lang.String[] |
registrations
使用すべき設定ファイルのDTDのバージョンを表すための、 公開された識別子と対応するリソース名のセットです。 |
protected java.lang.String |
servletMapping
Webアプリケーションの配備記述子で設定されたURLパターン。 |
protected java.lang.String |
servletName
Webアプリケーションの配備記述子で登録されているサーブレット名。 |
| クラス javax.servlet.http.HttpServlet から継承したフィールド |
|
| コンストラクタの概要 | |
ActionServlet()
|
|
| メソッドの概要 | |
private void |
addRuleSets()
rulesets初期化パラメータで指定されたconfigDigesterに、
全てのカスタムRuleSetのインスタンスを追加します
{@primary Add any custom RuleSet instances to configDigester that have
been specified in the rulesets init parameter. |
void |
addServletMapping(java.lang.String servletName,
java.lang.String urlPattern)
このサーブレット用である場合、 Webアプリケーションの配備記述子からサーブレットマッピングを設定します。 |
void |
destroy()
このコントローラサーブレットを速やかに停止し、 初期化時に確保されたあらゆるリソースを解放します。 |
protected void |
destroyConfigDigester()
生成されたconfigDigesterのインスタンスを全て速やかに解放します。 |
protected void |
destroyInternal()
内部のMessageResourcesの使用を速やかに終了します。 |
protected void |
destroyModules()
(もしあれば) このアプリケーションに関連づけられた全てのモジュールの使用を速やかに終了します。 |
void |
doGet(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
HTTPの"GET"リクエストを処理します。 |
void |
doPost(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
HTTPの"POST"リクエストを処理します。 |
MessageResources |
getInternal()
内部メッセージの文字列を含む MessageResourcesのインスタンスを返します。 |
protected ModuleConfig |
getModuleConfig(javax.servlet.http.HttpServletRequest request)
現在選択されているモジュールのモジュール設定オブジェクトを返します。 |
private RequestProcessor |
getProcessorForModule(ModuleConfig config)
与えられたモジュールのRequestProcessorを返し、 存在しない場合はnullを返します。 |
protected RequestProcessor |
getRequestProcessor(ModuleConfig config)
指定されたモジュールに関係する RequestProcessorを探して、
必要に応じて新たに生成し、
返します。 |
private void |
handleConfigException(java.lang.String path,
java.lang.Exception e)
parseModuleConfigFileメソッドにおける例外の扱いを簡略化します。 |
void |
init()
このサーブレットを初期化します。 |
protected org.apache.commons.digester.Digester |
initConfigDigester()
Strutsモジュール設定ファイルの処理されて、 (解析が行われる前に評価スタックに入れられるべき) 対応する ModuleConfigオブジェクトの設定で初期化された、
新たなDigesterインスタンスを(必要に応じて)生成して返します。 |
protected void |
initInternal()
内部のMessageResourcesの纏まりを初期化します。 |
protected ModuleConfig |
initModuleConfig(java.lang.String prefix,
java.lang.String paths)
指定されたモジュールのモジュール設定情報を初期化します。 |
protected void |
initModuleConfigFactory()
モジュール設定を生成するために使用されるファクトリを初期化します。 |
protected void |
initModuleDataSources(ModuleConfig config)
指定されたモジュールのデータソースを初期化します。 |
protected void |
initModuleMessageResources(ModuleConfig config)
指定されたモジュールのアプリケーション MessageResourcesを初期化します。 |
protected void |
initModulePlugIns(ModuleConfig config)
指定されたモジュールのプラグインを初期化します。 |
protected void |
initModulePrefixes(javax.servlet.ServletContext context)
Globals.MODULE_PREFIXES_KEYに基づき、 サーブレットコンテキスト内のモジュールプレフィックスであるString[]を保存します 注意 - デフォルトモジュールのためのプレフィックスである""はこのリスト中に含まれません。 |
protected void |
initOther()
コントローラサーブレットの他のグローバル特性を初期化します。 |
protected void |
initServlet()
コントローラサーブレットがアクセスするサーブレットマッピングを初期化します。 |
private boolean |
isValidating()
validatingの初期化パラメータの状態を確認します。 |
protected void |
parseModuleConfigFile(org.apache.commons.digester.Digester digester,
java.lang.String path)
モジュール設定ファイルを解析します。 |
protected void |
process(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
このリクエストに対する標準的なリクエスト処理を実行して、 対応するレスポンスを生成します。 |
| クラス javax.servlet.http.HttpServlet から継承したメソッド |
doDelete, doHead, doOptions, doPut, doTrace, getLastModified, service, service |
| クラス javax.servlet.GenericServlet から継承したメソッド |
getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log |
| クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| フィールドの詳細 |
protected java.lang.String config
デフォルトモジュールのための設定リソースへのコンテキスト相対パスのカンマで区切られたリスト。
protected org.apache.commons.digester.Digester configDigester
Struts設定ファイルからModuleConfigオブジェクトを生成するために使用されるDigester。
protected boolean convertNull
ラッパクラス型に関するフォームBeanのプロパティにおける振る舞いの下位互換性の対応要求フラグ。
protected org.apache.commons.collections.FastHashMap dataSources
もしあれば、 保存される際のサーブレットコンテキスト属性名をキーとする、 このモジュールで設定されたJDBCデータソース。
protected MessageResources internal
内部リソースのためのリソースオブジェクト。
protected java.lang.String internalName
内部リソースの基本クラス名。
protected static org.apache.commons.logging.Log log
Commons Loggingのインスタンス。
protected RequestProcessor processor
全てのリクエストを処理するために使用するRequestProcessorのインスタンス。
protected java.lang.String[] registrations
使用すべき設定ファイルのDTDのバージョンを表すための、 公開された識別子と対応するリソース名のセットです。 このリストの数は必ず偶数であること!
protected java.lang.String servletMapping
Webアプリケーションの配備記述子で設定されたURLパターン。
protected java.lang.String servletName
Webアプリケーションの配備記述子で登録されているサーブレット名。
| コンストラクタの詳細 |
public ActionServlet()
| メソッドの詳細 |
public void destroy()
このコントローラサーブレットを速やかに停止し、 初期化時に確保されたあらゆるリソースを解放します。
public void init()
throws javax.servlet.ServletException
このサーブレットを初期化します。 ほとんどの処理はサポートメソッドに分解されているので、 かなり細かいレベルの機能毎にオーバライドできます。
javax.servlet.ServletException - 正しく初期化できなかった場合
protected void initModulePrefixes(javax.servlet.ServletContext context)
Globals.MODULE_PREFIXES_KEYに基づき、 サーブレットコンテキスト内のモジュールプレフィックスであるString[]を保存します 注意 - デフォルトモジュールのためのプレフィックスである""はこのリスト中に含まれません。
context - サーブレットコンテキスト
public void doGet(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
throws java.io.IOException,
javax.servlet.ServletException
HTTPの"GET"リクエストを処理します。
request - 処理中のサーブレットリクエスト
response - 生成するサーブレットレスポンス
java.io.IOException - 入出力エラーが発生した場合
javax.servlet.ServletException - サーブレットで例外が発生した場合
public void doPost(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
throws java.io.IOException,
javax.servlet.ServletException
HTTPの"POST"リクエストを処理します。
request - 処理中のサーブレットリクエスト
response - 生成するサーブレットレスポンス
java.io.IOException - 入出力エラーが発生した場合
javax.servlet.ServletException - サーブレットで例外が発生した場合
public void addServletMapping(java.lang.String servletName,
java.lang.String urlPattern)
このサーブレット用である場合、 Webアプリケーションの配備記述子からサーブレットマッピングを設定します。
servletName - マップされているサーブレットの名前
urlPattern - このサーブレットにマップされているURLパターン
public MessageResources getInternal()
内部メッセージの文字列を含むMessageResourcesのインスタンスを返します。
protected void destroyModules()
(もしあれば) このアプリケーションに関連づけられた全てのモジュールの使用を速やかに終了します。
protected void destroyConfigDigester()
生成されたconfigDigesterのインスタンスを全て速やかに解放します。
protected void destroyInternal()
内部のMessageResourcesの使用を速やかに終了します。
protected ModuleConfig getModuleConfig(javax.servlet.http.HttpServletRequest request)
現在選択されているモジュールのモジュール設定オブジェクトを返します。
request - 処理中のサーブレットリクエスト
protected RequestProcessor getRequestProcessor(ModuleConfig config)
throws javax.servlet.ServletException
指定されたモジュールに関係するRequestProcessorを探して、
必要に応じて新たに生成し、
返します。
config - 取得してRequestProcessorを返すためのモジュールの設定
javax.servlet.ServletException - RequestProcessorのインスタンスを生成できない場合
private RequestProcessor getProcessorForModule(ModuleConfig config)
与えられたモジュールのRequestProcessorを返し、 存在しない場合はnullを返します。 このメソッドはRequestProcessorを生成しません。
config - ModuleConfig
protected void initModuleConfigFactory()
モジュール設定を生成するために使用されるファクトリを初期化します。
protected ModuleConfig initModuleConfig(java.lang.String prefix,
java.lang.String paths)
throws javax.servlet.ServletException
指定されたモジュールのモジュール設定情報を初期化します。
prefix - このモジュールのモジュールプレフィックス
paths - このモジュールの設定リソースのためのコンテキスト相対パスのカンマで区切られたリスト
javax.servlet.ServletException - 初期化が実行できなかった場合
protected void parseModuleConfigFile(org.apache.commons.digester.Digester digester,
java.lang.String path)
throws javax.servlet.UnavailableException
モジュール設定ファイルを解析します。
digester - 解析するためのDigesterインスタンス
path - 解析する設定ファイルへのパス
javax.servlet.UnavailableException - ファイルが読めないかまたは解析できない場合
private void handleConfigException(java.lang.String path,
java.lang.Exception e)
throws javax.servlet.UnavailableException
parseModuleConfigFileメソッドにおける例外の扱いを簡略化します。
path - e -
javax.servlet.UnavailableException - 例外のラッパ
protected void initModuleDataSources(ModuleConfig config)
throws javax.servlet.ServletException
指定されたモジュールのデータソースを初期化します。
config - このモジュールのModuleConfig情報
javax.servlet.ServletException - 初期化が実行できなかった場合
protected void initModulePlugIns(ModuleConfig config)
throws javax.servlet.ServletException
指定されたモジュールのプラグインを初期化します。
config - このモジュールのModuleConfig情報
javax.servlet.ServletException - 初期化が実行できなかった場合
protected void initModuleMessageResources(ModuleConfig config)
throws javax.servlet.ServletException
指定されたモジュールのアプリケーションMessageResourcesを初期化します。
config - このモジュールのModuleConfig情報
javax.servlet.ServletException - 初期化が実行できなかった場合
protected org.apache.commons.digester.Digester initConfigDigester()
throws javax.servlet.ServletException
Strutsモジュール設定ファイルの処理されて、
(解析が行われる前に評価スタックに入れられるべき)
対応するModuleConfigオブジェクトの設定で初期化された、
新たなDigesterインスタンスを(必要に応じて)生成して返します。
javax.servlet.ServletException - Digesterが設定できなかった場合
private void addRuleSets()
throws javax.servlet.ServletException
rulesets初期化パラメータで指定されたconfigDigesterに、
全てのカスタムRuleSetのインスタンスを追加します
javax.servlet.ServletExceptionprivate boolean isValidating()
validatingの初期化パラメータの状態を確認します。
protected void initInternal()
throws javax.servlet.ServletException
内部のMessageResourcesの纏まりを初期化します。
javax.servlet.ServletException - これらのリソースを初期化できなかった場合
protected void initOther()
throws javax.servlet.ServletException
コントローラサーブレットの他のグローバル特性を初期化します。
javax.servlet.ServletException - これらのリソースを初期化できなかった場合
protected void initServlet()
throws javax.servlet.ServletException
コントローラサーブレットがアクセスするサーブレットマッピングを初期化します。
これは、
フォームを送信するための適切な遷移先のURLを生成する、
&html:form>タグで使用されます。
javax.servlet.ServletException - web.xmlを調べている間にエラーが発生した場合
protected void process(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
throws java.io.IOException,
javax.servlet.ServletException
このリクエストに対する標準的なリクエスト処理を実行して、 対応するレスポンスを生成します。
response - 生成するサーブレットレスポンス
java.io.IOException - 入出力エラーが生じた場合
javax.servlet.ServletException - サーブレット例外が生じた場合
|
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||