public class FileTag extends CommonTagSupport
各種アクションを指定して、ファイル関連の操作をおこなうタグです。
各種アクション に応じた振る舞いを行います。
結果については、false の場合は、body 要素を表示して、終了します。
これは、BODYにエラーメッセージを書いておくことを想定した作りになっています。
判定結果を反転したい場合は、notEquals 属性を使用してください。また、
結果に応じて、処理を止めたくない場合は、useStop 属性を false に指定することで、
後続処理を実行できます。
[各種アクション]
canRead 読み込めるかどうかを判定。
canWrite 変更できるかどうか判定。
createNewFile 空の新しいファイルを不可分 (atomic) に生成。(そのファイルがまだ存在しない場合だけ)
delete ファイルまたはディレクトリを削除(ディレクトリ階層をすべて削除)。
renameTo ファイルまたはディレクトリ名を変更。
exists ファイルが存在するかどうか判定。
isDirectory ファイルがディレクトリであるかどうか判定。
isFile ファイルが普通のファイルかどうか判定。
isHidden ファイルが隠しファイルかどうか判定。
mkdir ディレクトリを生成。
mkdirs ディレクトリを複数生成。
read ファイルを読み込んで、パラメータにセットします(6.2.3.0 (2015/05/01))。
existsLength ファイルサイズが0Byte以上のファイルが存在するかどうか判定。
copy ファイルまたはディレクトリをコピー(file1 ⇒ file2 にコピー)。
copyST ストリームファイルをコピー(file1(アドレス) ⇒ file2 にコピー)。
list ファイルリストをListオブジェクトにコピーして、パラメータにセットします(6.2.3.0 (2015/05/01))。
zip ファイルまたはディレクトリをZIPファイルに圧縮します。(file1⇒file2)
timeStamp ファイルのタイムスタンプを現在時刻に変更します。(file1のみ) ●形式:<og:file action="…" fileURL="…" >・・・</og:file>
●body:あり(EVAL_BODY_INCLUDE:BODYをインクルードし、{@XXXX} は解析しません)
●Tag定義:
<og:file
action ○【TAG】アクション(canRead,canWrite,createNewFile,delete,exists,isDirectory,isFile,isHidden,mkdir,mkdirs,renameTo,read,existsLength,copy,copyST,list,zip,timeStamp)を指定します(必須)。
fileURL 【TAG】操作するファイルのディレクトリを指定します (初期値:FILE_URL[=filetemp/])
file1 【TAG】基準となるファイル名を指定します(コマンドの左辺のファイル名です)
file2 【TAG】処理結果となるファイル名を指定します(コマンドの右辺のファイル名です)
notEquals 【TAG】判定結果を反転させるかどうか[true/false]を指定します(初期値:false)
useStop 【TAG】エラー時BODYを処理後に停止するかどうか[true/false]を指定します(初期値:true)
encode 【TAG】ファイルを読み込む(action="read")際のエンコードを指定します(初期値:OS依存文字コード)
caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20)
caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20)
caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
> ... Body ...
</og:file>
●使用例
・ファイルの存在チェック→存在しなければエラーメッセージを表示。
<og:file action="exists" fileURL="N:/CIR/" file1="{@USER.LKISB}/{@USER.LDNO1KAI}.cir/001.sht">
<og:message lbl="RKE_0157" comment="回路図が存在しません。" />
</og:file>
・N:/Filetemp/にユーザーディレクトリが存在しなければ作成。→失敗した場合エラーメッセージを表示。
<og:file action="mkdir" fileURL="N:/Filetemp/{@USER.ID}" >
<og:message comment="エラーが発生しました。システム管理者に連絡してください。" />
</og:file>
・N:/Filetemp/test.txt ファイルの削除。ファイルが存在しなくても処理を続ける。
<og:file action="delete" fileURL="N:/Filetemp/" file1="test.txt" useStop="false" >
<og:message comment="ファイルは存在しませんでした。" />
</og:file>| 修飾子とタイプ | フィールドと説明 |
|---|---|
static java.lang.String |
ACT_CANREAD
action 引数に渡す事の出来る アクションコマンド 読み込めるかどうか "canRead"
|
static java.lang.String |
ACT_CANWRITE
action 引数に渡す事の出来る アクションコマンド 変更できるかどうか "canWrite"
|
static java.lang.String |
ACT_COPY
action 引数に渡す事の出来る アクションコマンド ファイルまたはディレクトリをコピーします。
|
static java.lang.String |
ACT_COPYST
action 引数に渡す事の出来る アクションコマンド ストリームファイルをコピーします。
|
static java.lang.String |
ACT_CREATENEWFILE
action 引数に渡す事の出来る アクションコマンド 空の新しいファイルを不可分 (atomic) に生成します (そのファイルがまだ存在しない場合だけ "createNewFile"
|
static java.lang.String |
ACT_DELETE
action 引数に渡す事の出来る アクションコマンド ファイルまたはディレクトリを削除"delete"
|
static java.lang.String |
ACT_EXISTS
action 引数に渡す事の出来る アクションコマンド ファイルが存在するかどうか "exists"
|
static java.lang.String |
ACT_EXISTSLENGTH
action 引数に渡す事の出来る アクションコマンド ファイルサイズが0Byte以上のファイルが存在するかどうか判定。
|
static java.lang.String |
ACT_ISDIRECTORY
action 引数に渡す事の出来る アクションコマンド ファイルがディレクトリであるかどうか"isDirectory"
|
static java.lang.String |
ACT_ISFILE
action 引数に渡す事の出来る アクションコマンド ファイルが普通のファイルかどうか"isFile"
|
static java.lang.String |
ACT_ISHIDDEN
action 引数に渡す事の出来る アクションコマンド ファイルが隠しファイルかどうか "isHidden"
|
static java.lang.String |
ACT_LIST
action 引数に渡す事の出来る アクションコマンド ディレクトリのファイルリストをListオブジェクトにコピーします。
|
static java.lang.String |
ACT_MKDIR
action 引数に渡す事の出来る アクションコマンド ディレクトリを生成します。
|
static java.lang.String |
ACT_MKDIRS
action 引数に渡す事の出来る アクションコマンド ディレクトリを生成します。
|
static java.lang.String |
ACT_READ
action 引数に渡す事の出来る アクションコマンド ファイルを読み込んで表示します。
|
static java.lang.String |
ACT_RENAMETO
action 引数に渡す事の出来る アクションコマンド ファイル名を変更します。
|
static java.lang.String |
ACT_TIMESTAMP
action 引数に渡す事の出来る アクションコマンド タイムスタンプを現在時刻に変更します。
|
static java.lang.String |
ACT_ZIP
action 引数に渡す事の出来る アクションコマンド ZIP圧縮します。
|
BR, BUFFER_MIDDLE, CRbodyContentid, pageContextEVAL_BODY_BUFFERED, EVAL_BODY_TAGEVAL_BODY_AGAINEVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE| コンストラクタと説明 |
|---|
FileTag()
デフォルトコンストラクター
|
| 修飾子とタイプ | メソッドと説明 |
|---|---|
int |
doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
|
int |
doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
|
protected void |
release2()
タグリブオブジェクトをリリースします。
|
void |
setAction(java.lang.String cmd)
【TAG】アクション(canRead,canWrite,createNewFile,delete,exists,isDirectory,isFile,isHidden,mkdir,mkdirs,renameTo,read,existsLength,copy,copyST,list)を指定します。
|
void |
setEncode(java.lang.String enc)
【TAG】ファイルを読み込む(action="read")際のエンコードを指定します(初期値:OS依存文字コード)。
|
void |
setFile1(java.lang.String fname)
【TAG】基準となるファイル名を指定します(コマンドの左辺のファイル名です)。
|
void |
setFile2(java.lang.String fname)
【TAG】処理結果となるファイル名を指定します(コマンドの右辺のファイル名です)。
|
void |
setFileURL(java.lang.String url)
【TAG】操作するファイルのディレクトリを指定します
(初期値:FILE_URL[=])。
|
void |
setNotEquals(java.lang.String flag)
【TAG】判定結果を反転させるかどうか[true/false]を指定します(初期値:false)。
|
void |
setUseStop(java.lang.String flag)
【TAG】エラー時BODYを処理後に停止するかどうか[true/false]を指定します(初期値:true)。
|
java.lang.String |
toString()
このオブジェクトの文字列表現を返します。
|
add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, 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_CANREAD
public static final java.lang.String ACT_CANWRITE
public static final java.lang.String ACT_CREATENEWFILE
public static final java.lang.String ACT_DELETE
public static final java.lang.String ACT_EXISTS
public static final java.lang.String ACT_ISDIRECTORY
public static final java.lang.String ACT_ISFILE
public static final java.lang.String ACT_ISHIDDEN
public static final java.lang.String ACT_MKDIR
public static final java.lang.String ACT_MKDIRS
public static final java.lang.String ACT_RENAMETO
public static final java.lang.String ACT_READ
public static final java.lang.String ACT_EXISTSLENGTH
public static final java.lang.String ACT_COPY
public static final java.lang.String ACT_COPYST
public static final java.lang.String ACT_LIST
public static final java.lang.String ACT_ZIP
public static final java.lang.String ACT_TIMESTAMP
public FileTag()
public int doStartTag()
doStartTag インタフェース内 TagdoStartTag クラス内 CommonTagSupportpublic int doEndTag()
doEndTag インタフェース内 TagdoEndTag クラス内 CommonTagSupportprotected void release2()
release2 クラス内 CommonTagSupportpublic void setAction(java.lang.String cmd)
cmd - アクション文字列public void setFileURL(java.lang.String url)
url - ファイルURLSystemData.FILE_URLpublic void setFile1(java.lang.String fname)
fname - ファイル名1public void setFile2(java.lang.String fname)
fname - ファイル名2public void setNotEquals(java.lang.String flag)
flag - 判定結果反転 [true:反転する/それ以外:通常]public void setUseStop(java.lang.String flag)
flag - 処理後停止 [true:する/それ以外:しない]public void setEncode(java.lang.String enc)
enc - ファイル読み込みのエンコードpublic java.lang.String toString()
toString クラス内 CommonTagSupportWebアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.