public class ShellTag extends CommonTagSupport
ネイティブなプロセスを作成し、バッチファイルやアプリケーションを起動するタグです。 プロセスの状態に応じて、下記のリターンコードが得られます。 SHELL.RTN_CODE = 0 : 正常 (ページの残りを評価する。) SHELL.RTN_CODE = 1 : 処理中 (ページの残りを評価する。) SHELL.RTN_CODE = 9 : 取消 (ページの残りを評価する。) SHELL.RTN_CODE = -1 : 異常終了(useStop:true ページの残りの処理を行わない。false:残りを評価する。) 異常終了の場合は、このタグ以降の処理を中止します。 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) useStop 【TAG】エラー時に停止するかどうか[true/false]を指定します(初期値:true) 7.1.0.0 (2020/01/20) 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) display = "画面表示" 画面に表示する:true/表示しない:false (初期値:true) useStop = "エラー時停止" エラー時に停止する:true/停止しない:alse (初期値:true) 7.1.0.0 (2020/01/20) /> <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, CR
bodyContent
id, pageContext
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
EVAL_BODY_AGAIN
EVAL_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 |
setUseStop(java.lang.String flag)
【TAG】エラー時に処理を停止するかどうか[true/false]を指定します(初期値:true)。
|
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, useXssCheck
doInitBody, getBodyContent, getPreviousOut, release, setBodyContent
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getParent, setPageContext, setParent
public 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
インタフェース内 Tag
doEndTag
クラス内 CommonTagSupport
protected void release2()
release2
クラス内 CommonTagSupport
public 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_TIMEOUT
public 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 void setUseStop(java.lang.String flag)
flag
- エラー時停止 [true:する/それ以外:しない]public java.lang.String toString()
toString
クラス内 CommonTagSupport
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.