パッケージ org.opengion.hayabusa.taglib

クラス DirectTableInsertTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
jakarta.servlet.jsp.tagext.BodyTagSupport
org.opengion.hayabusa.taglib.CommonTagSupport
org.opengion.hayabusa.taglib.ExcelSheetSupport
org.opengion.hayabusa.taglib.ReadTableTag
org.opengion.hayabusa.taglib.DirectTableInsertTag
すべての実装されたインタフェース:
BodyTag, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
public class DirectTableInsertTag extends ReadTableTag
指定のﾌｧｲﾙを直接ﾃﾞｰﾀﾍﾞｰｽに登録するﾃﾞｰﾀ入力ﾀｸﾞです。 通常の readTable などは、DBTableModelｵﾌﾞｼﾞｪｸﾄを介して全件ﾒﾓﾘに ﾛｰﾄﾞしてから表示させる為、大量ﾃﾞｰﾀ処理ができません。 このﾀｸﾞでは、直接ﾌｧｲﾙを読み取りながらﾃﾞｰﾀﾍﾞｰｽ登録するので 大量ﾃﾞｰﾀをﾊﾞｯﾁ的に登録する場合に使用します。 読み取るﾌｧｲﾙは、先頭(または実ﾃﾞｰﾀが現れるまでに) #NAME 行が必要です。 これは、ﾌｧｲﾙﾃﾞｰﾀのｶﾗﾑ名を指定しています。また、columns 属性を使用すれば、 ﾌｧｲﾙの#NAME 行より優先して(つまり存在していなくても良い)ﾃﾞｰﾀのｶﾗﾑ名を 指定することが出来ます。 この#NAME 行は、ﾌｧｲﾙのｾﾊﾟﾚｰﾀと無関係に必ずﾀﾌﾞ区切りで用意されています。 ﾀｸﾞのBODY部に、実行するSQL文を記述します。 このSQL文は、 INSERT INTO GE41 (CLM,NAME_JA,SYSTEM_ID,FGJ,DYSET) VALUES ([CLM],[NAME_JA],[SYSTEM_ID],'1','{@USER.YMDH}') と、いう感じで、ﾌｧｲﾙから読み込んだ値は、[ｶﾗﾑ名]に割り当てられます。 もちろん、通常の固定値(FGJに'1'をｾｯﾄ)や、ﾘｸｴｽﾄ変数(DYSETの{@USER.YMDH}) なども使用できます。 ※ 6.2.3.0 (2015/05/01) BODY部にSQL文を記述しない場合は、table 属性に、INSERTするﾃｰﾌﾞﾙIDを指定します。 ※ 6.2.4.0 (2015/05/15) omitNames に、WRITABLE と ROWID を、強制的に含めます(無条件)。 ※ 7.3.1.3 (2021/03/09) DB.NAMES , DB.ORGNAMES #NAME や columns で指定したｶﾗﾑは、{@DB.NAMES} で取り出すことが可能です。 ﾌｧｲﾙにかかれた、ｵﾘｼﾞﾅﾙの #NAME は、{@DB.ORGNAMES} で取り出すことが可能です。 ※ このﾀｸﾞは、Transaction ﾀｸﾞの対象です。
関連項目:
機能分類
ﾌｧｲﾙ入力
形式ｻﾝﾌﾟﾙ:
●形式：<og:directTableInsert filename="[･･･]" ･･･ >INSERT INTO ･･･ </og:directTableInsert > ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) ●Tag定義： <og:directTableInsert readerClass 【TAG】実際に読み出すｸﾗｽ名の略称(TableReader_**** の ****)をｾｯﾄします (初期値:TABLE_READER_DEFAULT_CLASS[=]) 専 commitBatch 【TAG】指定数毎にｺﾐｯﾄを発行します(初期値:0 終了までｺﾐｯﾄしません) 専 dbid 【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT) 専 table 【TAG】BODYのSQL文を指定しない場合に使用するﾃｰﾌﾞﾙIDを指定します command 【TAG】ｺﾏﾝﾄﾞ (NEW,RENEW)をｾｯﾄします(初期値:NEW) fileURL 【TAG】読取元ﾃﾞｨﾚｸﾄﾘ名を指定します(初期値:FILE_URL) filename 【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします (初期値:FILE_FILENAME[=file.xls]) encode 【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙｴﾝｺｰﾃﾞｨﾝｸﾞ名をｾｯﾄします(初期値:FILE_ENCODE) skipRowCount 【TAG】(通常は使いません)ﾃﾞｰﾀの読み飛ばし件数を設定します maxRowCount 【TAG】読取時の最大取り込み件数をｾｯﾄします (初期値:0:[無制限]) errRowCount 【TAG】読取時の最大ｴﾗｰ件数をｾｯﾄします (初期値:)(0:[無制限]) separator 【TAG】可変長ﾌｧｲﾙを作成するときの項目区切り文字をｾｯﾄします columns 【TAG】読取元ﾌｧｲﾙのｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します omitNames 【TAG】読取対象外のｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します modifyType 【TAG】ﾌｧｲﾙ取り込み時の ﾓﾃﾞｨﾌｧｲﾀｲﾌﾟ(A(追加),C(更新),D(削除))を指定します displayMsg 【TAG】query の結果を画面上に表示するﾒｯｾｰｼﾞIDを指定します(初期値:VIEW_DISPLAY_MSG[=])) overflowMsg 【TAG】読取ﾃﾞｰﾀが最大検索数をｵｰﾊﾞｰした場合に表示するﾒｯｾｰｼﾞﾘｿｰｽIDを指定します (初期値:MSG0007[検索結果が、制限行数を超えましたので、残りはｶｯﾄされました]) notfoundMsg 【TAG】検索結果がｾﾞﾛ件の場合に表示するﾒｯｾｰｼﾞﾘｿｰｽIDを指定します(初期値:MSG0077[対象ﾃﾞｰﾀはありませんでした]) ※ sheetName 【TAG】EXCELﾌｧｲﾙを読み込むときのｼｰﾄ名を設定します(初期値:指定なし) ※ sheetNos 【TAG】EXCELﾌｧｲﾙを読み込むときのｼｰﾄ番号を複数設定できます(初期値:0) ※ sheetConstKeys 【TAG】EXCELﾌｧｲﾙを読み込むときの固定値となるｶﾗﾑ名(CSV形式) ※ sheetConstAdrs 【TAG】EXCELﾌｧｲﾙを読み込むときの固定値となるｱﾄﾞﾚｽ(行-列,行-列,･･･) nullBreakClm 【TAG】ｶﾗﾑ列に NULL が現れた時点で読取を中止します(複数Sheetの場合は、次のSheetを読みます)。 nullSkipClm 【TAG】ｶﾗﾑ列に NULL が現れたﾚｺｰﾄﾞは読み飛ばします。 useNumber 【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true) useRepeatClms 【TAG】読取処理で横持ちﾃﾞｰﾀの繰り返しが存在する場合に、trueを指定します(初期値:false) 7.3.0.0 (2021/01/06) useRenderer 【TAG】読取処理でKEY:VAL形式のｺｰﾄﾞﾘｿｰｽから、KEYを取り出す処理を行うかどうかを指定します(初期値:USE_TABLE_READER_RENDERER[=false]) adjustColumns 【TAG】読取元ﾌｧｲﾙのﾃﾞｰﾀ変換を行うｶﾗﾑ列をｶﾝﾏ指定します checkColumns 【TAG】読取元ﾌｧｲﾙの整合性ﾁｪｯｸを行うｶﾗﾑ列をｶﾝﾏ指定します useStrict 【TAG】整合性ﾁｪｯｸ時に、厳密にﾁｪｯｸするかどうか[true/false]を指定します(初期値:true) 7.3.2.0 (2021/03/19) nullCheck 【TAG】NULL ﾁｪｯｸすべきｶﾗﾑ列をCSV形式(CSV形式)で指定します matchKeys 【TAG】ﾚｺｰﾄﾞの読取条件指定時のｶﾗﾑ列をCSV形式で指定します 6.4.6.0 (2016/05/27) matchVals 【TAG】ﾚｺｰﾄﾞの読取条件指定時のｶﾗﾑ列に対応する正規表現ﾃﾞｰﾀをCSV形式で指定します 6.4.6.0 (2016/05/27) language 【TAG】ﾀｸﾞ内部で使用する言語ｺｰﾄﾞ[ja/en/zh/…]を指定します stopZero 【TAG】読込件数が０件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する]) mainTrans 【TAG】(通常は使いません)ﾀｸﾞで処理される処理がﾒｲﾝとなるﾄﾗﾝｻﾞｸｼｮﾝ処理かどうかを指定します(初期値:false) tableId 【TAG】(通常は使いません)sessionから所得する DBTableModelｵﾌﾞｼﾞｪｸﾄの ID scope 【TAG】ｷｬｯｼｭする場合のｽｺｰﾌﾟ[request/session/application]を指定します (初期値:session) useTimeView 【TAG】処理時間を表示する TimeView を表示するかどうかを指定します (初期値:VIEW_USE_TIMEBAR[=])。 useSLabel 【TAG】7.0.7.0 (2019/12/13) ｴﾗｰﾒｯｾｰｼﾞにSLABELを利用するかどうか[true/false]を指定します(初期値:false) useLocal 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても、ｸﾗｳﾄﾞ環境を使用しない場合、trueを指定します(初期値:false) 8.0.1.0 (2021/10/29) 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:directTableInsert> ●使用例 <og:directTableInsert dbid = "ORCL" 接続ﾃﾞｰﾀﾍﾞｰｽID(初期値:DEFAULT) separator = "," ﾌｧｲﾙの区切り文字(初期値:ﾀﾌﾞ) fileURL = "{@USER.ID}" 読み取り元ﾃﾞｨﾚｸﾄﾘ名 filename = "{@filename}" 読み取り元ﾌｧｲﾙ名 encode = "Shift_JIS" 読み取り元ﾌｧｲﾙｴﾝｺｰﾄﾞ名 displayMsg = "MSG0040" 登録完了後のﾒｯｾｰｼﾞ columns = "CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG" #NAME の代わりに使用するｶﾗﾑ列名 commitBatch = "100" この件数ずつｺﾐｯﾄを発行(初期値:無制限) useColumnCheck = "true" ｶﾗﾑﾁｪｯｸを行うかどうか(初期値:false) useColumnAdjust = "true" ｶﾗﾑ変換を行うかどうか(初期値:false) nullCheck = "CLM,SYSTEM_ID" NULLﾁｪｯｸを実行します。 > INSERT INTO GE41 (CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG, FGJ,DYSET,DYUPD,USRSET,USRUPD,PGUPD) VALUES ([CLM],[NAME_JA],[LABEL_NAME],[KBSAKU],[SYSTEM_ID],[LANG], '1','{@USER.YMDH}','{@USER.YMDH}','{@USER.ID}','{@USER.ID}','{@GUI.KEY}') </og:directTableInsert >
導入されたバージョン:
JDK5.0,

  • コンストラクタの詳細

    • DirectTableInsertTag

      public DirectTableInsertTag()
      ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
      変更履歴:
      6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.

  • メソッドの詳細

    • doStartTag

      public int doStartTag()
      Taglibの開始ﾀｸﾞが見つかったときに処理する doStartTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doStartTag インタフェース内 Tag
      オーバーライド:
      doStartTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示( EVAL_BODY_BUFFERED )
      変更履歴:
      6.2.2.0 (2015/03/27) ColumnActionListener 対応。, 6.2.3.0 (2015/05/01) table属性追加。BODYのSQL文が無くても、table属性で自動生成します。, 6.2.4.0 (2015/05/15) 無条件でOMITする名称を指定します。

    • doAfterBody

      public int doAfterBody()
      Taglibのﾀｸﾞ本体を処理する doAfterBody() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doAfterBody インタフェース内 IterationTag
      オーバーライド:
      doAfterBody クラス内 CommonTagSupport
      戻り値:
      後続処理の指示(SKIP_BODY)
      変更履歴:
      3.6.0.2 (2004/10/04) SQL文の [ｶﾗﾑ] 対応とﾊﾟｰｻｰ機能追加, 3.8.6.3 (2006/11/30) SQL 文の前後のｽﾍﾟｰｽを取り除きます。, 6.2.3.0 (2015/05/01) table属性追加。BODYのSQL文が無くても、table属性で自動生成します。

    • afterEnd

      protected int afterEnd()
      #doEndTag() の後続処理を記述します。 これは、ｻﾌﾞｸﾗｽで、DBTableModel以外の処理を行う場合に、 処理内容を分けるために用意します。
      オーバーライド:
      afterEnd クラス内 ReadTableTag
      戻り値:
      後続処理の指示
      変更履歴:
      6.2.2.0 (2015/03/27) #afterEnd() ﾒｿｯﾄﾞ 新規作成。, 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。checkColumns ｴﾗｰ処理が抜けていたので、追加します。, 7.0.7.0 (2019/12/13) useSLabel 属性を追加。

    • release2

      protected void release2()
      ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。 ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
      オーバーライド:
      release2 クラス内 ReadTableTag
      変更履歴:
      3.6.0.2 (2004/10/04) useColumnCheck,useColumnAdjust 属性追加, 3.8.0.2 (2005/06/30) nullCheck 属性追加, 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更, 5.5.7.1 (2012/10/05) skipRowCount追加, 5.7.6.2 (2014/05/16) stopZero属性追加, 6.2.2.0 (2015/03/27) ColumnActionListener 対応。, 6.2.3.0 (2015/05/01) table属性追加

    • create

      protected void create(File file)
      ﾌｧｲﾙｵﾌﾞｼﾞｪｸﾄ より読み込み、ﾃﾞｰﾀﾍﾞｰｽに書き込みます。
      オーバーライド:
      create クラス内 ReadTableTag
      パラメータ:
      file - ﾌｧｲﾙｵﾌﾞｼﾞｪｸﾄ
      変更履歴:
      3.6.0.2 (2004/10/04) ｶﾗﾑｵﾌﾞｼﾞｪｸﾄのDBType属性の整合性ﾁｪｯｸ, 3.8.0.2 (2005/06/30) nullﾁｪｯｸ確認, 3.8.5.1 (2006/05/08) 取込ﾃﾞｰﾀが name 列より少ない場合の対応を追加, 3.8.7.0 (2006/12/15) ｱｸｾｽﾛｸﾞ取得の為、ApplicationInfoｵﾌﾞｼﾞｪｸﾄを設定, 4.0.0.0 (2005/01/31) CheckColumnDataｸﾗｽ static 化、引数にResourceManager追加, 4.0.0.1 (2007/12/03) try ～ catch ～ finally をきちんと行う。, 5.1.9.0 (2010/08/01) Transaction 対応, 5.2.2.0 (2010/11/01)) ""で囲われているﾃﾞｰﾀに改行が入っていた場合の対応, 5.3.7.0 (2011/07/01) TransactionReal の引数変更, 5.3.8.0 (2011/08/01) pstmt.setObject で、useParamMetaData の判定を避けるため、pstmt.setString で代用(PostgreSQL対応), 5.5.7.1 (2012/10/05) omitFirstLine対応, 5.7.0.3 (2013/11/22) BufferedReaderのclose処理をこのﾒｿｯﾄﾞ内のfinallyで行う, 6.2.2.0 (2015/03/27) ColumnActionListener 対応。, 6.2.3.0 (2015/05/01) 行読み飛ばし nullSkipClm追加, 6.2.4.2 (2015/05/29) executeCount の設定がおかしい。DirectTableInsertTagでは、初期値が -1 のため、件数が１件少なくなっていた。, 6.2.5.0 (2015/06/05) AutoReaderの仕様変更。checkColumns ｴﾗｰ処理が抜けていたので、追加します。, 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。, 6.4.3.3 (2016/03/04) HybsSystem.newInstance(String,String) への置き換え。, 6.6.0.1 (2016/12/07) ｴﾝｺｰﾄﾞが複数ある場合、SQLのﾊﾟｰｽで、上書きするとｶﾗﾑ名が取れないﾊﾞｸﾞ修正。, 7.0.4.3 (2019/07/15) AutoReaderでencode指定の場合、columnNamesを複数回通ることがあるため、executeCountは都度ｸﾘｱする

    • setDbid

      public void setDbid(String id)
      【TAG】(通常は使いません)検索時のDB接続IDを指定します(初期値:DEFAULT)。
      パラメータ:
      id - ﾃﾞｰﾀﾍﾞｰｽ接続ID
      説明:
      検索時のDB接続IDを指定します。初期値は、DEFAULT です。

    • setCommitBatch

      public void setCommitBatch(String cmtBat)
      【TAG】指定数毎にｺﾐｯﾄを発行します(初期値:0 終了までｺﾐｯﾄしません)。
      パラメータ:
      cmtBat - ｺﾐｯﾄを発行する行数 (初期値:0)
      説明:
      通常は、全ての処理が正常に終了するか、なにもしないか(ﾄﾗﾝｻﾞｸｼｮﾝ) を判断すべきで、途中でのｺﾐｯﾄはしません。 しかし、場合によって、件数が異常に多い場合や、再実行可能な場合は、 途中でｺﾐｯﾄして、都度、処理できるものだけを処理してしまうという方法があります。 また、ﾛｰﾙﾊﾞｯｸｴﾘｱの関係などで、ﾃﾞｰﾀ量が多い場合に、処理時間が異常に 長くなる事があり、指定件数ごとのｺﾐｯﾄ機能を用意しています。 0 に設定すると、終了までｺﾐｯﾄしません。初期値は、0 です。

    • setTable

      public void setTable(String tbl)
      【TAG】BODYのSQL文を指定しない場合に使用するﾃｰﾌﾞﾙIDを指定します。
      パラメータ:
      tbl - ﾃｰﾌﾞﾙID
      変更履歴:
      6.2.3.0 (2015/05/01) table属性追加
      説明:
      通常は、BODYに記述したSQL文を実行しますが、ﾃｰﾌﾞﾙIDを指定すると、 INSERT用のSQL文を自動作成します。 その場合は、BODYのSQL文は設定不要です。 また、FILE.NAME という文字列を指定した場合は、file1 に指定した ﾌｧｲﾙ名から、拡張子を取り除いた名称をﾃｰﾌﾞﾙ名として使用します。

    • setUseTimeView

      public void setUseTimeView(String flag)
      【TAG】処理時間を表示する TimeView を表示するかどうか[true:する/false:しない]を指定します (初期値:VIEW_USE_TIMEBAR[=])。
      パラメータ:
      flag - 処理時間を表示 [true:する/false:しない]
      変更履歴:
      6.3.6.0 (2015/08/16) useTimeView の初期値を、VIEW_USE_TIMEBAR にする。
      説明:
      true に設定すると、処理時間を表示するﾊﾞｰｲﾒｰｼﾞが表示されます。 これは、DB検索、APｻｰﾊﾞｰ処理、画面表示の各処理時間をﾊﾞｰｲﾒｰｼﾞで 表示させる機能です。処理時間の目安になります。 (初期値:VIEW_USE_TIMEBAR[=])。

    • toString

      public String toString()
      このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します。 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します。
      オーバーライド:
      toString クラス内 ReadTableTag
      戻り値:
      このｸﾗｽの文字列表現
      このﾒｿｯﾄﾞは、nullを返しません