概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
openGion 5.7.2.0
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## org.opengion.hayabusa.taglib
クラス FileUDTag

    java.lang.Object
      javax.servlet.jsp.tagext.TagSupport
          javax.servlet.jsp.tagext.BodyTagSupport
              org.opengion.hayabusa.taglib.CommonTagSupport
                  org.opengion.hayabusa.taglib.FileUDTag

すべての実装されたインタフェース:
  java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag, javax.servlet.jsp.tagext.TryCatchFinally

    public class FileUDTag

extends CommonTagSupport

ファイルアップロード/ダウンロードリンクを作成するタグです(通常は result_info.jsp に組込み)。 画面検索した結果を、ダウンロードしたり、アップロードする機能は、画面リソースの ロール制御で管理しています。 ただし、デフォルトで、以下の制限が掛かっています。 ファイルダウンロード ・command="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW" のみ ファイルアップロード ・command="COPY|INSERT" のみ また、typeDownload="true" にするとDownload 処理を行う為の前処理を実施します。 Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の DBTableModel がマッチしているか判定します。 また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、 最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、 エラーを返す必要があります。 それら、一連のDownload 処理を行うかどうかを指定します。 true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された DBLastSql オブジェクトを取得し、scope が request または、overflow が true の場合に、BODY部を実行します。(通常、queryタグを記述します。) query の出力先は、scope を request にします。 それ以外は、tableId から取り出した DBTableModel を、scope = "request" に(アドレスのみ)コピーします。 writeTable タグでは、scope = "request" から、DBTableModel を取り出します。

関連項目:
  直列化された形式
形式サンプル:

       ●形式：一般ユーザーが直接組み込むことはありません。
       ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)

       ●Tag定義：
         <og:fileUD
             command            【TAG】command を指定します
             downloadImg        【TAG】ダウンロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileDownload.gif")
             downloadJsp        【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileDownload.jsp")
             uploadImg          【TAG】アップロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileUpload.gif")
             uploadJsp          【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileUpload.jsp")
             imgWidth           【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)
             imgHeight          【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)
             filename           【TAG】ダウンロード時ファイル名を指定します(初期値:"{@GUI.LABEL}.xls")
             roles              【TAG】ロールズをセットします
             target             【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します
             errorMsg           【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0028)
             typeDownload       【TAG】Download 処理を行うかどうかを指定します(初期値:false)
             editImg            【TAG】編集アイコンを指定します(初期値:"{@SYS.JSP}/image/edit.png")
             clmEdit            【TAG】編集時にカラムEditを表示するかどうか(初期値:true)
             debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
         >   ... Body ...
         </og:fileUD>

       ●使用例
           <og:fileUD command="{@command}" />

           <og:fileUD
               command        = command設定 (ダウンロード="NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW" 、   アップロード="COPY|INSERT")
             [ downloadImg ]  = "{@SYS.JSP}/image/fileDownload.gif"   ダウンロード時のアイコン
             [ downloadJsp ]  = "{@SYS.JSP}/common/fileDownload.jsp"  ダウンロード時の呼び出しJSP
             [ uploadImg   ]  = "{@SYS.JSP}/image/fileUpload.gif"     アップロード時のアイコン
             [ uploadJsp   ]  = "{@SYS.JSP}/common/filePopup.jsp"     アップロード時の呼び出しJSP
             [ imgWidth    ]  = "20px"                                アイコン幅サイズ(px)
             [ imgHeight   ]  = "20px"                                アイコン高さサイズ(px)
             [ filename    ]  = "{@GUI.LABEL}.xls"               ダウンロード時ファイル名
             [ roles       ]  = "GE|DOC"                              アクセスロールズ
             [ target      ]  = "_blank"                              ダウンロードファイルを開くターゲット
             [ errorMsg    ]  = "ERR0028"                             エラーメッセージID
             [ typeDownload]  = "false/true"                          Download 処理を行うかどうか(初期値:false)
           />

変更履歴:

  4.3.0.0 (2008/07/04) 新規追加

機能分類
  ファイルアップロード/ダウンロード
バージョン
  4.0
作成者
  Kazuhiko Hasegawa
導入されたバージョン:
  JDK5.0,

フィールドの概要

クラス javax.servlet.jsp.tagext.BodyTagSupport から継承されたフィールド
`bodyContent`

クラス javax.servlet.jsp.tagext.TagSupport から継承されたフィールド
`id, pageContext`

インタフェース javax.servlet.jsp.tagext.BodyTag から継承されたフィールド
`EVAL_BODY_BUFFERED, EVAL_BODY_TAG`

インタフェース javax.servlet.jsp.tagext.IterationTag から継承されたフィールド
`EVAL_BODY_AGAIN`

インタフェース javax.servlet.jsp.tagext.Tag から継承されたフィールド
`EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

コンストラクタの概要
`FileUDTag()`

メソッドの概要
`int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
`int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
`protected void` | `release2()` タグリブオブジェクトをリリースします。
`void` | `setClmEdit(java.lang.String type)` 【TAG】Edit画面でカラム編集を出すかどうか(初期値：true)
`void` | `setCommand(java.lang.String cmd)` 【TAG】command を指定します。
`void` | `setDownloadImg(java.lang.String img)` 【TAG】ダウンロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileDownload.gif")。
`void` | `setDownloadJsp(java.lang.String file)` 【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileDownload.jsp")。
`void` | `setEditImg(java.lang.String img)` 【TAG】編集アイコンを指定します(初期値:"{@SYS.JSP}/image/edit.png")。
`void` | `setErrorMsg(java.lang.String msg)` 【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0028)。
`void` | `setFilename(java.lang.String file)` 【TAG】ダウンロード時ファイル名を指定します(初期値:"{@GUI.LABEL}.xls")。
`void` | `setImgHeight(java.lang.String height)` 【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)。
`void` | `setImgWidth(java.lang.String width)` 【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)。
`void` | `setRoles(java.lang.String rls)` 【TAG】ロールズをセットします。
`void` | `setTarget(java.lang.String flag)` 【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します。
`void` | `setTypeDownload(java.lang.String type)` 【TAG】Download 処理を行うかどうかを指定します(初期値:false)。
`void` | `setUploadImg(java.lang.String img)` 【TAG】アップロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileUpload.gif")。
`void` | `setUploadJsp(java.lang.String file)` 【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileUpload.jsp")。
`java.lang.String` | `toString()` このオブジェクトの文字列表現を返します。

クラス org.opengion.hayabusa.taglib.CommonTagSupport から継承されたメソッド
`add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, 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, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, 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`

クラス javax.servlet.jsp.tagext.BodyTagSupport から継承されたメソッド
`doInitBody, getBodyContent, getPreviousOut, release, setBodyContent`

クラス javax.servlet.jsp.tagext.TagSupport から継承されたメソッド
`findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

インタフェース javax.servlet.jsp.tagext.Tag から継承されたメソッド
`getParent, setPageContext, setParent`

コンストラクタの詳細

### FileUDTag

    public FileUDTag()

メソッドの詳細

### doStartTag

    public int doStartTag()

  Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。

  定義:
    インタフェース `javax.servlet.jsp.tagext.Tag` 内の `doStartTag`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doStartTag`
  戻り値:
    後続処理の指示(SKIP_BODY)
  変更履歴:

    5.1.6.0 (2010/05/01) 画面項目並べ替え対応

### doEndTag

    public int doEndTag()

  Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。

  定義:
    インタフェース `javax.servlet.jsp.tagext.Tag` 内の `doEndTag`
  オーバーライド:
    クラス `CommonTagSupport` 内の `doEndTag`
  戻り値:
    後続処理の指示
  変更履歴:

    4.3.0.1 (2008/08/11) callBack パラメータの設定漏れ修正、引数から見直し
    5.1.6.0 (2010/05/01) 帳票画面定義機能対応
    5.1.7.0 (2010/06/01) 進む・戻るボタンでもExcel出力ボタンを出す
    5.3.6.0 (2011/06/01) Edit機能見直し
    5.3.7.0 (2011/07/01) Excel取込で画面IDとアドレスが異なる場合にエラーとなるバグを修正
    5.3.7.0 (2011/07/01) 編集画面をリサイズできるように対応します。
    5.3.7.0 (2011/07/01) PL/SQLを利用した検索でファイルダウンロードが出来るように対応します。
    5.4.2.0 (2011/12/01) 画面リソースで画面編集機能のON/OFFを設定できるようにする。
    5.5.2.4 (2012/05/16) nullに対する冗長な比較
    5.5.5.2 (2012/08/20) 画面リソースのoモード対応
    5.5.6.2 (2012/09/24) makeTagのtarget対応
    5.6.0.2 (2013/01/19) editモードのisEditコントロール対応

### release2

    protected void release2()

  タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。

  オーバーライド:
    クラス `CommonTagSupport` 内の `release2`

### setCommand

    public void setCommand(java.lang.String cmd)

  【TAG】command を指定します。

  パラメータ:
    `cmd` - コマンド[NEW/RENEW/FIRST/LAST/PREV/NEXT/VIEW]
  説明:

         command を指定します。
         ダウンロードは、"NEW|RENEW|FIRST|LAST|PREV|NEXT|VIEW" のみ有効です。
         アップロードは、"COPY|INSERT" のみ有効です。
         それ以外のコマンドでは、アイコンは表示されません。
         例えば、NEXT/PREV など。

### setDownloadImg

    public void setDownloadImg(java.lang.String img)

  【TAG】ダウンロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileDownload.gif")。

  パラメータ:
    `img` - ダウンロード時のアイコン
  説明:

         ダウンロード時に表示されるアイコンを指定します。
         初期値:"{@SYS.JSP}/image/fileDownload.gif" です。

### setDownloadJsp

    public void setDownloadJsp(java.lang.String file)

  【TAG】ダウンロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileDownload.jsp")。

  パラメータ:
    `file` - ダウンロード時の呼び出しJSP
  説明:

         ダウンロード時に呼び出されるJSPファイル名を指定します。
         初期値:"{@SYS.JSP}/common/fileDownload.jsp" です。

### setUploadImg

    public void setUploadImg(java.lang.String img)

  【TAG】アップロード時のアイコンを指定します(初期値:"{@SYS.JSP}/image/fileUpload.gif")。

  パラメータ:
    `img` - アップロード時のアイコン
  説明:

         アップロード時に表示されるアイコンを指定します。
         初期値:"{@SYS.JSP}/image/fileUpload.gif" です。

### setUploadJsp

    public void setUploadJsp(java.lang.String file)

  【TAG】アップロード時の呼び出しJSPを指定します(初期値:"{@SYS.JSP}/common/fileUpload.jsp")。

  パラメータ:
    `file` - アップロード時の呼び出しJSP
  説明:

         アップロード時に呼び出されるJSPファイル名を指定します。
         初期値:"{@SYS.JSP}/common/fileUpload.jsp" です。

### setImgWidth

    public void setImgWidth(java.lang.String width)

  【TAG】アイコン幅サイズ(px)を指定します(初期値:20px)。

  パラメータ:
    `width` - アイコン幅サイズ(px)
  説明:

         アップロード/ダウンロードのアイコンを表示する際の幅サイズ(px)を指定します。
         ファイルサイズは、アップロード/ダウンロード共通です。
         初期値は、20px です。

### setImgHeight

    public void setImgHeight(java.lang.String height)

  【TAG】アイコン高さサイズ(px)を指定します(初期値:20px)。

  パラメータ:
    `height` - アイコン高さサイズ(px)
  説明:

         アップロード/ダウンロードのアイコンを表示する際の高さサイズ(px)を指定します。
         ファイルサイズは、アップロード/ダウンロード共通です。
         初期値は、20px です。

### setFilename

    public void setFilename(java.lang.String file)

  【TAG】ダウンロード時ファイル名を指定します(初期値:"{@GUI.LABEL}.xls")。

  パラメータ:
    `file` - ダウンロード時ファイル名("{@GUI.LABEL}.xls")
  説明:

         ダウンロード時のファイル名を指定します
         通常は、画面のラベル(言語対応)＋XLS拡張子です。
         初期値は、"{@GUI.LABEL}.xls" です。

### setRoles

    public void setRoles(java.lang.String rls)

  【TAG】ロールズをセットします。

  パラメータ:
    `rls` - パラメータ
  説明:

         ここで指定したロールを元に、ユーザー毎のアクセス許可がチェックされます。
         アクセス許可されないと、表示されません。
         このロールを指定しない場合は、画面のロールが使用されます。

### setTarget

    public void setTarget(java.lang.String flag)

  【TAG】ダウンロード文書を表示させるフレーム、またはウィンドウの名前を指定します。

  パラメータ:
    `flag` - ダウンロード文書のフレーム名(ターゲット属性)
  説明:

         フレーム名(ターゲット属性)を設定します。

### setTypeDownload

    public void setTypeDownload(java.lang.String type)

  【TAG】Download 処理を行うかどうかを指定します(初期値:false)。

  パラメータ:
    `type` - Download 処理を行うかどうか(初期値:false)
  説明:

         Download 処理を行うには、指定の画面(呼び出し元)と、抜き出した時の
         DBTableModel がマッチしているか判定します。
         また、DBTableModel が存在しない、または、不備な場合(オーバーフロー)は、
         最終SQLを実行する必要があり、そもそも、抜出処理が出来ない状態では、
         エラーを返す必要があります。
         それら、一連のDownload 処理を行うかどうかを指定します。
         true の場合、session の HybsSystem.DB_LAST_SQL_KEY に格納された
         DBLastSql オブジェクトを取得し、scope が request または、overflow が
         true の場合に、BODY部を実行します。(通常、queryタグを記述します。)
         query の出力先は、scope を request にします。
         それ以外は、tableId から取り出した DBTableModel を、scope = "request"
         に(アドレスのみ)コピーします。
         writeTable タグでは、scope = "request" から、DBTableModel を取り出します。

         初期値は、false(抜き出しでは無くリンク作成) です。

### setErrorMsg

    public void setErrorMsg(java.lang.String msg)

  【TAG】ダウンロード出来ない場合のエラーメッセージIDを指定します(初期値:ERR0028)。

  パラメータ:
    `msg` - ダウンロード文書のフレーム名(ターゲット属性)
  説明:

         DBTableModel が、最後に作成された画面と、メモリ中の DBLastSql オブジェクトが
         管理している情報が異なる場合は、ダウンロード出来ません。
         同様に、DBLastSql オブジェクト 自身が作成されていない場合も出来ません。
         そのようなケースに表示するエラーメッセージのメッセージIDを指定します。
         引数は、指定できません。
         初期値は、『ERR0028：選択されていません。もう一度、選択しなおして下さい。』 です。

### setEditImg

    public void setEditImg(java.lang.String img)

  【TAG】編集アイコンを指定します(初期値:"{@SYS.JSP}/image/edit.png")。

  パラメータ:
    `img` - アップロード時のアイコン
  説明:

         編集アイコンを指定します。
         初期値:"{@SYS.JSP}/image/edit.png" です。

  変更履歴:

    5.1.6.0 (2010/05/01) 新規追加

### setClmEdit

    public void setClmEdit(java.lang.String type)

  【TAG】Edit画面でカラム編集を出すかどうか(初期値：true)

  パラメータ:
    `type` - カラム編集タブを出すかどうか(初期値:true)
  説明:

         falseを指定するとカラム編集タブを出さない。

### toString

    public java.lang.String toString()

  このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。

  オーバーライド:
    クラス `CommonTagSupport` 内の `toString`
  戻り値:
    このクラスの文字列表現

概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
| openGion 5.7.2.0
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.