public class ReadTableTag extends CommonTagSupport
●形式:
<og:readTable
command = "NEW"
fileURL = "{@USER.ID}" 読み取り元ディレクトリ名
filename = "{@filename}" 読み取り元ファイル名
encode = "UnicodeLittle" 読み取り元ファイルエンコード名
maxRowCount = "10000" 読取最大件数(0:[無制限])
/>
●body:なし
●Tag定義:
<og:readTable
readerClass 【TAG】実際に読み出すクラス名の略称(TableReader_**** の ****)をセットします({@og.doc03Link readerClass 初期値:Default})
fileURL 【TAG】読み取り元ディレクトリ名を指定します(初期値:FILE_URL)
filename 【TAG】ファイルを作成するときのファイル名をセットします (初期値:FILE_FILENAME[=file.xls])
encode 【TAG】ファイルを作成するときのファイルエンコーディング名をセットします(初期値:FILE_ENCODE)
maxRowCount 【TAG】読取時の最大取り込み件数をセットします (初期値:DB_MAX_ROW_COUNT[=1000])(0:[無制限])
separator 【TAG】可変長ファイルを作成するときの項目区切り文字をセットします
tableId 【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID
command 【TAG】コマンド(NEW,RENEW)をセットします(初期値:NEW)
modifyType 【TAG】ファイル取り込み時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します
displayMsg 【TAG】query の結果を画面上に表示するメッセージIDを指定します(初期値:MSG0033[ 件検索しました])
notfoundMsg 【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])
sheetName 【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)
sheetNos 【TAG】EXCELファイルを読み込むときのシート番号を複数設定できます(初期値:0)
sheetConstKeys 【TAG】EXCELファイルを読み込むときの固定値となるカラム名(CSV形式)
sheetConstAdrs 【TAG】EXCELファイルを読み込むときの固定値となるアドレス(行-列,行-列,・・・)
nullBreakClm 【TAG】カラム列に NULL が現れた時点で読み取りを中止します(複数Sheetの場合は、次のSheetを読みます)。
columns 【TAG】読み取り元ファイルのカラム列を、外部(タグ)より指定します
useNumber 【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true)
adjustColumns 【TAG】読み取り元ファイルのデータ変換を行うカラム列をカンマ指定します
checkColumns 【TAG】読み取り元ファイルの整合性チェックを行うカラム列をカンマ指定します
nullCheck 【TAG】NULL チェックすべきカラム列をカンマ区切り(CVS形式)で指定します
language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します
stopZero 【TAG】読込件数が0件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する])
scope 【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session)
mainTrans 【TAG】(通常使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false)
skipRowCount 【TAG】(通常は使いません)データの読み飛ばし件数を設定します
useRenderer 【TAG】読取処理でラベルをコードリソースに逆変換を行うかどうかを指定します (初期値:USE_TABLE_READER_RENDERER[=false])
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)は、このタグは使用されます(初期値:true) 5.7.7.2 (2014/06/20)
caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:true) 5.7.7.2 (2014/06/20)
storageType 【TAG】読み取り元ストレージタイプを指定します
bucketName 【TAG】読み取り元バケット名を指定します
debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
/>
●使用例
<og:readTable
command = "NEW"
readerClass = "Fixed" 固定長データの読み取り
modifyType = "{@modifyType}" 読取時のモディファイタイプ(A,C等)
fileURL = "{@USER.ID}" 読み取り元ディレクトリ名
filename = "{@filename}" 読み取り元ファイル名
encode = "Shift_JIS" 読み取り元ファイルエンコード名
maxRowCount = "10000" 読取最大件数(0:[無制限])
columns = "OYA,KO,HJO,SU,DYSTR,DYEND" #NAME に対応するカラム列
useNumber = "false" 行番号の存在しないデータを読み取ります。
adjustColumns = "OYA,KO,HJO,SU" データ変換するカラム列("*" で全カラム)
checkColumns = "OYA,KO,HJO,SU" 整合性チェックするカラム列("*" で全カラム)
nullCheck = "OYA,KO,SU" NULLチェックを実行します("*" で全カラム)
stopZero = "true" 取得0件の場合に以降の処理を停止します
skipRowCount = "4" データの読み飛ばし件数(読み込み開始は、この数字+1行目から)
/>| 5.10.9.0 (2019/03/01) oota クラウドストレージ対応を追加。(Fileクラスを拡張) |
| 修飾子とタイプ | フィールドと説明 |
|---|---|
static java.lang.String |
CMD_NEW
command 引数に渡す事の出来る コマンド 新規作成 "NEW"
|
static java.lang.String |
CMD_RENEW
command 引数に渡す事の出来る コマンド 再検索 "RENEW"
|
| コンストラクタと説明 |
|---|
ReadTableTag() |
| 修飾子とタイプ | メソッドと説明 |
|---|---|
protected void |
create(java.io.BufferedReader out)
TableReader の実オブジェクトを生成して,BufferedReader に書き込みます。
|
int |
doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
|
protected void |
release2()
タグリブオブジェクトをリリースします。
|
void |
setAdjustColumns(java.lang.String clms)
【TAG】読み取り元ファイルのデータ変換を行うカラム列をカンマ指定します。
|
void |
setBucketName(java.lang.String bucket)
【TAG】読み取り元バケット名を設定します。
|
void |
setCheckColumns(java.lang.String clms)
【TAG】読み取り元ファイルの整合性チェックを行うカラム列をカンマ指定します。
|
void |
setColumns(java.lang.String clms)
【TAG】読み取り元ファイルのカラム列を、外部(タグ)より指定します。
|
void |
setCommand(java.lang.String cmd)
【TAG】コマンド(NEW,RENEW)をセットします(初期値:NEW)。
|
void |
setDisplayMsg(java.lang.String id)
【TAG】query の結果を画面上に表示するメッセージIDを指定します(初期値:MSG0033[ 件検索しました])。
|
void |
setEncode(java.lang.String enc)
【TAG】ファイルを作成するときのファイルエンコーディング名をセットします
(初期値:FILE_ENCODE[=])。
|
void |
setFilename(java.lang.String filename)
【TAG】ファイルを作成するときのファイル名をセットします
(初期値:FILE_FILENAME[=])。
|
void |
setFileURL(java.lang.String url)
【TAG】読み取り元ディレクトリ名を指定します
(初期値:FILE_URL[=])。
|
void |
setMainTrans(java.lang.String flag)
【TAG】(通常使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false)。
|
void |
setMatchKeys(java.lang.String keys)
【TAG】matchKeysをカンマ区切りで指定します。
|
void |
setMatchVals(java.lang.String keys)
【TAG】matchKeysをカンマ区切りで指定します。
|
void |
setMaxRowCount(java.lang.String count)
【TAG】読取時の最大取り込み件数をセットします
(初期値:DB_MAX_ROW_COUNT[=])。
|
void |
setModifyType(java.lang.String type)
【TAG】ファイル取り込み時の モディファイタイプ(A(追加),C(更新),D(削除))を指定します。
|
void |
setNotfoundMsg(java.lang.String id)
【TAG】検索結果がゼロ件の場合に表示するメッセージリソースIDを指定します(初期値:MSG0077[対象データはありませんでした])。
|
void |
setNullBreakClm(java.lang.String clm)
【TAG】ここに指定されたカラム列に NULL が現れた時点で読み取りを中止します。
|
void |
setNullCheck(java.lang.String clms)
【TAG】NULL チェックすべきカラム列をカンマ区切り(CVS形式)で指定します。
|
void |
setReaderClass(java.lang.String readerClass)
【TAG】実際に読み出すクラス名の略称(TableReader_**** の ****)をセットします(<a href="/gf/jsp/DOC03/index.jsp?command=NEW&GAMENID=DOC03&VERNO=null&VALUENAME=readerClass" target="CONTENTS">初期値:Default</a>)。
|
void |
setSeparator(java.lang.String separator)
【TAG】可変長ファイルを作成するときの項目区切り文字をセットします。
|
void |
setSheetConstAdrs(java.lang.String constAdrs)
【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのカラム名に対応するアドレスを指定します。
|
void |
setSheetConstKeys(java.lang.String constKeys)
【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのカラム名を指定します。
|
void |
setSheetName(java.lang.String sheet)
【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)。
|
void |
setSheetNos(java.lang.String sheet)
【TAG】EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。
|
void |
setSkipRowCount(java.lang.String count)
【TAG】(通常は使いません)データの読み飛ばし件数を設定します。
|
void |
setStopZero(java.lang.String cmd)
【TAG】読込件数が0件のとき処理を続行するかどうか[true/false]を指定します(初期値:false[続行する])。
|
void |
setStorageType(java.lang.String storage)
【TAG】読み取り元ストレージタイプを設定します。
|
void |
setTableId(java.lang.String id)
【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
(初期値:HybsSystem#TBL_MDL_KEY[=])。
|
void |
setUseNumber(java.lang.String useNo)
【TAG】行番号情報を、使用している/していない[true/false]を指定します(初期値:true)。
|
void |
setUseRenderer(java.lang.String flag)
【TAG】読取処理でラベルをコードリソースに逆変換を行うかどうかを指定します
(初期値:USE_TABLE_READER_RENDERER[=])。
|
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, getTagName, 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, useXssCheckpublic static final java.lang.String CMD_NEW
public ReadTableTag()
public int doEndTag()
doEndTag クラス内 CommonTagSupport| 3.0.1.4 (2003/03/17) displayMsg が 0Byteの場合は、件数も表示しないように変更。 |
| 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 |
| 3.5.4.1 (2003/12/01) 引数の BufferedReader を、InputStream に変更。 |
| 3.5.4.3 (2004/01/05) 引数の InputStream を、 BufferedReader に戻す。 |
| 3.5.6.5 (2004/08/09) 暫定的に、DBTableModelを先行削除します。 |
| 3.6.0.0 (2004/09/24) DBTableModel の先行削除は、scope="session" の場合のみ。 |
| 3.6.0.2 (2004/10/04) 取り込み時チェック用に、checkColumns,adjustColumns 属性追加 |
| 3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェックを行います。 |
| 3.8.5.3 (2006/08/07) readerClassが "Excel"でエラーが発生したとき、もう一度Defaultで再読取を行います。 |
| 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行います。 |
| 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel ) |
| 4.3.1.1 (2008/10/08) columnsが指定されている場合は、AutoReader禁止 |
| 4.3.7.0 (2009/06/01) stopZero機能,DB.COUNTリクエストキーへ読込件数セットを追加 |
| 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。 |
| 5.1.8.0 (2010/07/01) AutoReaderのCalc対応 |
| 5.1.9.0 (2010/08/01) AutoReaderでのExceptionの判定をThrowableに変更 |
| 5.7.1.2 (2013/12/20) tempMsg.toString() ⇒ errMsg 変更 |
| 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加 |
protected void release2()
release2 クラス内 CommonTagSupport| 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 |
| 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 |
| 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する。 |
| 3.1.4.0 (2003/04/18) command 属性に、初期値(NEW)を設定する。 |
| 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更。 |
| 3.5.4.5 (2004/01/23) 外部よりカラム列(カンマ区切り)を指定できるようにする。 |
| 3.6.0.2 (2004/10/04) checkColumns,adjustColumns,allColumnCheck 属性追加 |
| 3.7.0.5 (2005/04/11) useNumber 属性を追加します。 |
| 3.8.0.2 (2005/06/30) nullCheck 属性追加 |
| 3.8.5.3 (2006/08/07) readerClass 属性の初期値をシステムリソースより取得します。 |
| 4.3.7.0 (2009/06/01) stopZero属性追加 |
| 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。 |
| 5.1.6.0 (2010/05/01) データの読み飛ばし設定 skipRowCount 属性追加 |
| 5.2.1.0 (2010/10/01) 読取処理でコードリソースのラベル変換を行うかどうか useRenderer 属性追加 |
| 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるように、sheetNos属性追加 |
| 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定のための、sheetConstKeys、sheetConstAdrs属性追加 |
| 5.5.8.2 (2012/11/09) カラム列に NULL が現れた時点で読み取りを中止する、nullBreakClm属性追加 |
| 5.9.8.1 (2016/05/13) 読込条件の追加 |
protected void create(java.io.BufferedReader out)
out - 出力するBufferedReaderオブジェクト| 3.5.4.1 (2003/12/01) 引数の BufferedReader を、InputStream に変更。 |
| 3.5.4.2 (2003/12/15) TableReader のサブクラス名変更。 |
| 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更。 |
| 3.5.4.3 (2004/01/05) 引数の InputStream を、 BufferedReader に戻す。 |
| 3.5.4.5 (2004/01/23) TableReader に、encode を渡すように変更。 |
| 3.5.6.0 (2004/06/18) 各種プラグイン関連付け設定を、システムパラメータ に記述します。 |
| 3.7.0.5 (2005/04/11) useNumber 属性を追加します。 |
| 4.0.0.0 (2005/01/31) キーの指定を、TableReader. から、TableReader_ に変更します。 |
| 4.0.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更 |
| 5.1.6.0 (2010/05/01) データの読み飛ばし設定 skipRowCount 属性追加 |
| 5.2.1.0 (2010/10/01) 読取処理でコードリソースのラベル変換を行うかどうか設定 useRenderer 属性追加 |
| 5.5.7.2 (2012/10/09) 複数シートを指定できるようにシート番号を指定できるように、sheetNos属性追加 |
| 5.5.8.2 (2012/11/09) 固定値となるカラム名、アドレスの指定のための、sheetConstKeys、sheetConstAdrs属性追加 |
| 5.5.8.2 (2012/11/09) カラム列に NULL が現れた時点で読み取りを中止する、nullBreakClm属性追加 |
| 5.9.8.1 (2016/05/13) match対応 |
| 5.9.25.2 (2017/10/27) クラウドストレージ対応 |
| 5.10.9.0 (2019/03/01) クラウドストレージ対応を追加。 |
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}])。public void setSeparator(java.lang.String separator)
separator - 項目区切り文字可変長ファイルを作成するときの項目区切り文字をセットします。
public void setFileURL(java.lang.String url)
url - 読み取り元ディレクトリ名SystemData.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"/"で終わっていない場合に、"/"を付加する。 |
public void setFilename(java.lang.String filename)
filename - ファイル名SystemData.USE_SQL_INJECTION_CHECK ファイルを作成するときのファイル名をセットします。
(初期値:システム定数のFILE_FILENAME[={@og.value org.opengion.hayabusa.common.SystemData#FILE_FILENAME}])。public void setEncode(java.lang.String enc)
enc - ファイルエンコーディング名SystemData.FILE_ENCODE Shift_JIS,MS932,Windows-31J,UTF-8,ISO-8859-1,UnicodeLittle
(初期値:システム定数のFILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])。| 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更 |
| 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する。 |
public void setReaderClass(java.lang.String readerClass)
readerClass - クラス名(の略称)TableReaderのサブクラス実際に読み出すクラス名(の略称)をセットします。 これは、org.opengion.hayabusa.io 以下の TableReader_**** クラスの **** を 与えます。これらは、TableReader インターフェースを継承したサブクラスです。 属性クラス定義の TableReader を参照願います。 readerClass TableReader_**** クラス
public void setMaxRowCount(java.lang.String count)
count - 読取時の最大取り込み件数SystemData.DB_MAX_ROW_COUNT DBTableModelのデータとして登録する最大件数をこの値に設定します。
サーバーのメモリ資源と応答時間の確保の為です。
0 をセットすると、無制限(Integer.MAX_VALUE)になります。
(初期値:ユーザー定数のDB_MAX_ROW_COUNT[={@og.value org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT}])。| 5.5.8.5 (2012/11/27) 0を無制限として処理します。 |
public void setCommand(java.lang.String cmd)
cmd - コマンド(public static final 宣言されている文字列)コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される フィールド定数値のいづれかを、指定できます。 何も設定されない、または、null の場合は、"NEW" が初期値にセットされます。
public void setDisplayMsg(java.lang.String id)
id - ディスプレイに表示させるメッセージ IDここでは、検索結果の件数や登録された件数をまず出力し、 その次に、ここで指定したメッセージをリソースから取得して 表示します。 表示させたくない場合は, displayMsg = "" をセットしてください。 初期値は、検索件数を表示します。
public void setNotfoundMsg(java.lang.String id)
id - ディスプレイに表示させるメッセージ IDここでは、検索結果がゼロ件の場合のみ、特別なメッセージを表示させます。 従来は、displayMsg と兼用で、『0 件検索しました』という表示でしたが、 displayMsg の初期表示は、OFF になりましたので、ゼロ件の場合のみ別に表示させます。 表示させたくない場合は, notfoundMsg = "" をセットしてください。 初期値は、MSG0077[対象データはありませんでした]です。
public void setModifyType(java.lang.String type)
type - ファイル取り込み時の モディファイタイプ(A,C,D属性)ファイル読み込み時に、そのデータをA(追加)、C(更新)、D(削除)の モディファイタイプをつけた状態にします。 その状態で、そのまま、update する事が可能になります。
public void setSheetName(java.lang.String sheet)
sheet - EXCELファイルのシート名setSheetNos( String )EXCELファイルを読み込む時に、シート名を指定します。これにより、複数の形式の 異なるデータを順次読み込むことや、シートを指定して読み取ることが可能になります。 sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 初期値は、指定なしです。
| 3.5.4.2 (2003/12/15) 新規追加 |
public void setSheetNos(java.lang.String sheet)
sheet - EXCELファイルのシート番号(0から始まる)setSheetName( String )EXCEL読み込み時に複数シートをマージして取り込みます。 シート番号は、0 から始まる数字で表します。 ヘッダーは、最初のシートのカラム位置に合わせます。(ヘッダータイトルの自動認識はありません。) よって、指定するシートは、すべて同一レイアウトでないと取り込み時にカラムのずれが発生します。 シート番号の指定は、カンマ区切りで、複数指定できます。また、N-M の様にハイフンで繋げることで、 N 番から、M 番のシート範囲を一括指定可能です。また、"*" による、全シート指定が可能です。 これらの組み合わせも可能です。( 0,1,3,5-8,10-* ) ただし、"*" に関しては例外的に、一文字だけで、すべてのシートを表すか、N-* を最後に指定するかの どちらかです。途中には、"*" は、現れません。 シート番号は、重複(1,1,2,2)、逆転(3,2,1) での指定が可能です。これは、その指定順で、読み込まれます。 sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。エラーにはならないのでご注意ください。 初期値は、0(第一シート) です。
| 5.5.7.2 (2012/10/09) 新規追加 |
public void setSheetConstKeys(java.lang.String constKeys)
constKeys - 固定値となるカラム名(CSV形式)setSheetConstAdrs( String )カラム名は、カンマ区切りで指定します。 これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として 設定することができます。 例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。 このメソッドは、isExcel() == true の場合のみ利用されます。
| 5.5.8.2 (2012/11/09) 新規追加 |
public void setSheetConstAdrs(java.lang.String constAdrs)
constAdrs - 固定値となるアドレス(行-列,行-列,・・・)setSheetConstKeys( String ) アドレスは、EXCEL上の行-列をカンマ区切りで指定します。
行列は、EXCELオブジェクトに準拠するため、0から始まる整数です。
0-0 ⇒ A1 , 1-0 ⇒ A2 , 0-1 ⇒ B1 になります。
これにより、シートの一か所に書かれている情報を、DBTableModel のカラムに固定値として
設定することができます。
例として、DB定義書で、テーブル名をシートの全レコードに設定したい場合などに使います。
このメソッドは、isExcel() == true の場合のみ利用されます。
5.7.6.3 (2014/05/23) より、
①EXCEL表記に準拠した、A1,A2,B1 の記述も処理できるように対応します。
なお、A1,A2,B1 の記述は、必ず、英字1文字+数字 にしてください。(A~Zまで)
②処理中のEXCELシート名をカラムに割り当てるために、"SHEET" という記号に対応します。
例えば、sheetConstKeys="CLM,LANG,NAME" とし、sheetConstAdrs="0-0,A2,SHEET" とすると、
NAMEカラムには、シート名を読み込むことができます。
これは、内部処理の簡素化のためです。
ちなみに、EXCELのセルに、シート名を表示させる場合の関数は、下記の様になります。
=RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))| 5.5.8.2 (2012/11/09) 新規追加 |
public void setNullBreakClm(java.lang.String clm)
clm - カラム列これは、指定のカラムは必須という事を条件に、そのレコードだけを読み取る処理を行います。 複数Sheetの場合は、次のSheetを読みます。 現時点では、Excel の場合のみ有効です。
| 5.5.8.2 (2012/11/09) 新規追加 |
public void setColumns(java.lang.String clms)
clms - 読み取り元ファイルのカラム列(カンマ区切り文字)読み取り元ファイルのカラム列を、外部(タグ)より指定します。 ファイルに記述された #NAME より優先して使用されます。 これは、元ファイルのカラムを順番に指定のカラム名に割り当てる機能で ファイルの特定のカラム列を抜き出して取り込む機能ではありません。
| 3.5.4.5 (2004/01/23) 新規作成 |
public void setCheckColumns(java.lang.String clms)
clms - 整合性チェックを行うカラム列(カンマ区切り文字)カラムオブジェクトのDBType属性に対応したチェックを行います。 指定のカラム名をカンマ区切り(CSV)で複数指定できます。 全てのカラムのチェックを行う場合は、allColumnCheck = "true" を 指定して下さい。 分解方法は、通常のパラメータ取得後に、CSV分解します。
| 3.6.0.2 (2004/10/04) 新規追加 取り込み時チェック用 |
| 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 |
public void setAdjustColumns(java.lang.String clms)
clms - データ変換を行うカラム列(カンマ区切り文字)カラムオブジェクトのDBType属性に対応したデータ変換を行います。 指定のカラム名をカンマ区切り(CSV)で複数指定できます。 分解方法は、通常のパラメータ取得後に、CSV分解します。
| 3.6.0.2 (2004/10/04) 新規追加 取り込み時データ変換 |
| 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 |
public void setNullCheck(java.lang.String clms)
clms - カラム列(CVS形式)nullCheck="AAA,BBB,CCC,DDD" 分解方法は、通常のパラメータ取得後に、CSV分解します。
| 3.8.0.2 (2005/06/30) 新規追加 |
| 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 |
public void setUseNumber(java.lang.String useNo)
useNo - 行番号情報 [true:使用する/false:使用しない]通常のフォーマットでは、各行の先頭に行番号が出力されています。 読み取り時に、#NAME 属性を使用する場合は、この行番号を無視しています。 #NAME 属性を使用せず、columns 属性でカラム名を指定する場合(他システムの 出力ファイルを読み取るケース等)では、行番号も存在しないケースがあり、 その様な場合に、useNumber="false" を指定すれば、データの最初から読み取り始めます。 この場合、出力データのカラムの並び順が変更された場合、columns 属性も 指定しなおす必要がありますので、できるだけ、#NAME 属性を使用するように してください。 なお、EXCEL 入力には、この設定は適用されません。(暫定対応) 初期値は、true(使用する) です。
| 3.7.0.5 (2005/04/11) 新規追加 |
public void setStopZero(java.lang.String cmd)
cmd - 読込件数が0件のとき、処理を [true:中止する/false:続行する]初期値は、false(続行する)です。
| 4.3.7.0 (2009/06/01) 新規追加 |
public void setMainTrans(java.lang.String flag)
flag - メイントランザクションかどうかこの値は、ファイルダウンロード処理に影響します。この値がtrueに指定された時にcommitされたDBTableModelが ファイルダウンロードの対象の表になります。 このパラメーターは、通常、各タグにより実装され、ユーザーが指定する必要はありません。 但し、1つのJSP内でDBTableModelが複数生成される場合に、前に処理したDBTableModelについてファイルダウンロードをさせたい 場合は、後ろでDBTableModelを生成するタグで、明示的にこの値をfalseに指定することで、ファイルダウンロード処理の対象から 除外することができます。
| 5.1.6.0 (2010/05/01) 新規作成 |
public void setSkipRowCount(java.lang.String count)
count - 読み始めの初期値TAB区切りテキストやEXCEL等のデータの読み始めの初期値を指定します。 ファイルの先頭行が、0行としてカウントしますので、設定値は、読み飛ばす 件数になります。(1と指定すると、1件読み飛ばし、2行目から読み込みます。) 読み飛ばしは、コメント行などは、無視しますので、実際の行数分読み飛ばします。 #NAME属性や、columns 属性は、有効です。
| 5.1.6.0 (2010/05/01) 新規作成 |
public void setUseRenderer(java.lang.String flag)
flag - コードリソースのラベル逆変換を行うかどうかSystemData.USE_TABLE_READER_RENDERER TableWriter_Renderer 系のクラスで出力した場合は、コードリソースがラベルで出力されます。
そのファイルを読み取ると、当然、エラーになります。
ここでは、コードリソースのカラムに対して、ラベルからコードを求める逆変換を行うことで、
Renderer 系で出力したファイルを取り込むことができるようにします。
ここでは、TableWriter 系と同様に、TableReader_Renderer 系のクラスを作るのではなく、
属性値のフラグで、制御します。
将来的には、TableWriter 系も廃止して、同様のフラグで制御するように変更する予定です。
(初期値:システム定数のUSE_TABLE_READER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER}])。| 5.2.1.0 (2010/10/01) 新規作成 |
public void setMatchKeys(java.lang.String keys)
keys - カラム列(カンマ区切り文字)ファイルから特定の行のみを読み取るためのmatchKeysを指定します。 matchKeysで指定したカラムに対して、matchValsの正規表現でチェックします。 この機能はTableReader_Defaultのみ有効です。 通常は指定する必要はありません。
| 5.9.8.1 (2016/05/13) 新規作成 |
public void setMatchVals(java.lang.String keys)
keys - カラム列(カンマ区切り文字)ファイルから特定の行のみを読み取るためのmatchKeysを指定します。 matchKeysで指定したカラムに対して、matchValsの正規表現でチェックします。 この機能はTableReader_Defaultのみ有効です。 通常は指定する必要はありません。
| 5.9.8.1 (2016/05/13) 新規作成 |
public void setStorageType(java.lang.String storage)
storage - 読み取り元ストレージタイプファイルを読み取り元の、ストレージタイプを設定します。 未設定の場合は、システムリソースの「CLOUD_TARGET」が参照されます。 自身のサーバを指定する場合は、「default」を設定してください。
| 5.10.9.0 (2019/03/01) 新規追加 |
public void setBucketName(java.lang.String bucket)
bucket - 読み取り元バケット名ファイルを読み取り元の、バケット名を指定します。 クラウドストレージ利用時のみ有効です。 未設定の場合は、システムリソースの「CLOUD_BUKET」が参照されます。
| 5.10.9.0 (2019/03/01) 新規追加 |
public java.lang.String toString()
toString クラス内 CommonTagSupport| 5.10.9.0 (2019/03/01) storageType,bucketNameを出力対象に追加。 |
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.