public class ShellTag extends CommonTagSupport
ネイティブなプロセスを作成し、バッチファイルやアプリケーションを起動するタグです。
プロセスの状態に応じて、下記のリターンコードが得られます。
SHELL.RTN_CODE = 0 : 正常 (ページの残りを評価する。)
SHELL.RTN_CODE = 1 : 処理中 (ページの残りを評価する。)
SHELL.RTN_CODE = 9 : 取消 (ページの残りを評価する。)
SHELL.RTN_CODE = -1 : 異常終了(ページの残りの処理を行わない。)
異常終了の場合は、このタグ以降の処理を中止します。
wait 属性を使用して、処理の終了を待たずに、復帰することも出来ます。この場合は、
SHELL.RTN_CODE = 1 となり、そのまま、処理は継続されます。このSHELL.RTN_CODE は、
リクエスト変数にセットされていますので、そのまま、value タグで、取得可能です。
action 属性に指定できるアクション名は、以下のとおりです。
RUN Shellオブジェクトを生成/実行します。(セッションに登録しません。)
SET Shellオブジェクトを生成/実行し、セッションに登録します。
すでにセッションに登録済みのShellオブジェクトが実行中の場合は、途中経過を報告します。
GET セッションに登録されている Shellオブジェクトを呼び出します。
セッションに登録されていない場合は、異常終了になります。
REMOVE セッションから、Shellオブジェクトを削除します。
Shellが実行中の場合は強制終了します。 ●形式:<og:shell program="…" />
●body:なし
●Tag定義:
<og:shell
program ○【TAG】シェルファイルを実行する時に引き渡すコマンドを指定します(必須)。
useBatch 【TAG】BATCHプロセスを実行するのかどうか[true/false]を指定します(初期値:false)
wait 【TAG】プロセスの終了を待つかどうか[true/false]を指定します(初期値:true[待つ])
timeout 【TAG】プロセスの実行処理のタイムアウトを設定します (初期値:SHELL_TIMEOUT[=3600])
stdout 【TAG】実行結果を標準出力に出力するかどうか[true/false]を指定します(初期値:false)
stderr 【TAG】実行結果をエラー出力に出力するかどうか[true/false]を指定します(初期値:false)
info 【TAG】インフォメーション情報を出力するかどうか[true/false]を指定します(初期値:false)
action 【TAG】アクション(RUN,SET,GET,REMOVE)をセットします(初期値:RUN)
workDir 【TAG】作業ディレクトリを指定します(初期値:Java仮想マシンの作業ディレクトリ)
envKeys 【TAG】環境変数のキーをCSV形式で指定します(初期値:現状のJava仮想マシンの環境)
envVals 【TAG】環境変数の値をCSV形式で指定します(初期値:現状のJava仮想マシンの環境)
display 【TAG】処理結果を画面に表示するかどうか[true/false]指定します(初期値:true)
caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
/>
●使用例
<og:shell
program = "プログラム" dir /S や、abc.bat など
action = "アクション" [RUN/SET/GET/REMOVE]
useBatch = "バッチ使用" バッチ:true/false (初期値:false)
wait = "終了待ち" 処理終了まで待つ:true/待たない:false (初期値:true)
stdout = "標準出力使用" 標準出力使用:true/未使用:false (初期値:false)
stderr = "エラー出力使用" エラー出力使用:true/未使用:false (初期値:false)
info = "状態表示" シェルの状態表示:true/未使用:false (初期値:false)
/>
<og:value command="GET" key="SHELL.RTN_CODE" />| 修飾子とタイプ | フィールドと説明 |
|---|---|
static java.lang.String |
ACT_GET
action 引数に渡す事の出来る コマンド 取得 "GET"
|
static java.lang.String |
ACT_REMOVE
action 引数に渡す事の出来る コマンド 削除 "REMOVE"
|
static java.lang.String |
ACT_RUN
action 引数に渡す事の出来る コマンド 実行 "RUN"
|
static java.lang.String |
ACT_SET
action 引数に渡す事の出来る コマンド 登録 "SET"
|
BR, BUFFER_MIDDLE, CRbodyContentid, pageContextEVAL_BODY_BUFFERED, EVAL_BODY_TAGEVAL_BODY_AGAINEVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE| コンストラクタと説明 |
|---|
ShellTag()
デフォルトコンストラクター
|
| 修飾子とタイプ | メソッドと説明 |
|---|---|
int |
doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
|
protected void |
release2()
タグリブオブジェクトをリリースします。
|
void |
setAction(java.lang.String act)
【TAG】アクション[RUN/SET/GET/REMOVE]をセットします(初期値:RUN)。
|
void |
setDisplay(java.lang.String flag)
【TAG】処理結果を画面に表示するかどうか[true/false]指定します(初期値:true)。
|
void |
setEnvKeys(java.lang.String keys)
【TAG】環境変数のキーをCSV形式で指定します(初期値:現状のJava仮想マシンの環境)。
|
void |
setEnvVals(java.lang.String vals)
【TAG】環境変数の値をCSV形式で指定します(初期値:現状のJava仮想マシンの環境)。
|
void |
setInfo(java.lang.String flag)
【TAG】インフォメーション情報を出力するかどうか[true/false]を指定します(初期値:false)。
|
void |
setProgram(java.lang.String val)
【TAG】シェルファイルを実行する時に引き渡すコマンドを指定します。
|
void |
setStderr(java.lang.String flag)
【TAG】実行結果をエラー出力に出力するかどうか[true/false]を指定します(初期値:false)。
|
void |
setStdout(java.lang.String flag)
【TAG】実行結果を標準出力に出力するかどうか[true/false]を指定します(初期値:false)。
|
void |
setTimeout(java.lang.String tout)
【TAG】プロセスの実行処理のタイムアウトを設定します
(初期値:SHELL_TIMEOUT[=])。
|
void |
setUseBatch(java.lang.String flag)
【TAG】BATCHプロセスを実行するのかどうか[true/false]を指定します(初期値:false)。
|
void |
setWait(java.lang.String flag)
【TAG】プロセスの終了を待つかどうか[true:待つ/false:待たない]を指定します(初期値:true[待つ])。
|
void |
setWorkDir(java.lang.String dir)
【TAG】作業ディレクトリを指定します(初期値:Java仮想マシンの作業ディレクトリ)。
|
java.lang.String |
toString()
このオブジェクトの文字列表現を返します。
|
add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, doStartTag, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsg, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getSumRequestValue, getTagName, getTransaction, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, makeUrl, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseIf, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheckdoInitBody, getBodyContent, getPreviousOut, release, setBodyContentfindAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValueclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitgetParent, setPageContext, setParentpublic static final java.lang.String ACT_RUN
public static final java.lang.String ACT_SET
public static final java.lang.String ACT_GET
public static final java.lang.String ACT_REMOVE
public ShellTag()
public int doEndTag()
doEndTag インタフェース内 TagdoEndTag クラス内 CommonTagSupportprotected void release2()
release2 クラス内 CommonTagSupportpublic void setProgram(java.lang.String val)
val - シェルコマンドpublic void setUseBatch(java.lang.String flag)
flag - BATCHプロセスを実行するのかどうか [true:BATCHプロセス/false:EXEファイル]public void setStdout(java.lang.String flag)
flag - 実行結果の標準出力 [true:出力する/false:しない]public void setStderr(java.lang.String flag)
flag - 実行結果のエラー出力 [true:出力する/false:しない]public void setWait(java.lang.String flag)
flag - 終了待ち [true:待つ/false:待たない]public void setTimeout(java.lang.String tout)
tout - タイムアウト時間(秒) (ゼロは、無制限)SystemData.SHELL_TIMEOUTpublic void setInfo(java.lang.String flag)
flag - インフォメーション情報 [true:出力する/false:しない]public void setDisplay(java.lang.String flag)
flag - 処理結果を画面に表示するかどうか [true:出力する/false:しない]public void setAction(java.lang.String act)
act - アクション [RUN/SET/GET/REMOVE]public void setWorkDir(java.lang.String dir)
dir - 作業ディレクトリpublic void setEnvKeys(java.lang.String keys)
keys - 環境変数のキーpublic void setEnvVals(java.lang.String vals)
vals - 環境変数のキーpublic java.lang.String toString()
toString クラス内 CommonTagSupportWebアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.