public class FileUploadTag extends CommonTagSupport
●形式:<og:upload fileURL="…" maxPostSize="…" /> ●body:なし ●Tag定義: <og:upload fileURL 【TAG】ファイルをアップロードするディレクトリを指定します (初期値:FILE_URL[=filetemp/]) filename 【TAG】(通常使いません)ファイルを作成するときのファイル名をセットします maxPostSize 【TAG】最大転送サイズ(Byte)を指定します(初期値:10485760) 0,またはマイナスで無制限です。 scope 【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session) tableId 【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID columns 【TAG】DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。 useBackup 【TAG】ファイルアップロード時に、すでに同名のファイルが存在した場合に、バックアップ処理(renameTo)するかどうか[true/false]を指定します(初期値:false) language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) /> ●使用例 : 【query.jsp】 <form method="POST" action="result.jsp" enctype="multipart/form-data" target="RESULT"> <table summary="layout" > <tr><og:input type="text" name="submitter" value="{@USER.JNAME}" size="20" lbl="MSG0014" /></tr> <tr> <og:input type="file" name="file_01" size="30" lbl="MSG0015" /> <og:input name="file_01_NEW" size="10" lbl="FILENAME" /> </tr><tr> <og:input type="file" name="file_02" size="30" lbl="MSG0015" /> <og:input name="file_02_NEW" size="10" lbl="FILENAME" /> </tr><tr> <og:input type="file" name="file_03" size="30" lbl="MSG0015" /> <og:input name="file_03_NEW" size="10" lbl="FILENAME" /> </tr><tr> <og:column name="writable" value="false" /> </tr> </table> 【result.jsp】 <og:upload fileURL = "{@USER.ID}" /> <br /> <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" /> <og:view command = "NEW" viewFormType = "HTMLTable" writable = "{@writable}" /> <table> <tr><og:input name="submitter" value="{@submitter}" /></tr> <tr><og:input name="writable" value="{@writable}" /></tr> <tr><og:input name="directory" value="{@directory}" /></tr> <tr><og:input name="file_01" value="{@file_01}" /></tr> <tr><og:input name="file_01_NEW" value="{@file_01_NEW}" /></tr> <tr><og:input name="file_01_ORG" value="{@file_01_ORG}" /></tr> <tr><og:input name="file_02" value="{@file_02}" /></tr> <tr><og:input name="file_02_NEW" value="{@file_02_NEW}" /></tr> <tr><og:input name="file_02_ORG" value="{@file_02_ORG}" /></tr> <tr><og:input name="file_03" value="{@file_03}" /></tr> <tr><og:input name="file_03_NEW" value="{@file_03_NEW}" /></tr> <tr><og:input name="file_03_ORG" value="{@file_03_ORG}" /></tr> </table> 【result.jsp】 <og:upload fileURL = "{@USER.ID}" columns = "submitter,file" /> <br /> <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" /> <og:view command = "NEW" viewFormType = "HTMLTable" writable = "{@writable}" />
修飾子とタイプ | フィールドと説明 |
---|---|
static java.lang.String |
UPLOAD_FILES
5.7.6.3 (2014/05/23) アップロードファイルのCSVセットのキー
|
bodyContent
id, pageContext
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
EVAL_BODY_AGAIN
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
コンストラクタと説明 |
---|
FileUploadTag() |
修飾子とタイプ | メソッドと説明 |
---|---|
int |
doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
|
protected java.lang.String |
getTagName()
タグの名称を、返します。
|
protected void |
release2()
タグリブオブジェクトをリリースします。
|
void |
setColumns(java.lang.String clms)
【TAG】DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。
|
void |
setFilename(java.lang.String fname)
【TAG】(通常使いません)ファイルを作成するときのファイル名をセットします。
|
void |
setFileURL(java.lang.String url)
【TAG】ファイルをアップロードするディレクトリを指定します
(初期値:FILE_URL[=filetemp/])。
|
void |
setMaxPostSize(java.lang.String maxPS)
【TAG】最大転送サイズ(Byte)を指定します(初期値:10485760)。
|
void |
setTableId(java.lang.String id)
【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
(初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])。
|
void |
setUseBackup(java.lang.String flag)
【TAG】ファイルアップロード時に、すでに同名のファイルが存在した場合に、バックアップ処理(renameTo)するかどうか[true/false]を指定します(初期値:false)。
|
java.lang.String |
toString()
このオブジェクトの文字列表現を返します。
|
add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, doStartTag, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, 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 UPLOAD_FILES
public FileUploadTag()
public int doEndTag()
doEndTag
インタフェース内 Tag
doEndTag
クラス内 CommonTagSupport
2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更 |
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 |
3.1.3.0 (2003/04/10) UTF-8 決め打ちのエンコード情報を取得する。 |
3.5.2.0 (2003/10/20) scope 属性を追加。 |
3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。 |
3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェックを行います。 |
3.7.1.1 (2005/05/23) フォルダがない場合は、複数階層分のフォルダを自動で作成します。 |
3.8.1.3A (2006/01/30) 新ファイル名にオリジナルファイル名の拡張子をセットします |
5.3.7.0 (2011/07/01) エラーメッセージ内容変更 |
5.6.5.2 (2013/06/21) columns 属性の追加 |
5.6.5.3 (2013/06/28) useBackup 属性の追加 |
5.8.8.0 (2015/06/05) エラー文の日本語化 |
5.9.25.0 (2017/10/06) クラウドストレージの利用追加対応 |
protected void release2()
release2
クラス内 CommonTagSupport
2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 |
3.0.1.1 (2003/03/06) columns を廃止 |
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 |
3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。 |
5.6.5.2 (2013/06/21) columns 属性の追加 |
5.6.5.2 (2013/06/21) useBackup 属性の追加 |
public void setFileURL(java.lang.String url)
url
- ファイルURLSystemData.FILE_URL
この属性で指定されるディレクトリに、アップロードされたファイルをセーブします。 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、2文字目が、 ":" (Windows)の場合は、指定のURLそのままのディレクトリに、そうでない場合は、 fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のフォルダの下に、 さらに、各個人ID別のフォルダを作成して、そこにセーブします。 (初期値:システム定数のFILE_URL[={@og.value org.opengion.hayabusa.common.SystemData#FILE_URL}])。
4.0.0.0 (2005/01/31) StringUtil.urlAppend メソッドの利用 |
4.0.0.0 (2007/11/20) 指定されたディレクトリ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。 |
5.7.1.1 (2013/12/13) リクエスト変数が使えないエラーを表示する。 |
5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。 |
5.9.13.1 (2016/10/21) チェックは行わない |
public void setMaxPostSize(java.lang.String maxPS)
maxPS
- 最大転送サイズ最大転送サイズを指定します。初期値は、10*1024*1024 = 10MB です。 指定は、Byte 単位で指定します。 0,またはマイナスを指定することで、制限チェックを外す(=無制限)事ができます。
3.0.1.1 (2003/03/06) maxPostSize の設定バグ修正。 |
5.6.5.3 (2013/06/28) コメント追加(0,またはマイナスで無制限) |
5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。 |
public void setTableId(java.lang.String id)
id
- sessionに登録する時の ID検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に 渡す場合に、通常は、session を利用します。その場合の登録キーです。 query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、 この tableId 属性を利用して、メモリ空間を分けます。 (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])。
5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。 |
public void setFilename(java.lang.String fname)
fname
- ファイル名ファイルを作成するときのファイル名をセットします。 これは、複数同時にアップロードファイル名を変更する時に使用できません。 通常、アップロードされたファイル名を指定する場合、アップロードするinput タグの name 属性に指定する名称 + "_NEW" というリクエスト値を同時に送信すれば、 内部的に関連付けて、ファイル名を更新します。 その場合、クライアントより指定したファイル名は、name属性+"_ORG" という リクエスト値として取得することが可能になります。 name属性 には、最終的に設定されたファイル名がセットされています。 いずれの値も、{@name属性+"_ORG"} や、{@name属性+"_NEW"}として、 アップロードのオリジナルと変更後のファイル名を取得することが出来ます。 5.7.1.2 (2013/12/20) zip 対応 filename 属性に、".zip" の拡張子のファイル名を指定した場合は、アップロードされた一連のファイルを ZIP圧縮します。これは、アップロード後の処理になります。 ZIP圧縮のオリジナルファイルは、そのまま残ります。 なお、ZIPファイルは、useBackup属性を true に設定しても、無関係に、上書きされます。 5.7.4.3 (2014/03/28) filename 属性のリクエスト変数対応 filename 属性のみ、{@XXXX} のリクエスト変数が使えるようにします。 他のパラメータでは使えません。 これは、multipart/form-data のリクエストでは、パートの分解処理をしないと、リクエスト変数が 拾えない為、リクエスト変数は、この、upload タグ以降でのみ利用可能でした。 zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。
3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。 |
5.7.1.1 (2013/12/13) リクエスト変数が使えないエラーを表示する。 |
5.7.4.3 (2014/03/28) リクエスト変数を使えるようにします。 |
public void setColumns(java.lang.String clms)
clms
- DBTableModel作成時のカラム列(カンマ区切り文字)現状は、"KEY","VALUE","ISFILE" のカラムに、データを縦持ちで作成しています。 これを、横持で作成しますが、カラムの末尾に、"_01"~"_99" までの添え字を 持つ場合は、これをレコードと認識させます。 アンダーバーがない場合は、カラムだけ作成されます。カラム名と同じリクエストがあれば、 すべてのレコードに同じ値がセットされます。 この処理は、columns 属性を設定した場合のみとします。
5.6.5.2 (2013/06/21) 新規作成 |
5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。 |
public void setUseBackup(java.lang.String flag)
flag
- ファイルアップロード時に、バックアップ処理(renameTo)するかどうか[true/false]を指定ファイルアップロード時に、アップロード先に、同名のファイルが存在した場合は、既存機能は、そのまま 置き換えていましたが、簡易バージョンアップ機能として、useBackup="true" を指定すると、既存のファイルを リネームして、バックアップファイルを作成します。 バックアップファイルは、アップロードフォルダを基準として、_backup/ファイル名.拡張子_処理時刻のlong値.拡張子 になります。 オリジナルのファイル名(拡張子付)を残したまま、"_処理時刻のlong値" を追加し、さらに、オリジナルの拡張子を追加します。 バックアップファイルの形式は指定できません。 初期値は、互換性を持たせるため、false です。
5.6.5.3 (2013/06/28) 新規作成 |
5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。 |
protected java.lang.String getTagName()
getTagName
クラス内 CommonTagSupport
CommonTagSupport.getDocumentLink()
4.0.0.0 (2005/01/31) 新規追加 |
public java.lang.String toString()
toString
クラス内 CommonTagSupport
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.