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

クラス WriteTableTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
jakarta.servlet.jsp.tagext.BodyTagSupport
org.opengion.hayabusa.taglib.CommonTagSupport
org.opengion.hayabusa.taglib.WriteTableTag
すべての実装されたインタフェース:
BodyTag, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
public class WriteTableTag extends CommonTagSupport
DBTableModelｵﾌﾞｼﾞｪｸﾄを指定のﾌｧｲﾙに出力するﾀｸﾞです。 ﾃﾞｰﾀ(DBTableModel)と、ｺﾝﾄﾛｰﾗ(WriteTableTagForm)を与えて、 外部からｺﾝﾄﾛｰﾙすることで、各種形式で ﾃﾞｰﾀ(DBTableModel)を表示できます。 writeTableﾀｸﾞ に対して、ｺﾏﾝﾄﾞを与えることにより、内部のｺﾝﾄﾛｰﾗの 実装に対応した形式でﾃﾞｰﾀを作成します。
関連項目:
機能分類
ﾌｧｲﾙ出力
形式ｻﾝﾌﾟﾙ:
●形式： <og:writeTable fileURL = "{@USER.ID}" 保存先ﾃﾞｨﾚｸﾄﾘ名 filename = "{@filename}" 保存ﾌｧｲﾙ名 encode = "UnicodeLittle" 保存ﾌｧｲﾙｴﾝｺｰﾄﾞ名 /> ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) ●Tag定義： <og:writeTable writerClass 【TAG】実際に書き出すｸﾗｽ名の略称(TableWriter_**** ｸﾗｽの ****)を指定します (初期値:TABLE_WRITER_DEFAULT_CLASS[=]) separator 【TAG】可変長ﾌｧｲﾙを作成するときの項目区切り文字をｾｯﾄします(初期値:TableWriter#TAB_SEPARATOR[= ]) headerSequence 【TAG】DBTableModelの出力順(LNSCD など)をｾｯﾄします。(7.2.6.1 (2020/07/17) H追加) fileURL 【TAG】ﾌｧｲﾙ保存先ﾃﾞｨﾚｸﾄﾘ名を指定します(初期値:FILE_URL[=]) baseURL 【TAG】ﾌｧｲﾙ保存先ﾃﾞｨﾚｸﾄﾘ名を指定します(初期値:ｺﾝﾃｷｽﾄﾊﾟｽ) 7.2.7.0 (2020/08/07) filename 【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします(初期値:FILE_FILENAME[=]) encode 【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙｴﾝｺｰﾃﾞｨﾝｸﾞ名をｾｯﾄします(初期値:FILE_ENCODE[=]) beforeDelete 【TAG】事前にﾌｧｲﾙを削除するかどうかをｾｯﾄします (初期値:false) fileAppend 【TAG】追加ﾓｰﾄﾞで書き込むかどうか[true/false]を指定します(初期値:false[新規ﾓｰﾄﾞ]) zip 【TAG】結果をﾌｧｲﾙに出力するときに、ZIPで圧縮するかどうか[true/false]を指定します(初期値:false) zipFilename 【TAG】ZIPﾌｧｲﾙを作成するときのZIPﾌｧｲﾙ名をｾｯﾄします(初期値:filename + ".zip") tableId 【TAG】(通常は使いません)sessionから所得する DBTableModelｵﾌﾞｼﾞｪｸﾄの ID scope 【TAG】ｷｬｯｼｭする場合のｽｺｰﾌﾟ[request/session/application]を指定します (初期値:session) useNumber 【TAG】行番号情報を、出力する/しない[true/false]を指定します(初期値:true) columns 【TAG】書き込み先ﾌｧｲﾙのｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します omitNames 【TAG】書き込み対象外のｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します useRenderer 【TAG】書込処理でｺｰﾄﾞﾘｿｰｽのﾗﾍﾞﾙ変換を行うかどうかを指定します (初期値:USE_TABLE_WRITER_RENDERER[=]) selectedAll 【TAG】ﾁｪｯｸ行のみを対象にするかを指定します(初期値:true) useLocal 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても、ｸﾗｳﾄﾞ環境を使用しない場合、trueを指定します(初期値:false) 8.0.1.0 (2021/10/29) ※ sheetName 【TAG】EXCELﾌｧｲﾙを書き出すときのｼｰﾄ名を設定します ※ refFileURL 【TAG】EXCEL雛型参照ﾌｧｲﾙのﾃﾞｨﾚｸﾄﾘ名をｾｯﾄします ※ refFilename 【TAG】EXCEL雛型参考ﾌｧｲﾙ名をｾｯﾄします ※ refSheetName 【TAG】EXCEL雛型参考ﾌｧｲﾙのｼｰﾄ名を設定します ※ sheetOverwrite 【TAG】EXCELでsheetNameでの指定ｼｰﾄ名に対して上書きを行うかどうかを指定します。 ※ recalcSheetName 【TAG】EXCELで、出力処理の最後にｾﾙの計算式の再計算をさせるｼｰﾄ名をCSV形式で指定します。 ※ fontName 【TAG】EXCEL出力時のﾃﾞﾌｫﾙﾄﾌｫﾝﾄ名を設定します (初期値:TABLE_WRITER_DEFAULT_FONT_NAME[=]) ※ fontPoint 【TAG】EXCEL出力時のﾃﾞﾌｫﾙﾄﾌｫﾝﾄﾎﾟｲﾝﾄ数を設定します (初期値:TABLE_WRITER_DEFAULT_FONT_POINTS[=]) ※ skipRowCount 【TAG】(通常は使いません)EXCEL出力時のﾃﾞｰﾀの書き込み開始位置を設定します ※ useCellStyle 【TAG】EXCEL出力時に、ﾃﾞｰﾀを書き込んだ範囲に罫線を入れるかどうかを指定します(初期値:false) ※ useAutoCellSize 【TAG】EXCEL出力時に、ｾﾙの幅をﾃﾞｰﾀの幅に自動的に合わせるかどうかを指定します(初期値:false) ※ useActiveWorkbook 【TAG】EXCEL出力時に、ｾﾙの有効範囲を設定するかどうかを指定します(初期値:false) ※ pageBreakColumn 【TAG】EXCEL出力時に、ｼｰﾄ変更するｷｰとなるｶﾗﾑ名を指定します(このｶﾗﾑの値がｼｰﾄ名になります) ※ fileBreakColumn 【TAG】EXCEL出力時に、ﾌｧｲﾙ名を変更するｷｰとなるｶﾗﾑ名を指定します(このｶﾗﾑの値がﾌｧｲﾙ名になります) ※ hyperLinkColumn 【TAG】EXCEL出力時に、Hyperlinkを作成するｷｰとなるｶﾗﾑ名と値となるｶﾗﾑ名を指定します ※ addTitleSheet 【TAG】EXCEL出力時に、存在するSheet名一覧を作成する場合に、そのSheet名を指定します。 language 【TAG】ﾀｸﾞ内部で使用する言語ｺｰﾄﾞ[ja/en/zh/…]を指定します 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:writeTable> 【廃止】6.9.5.0 (2018/04/23) 物理削除 // direct 【廃止】結果をﾀﾞｲﾚｸﾄにEXCEL起動するかどうか[true/false]を指定します(初期値:false[ﾌｧｲﾙ]) 6.9.5.0 (2018/04/23) 物理削除 // disposition 【廃止】Content-Disposition (inline:埋め込む/attachment:ﾀﾞｲｱﾛｸﾞを起動)を指定します(初期値:attachment) 6.9.5.0 (2018/04/23) 物理削除 ●使用例 <og:writeTable ･････ > <og:writeTableParam key = "Tablename" value="GE12" /> <og:writeTableParam key = "First" First:最初に登録 > insert into GE12bk select * from GE12 where SYSTEM_ID='**' </og:writeTableParam <og:writeTableParam key = "First" First:の２番目に登録 > delete from GE12 where SYSTEM_ID='**' and KBSAKU='0' </og:writeTableParam <og:writeTableParam key = "Last" Last:最後に登録 > update GE12 set XXXX='YYYY' where SYSTEM_ID='**' and KBSAKU='0' </og:writeTableParam </og:writeTableParam
導入されたバージョン:
JDK5.0,

  • コンストラクタの詳細

    • WriteTableTag

      public WriteTableTag()
      ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
      変更履歴:
      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 )
      変更履歴:
      5.5.9.1 (2012/12/07) 事前にﾌｧｲﾙを削除するかどうか（beforeDelete）ﾌﾗｸﾞを追加, 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加, 6.0.4.0 (2014/11/28) Zipﾌｧｲﾙ名を、内部変数化。(将来的に引数化を容易にするため), 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ対応, 8.0.0.2 (2021/10/15) ﾛｰｶﾙﾌｧｲﾙとｸﾗｳﾄﾞﾌｧｲﾙ間の移動, 8.5.4.2 (2024/01/12) PMD 7.0.0 CollapsibleIfStatements 対応

    • doEndTag

      public int doEndTag()
      Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doEndTag インタフェース内 Tag
      オーバーライド:
      doEndTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示
      変更履歴:
      2.1.3.1 (2002/12/13) ContentType を、x-msexcel から vnd.ms-excel に変更した。, 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。, 3.1.3.0 (2003/04/10) FILE_ENCODE から、ｴﾝｺｰﾄﾞ情報を取得する。, 3.1.5.0 (2003/04/20) Content-Disposition を外部から指定できるように変更。, 3.2.0.0 (2003/05/22) GZIPOutputStream を使用していたが、ZipOutputStream に変更。, 3.5.4.1 (2003/12/01) 引数の PrintWriter を、OutputStream に変更。, 3.5.4.3 (2004/01/05) 引数を PrintWriter に戻す。, 3.6.0.2 (2004/10/04) EXCELﾀﾞｲﾚｸﾄ出力時にﾌｧｲﾙｴﾝﾄﾞまで出力されない不具合対策, 3.8.0.9 (2005/10/17) disposition属性を使用できるように変更します。, 3.8.6.0 (2006/08/23) ﾌｫﾙﾀﾞがない場合は、複数階層分のﾌｫﾙﾀﾞを自動で作成します。, 4.3.4.3 (2008/12/22) Excel出力の判別方法を前方一致に変更, 5.1.6.0 (2010/05/01) 画面帳票作成機能対応, 5.5.2.0 (2012/05/01) ZIP時にもencodeが有効にする, 5.5.5.5 (2012/08/24) selectedAllの処理を追加, 5.5.9.1 (2012/12/07) beforeDeleteﾌﾗｸﾞの追加に伴う、ﾛｼﾞｯｸ変更, 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加, 6.0.4.0 (2014/11/28) Zip処理を、ZipOutputStream → ZipArchiveOutputStream に変更, 6.2.0.0 (2015/02/27) EXCEL出力のparamLevel初期値変更 3:標準推奨 → 4:個人設定可, 6.9.5.0 (2018/04/23) direct 廃止(false固定), 5.10.23.0 (2020/06/01) 書込み件数をﾘｸｴｽﾄ変数WRITE.COUNTに出力, 8.0.0.1 (2021/10/08) ｸﾗｳﾄﾞ対応, 8.0.0.2 (2021/10/15) ﾛｰｶﾙﾌｧｲﾙとｸﾗｳﾄﾞﾌｧｲﾙ間の移動

    • release2

      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.5.0 (2003/04/20) Content-Disposition を外部から指定できるように変更。, 3.5.4.2 (2003/12/15) EXCELのｼｰﾄ名を指定できるように変更。, 3.5.4.3 (2004/01/05) EXCEL雛型参照ﾌｧｲﾙのURL,filenameを追加します。, 3.8.5.3 (2006/08/07) writerClass 属性の初期値をｼｽﾃﾑﾘｿｰｽより取得します。, 3.8.5.3 (2006/08/07) fontName 属性を追加します。, 3.8.5.3 (2006/08/07) fontPoint 属性を追加します。, 3.8.6.0 (2006/08/23) directory 属性を追加します。, 4.0.0.0 (2005/02/28) XMLﾌｧｲﾙにｾｯﾄする、param を追加。, 5.2.1.0 (2010/10/01) 書込処理でｺｰﾄﾞﾘｿｰｽのﾗﾍﾞﾙ変換を行うかどうか useRenderer 属性追加, 5.5.5.5 (2012/08/24) selectedAll属性を追加, 5.5.9.1 (2012/12/07) 事前にﾌｧｲﾙを削除するかどうか。互換性のため、false に設定。推奨は、true, 5.7.9.0 (2014/08/08) ﾃﾞｰﾀの書き込み開始位置(skipRowCount)を設定, 6.0.2.0 (2014/09/19) EXCEL関係機能追加(useCellStyle,useAutoCellSize,useActiveWorkbook, pageBreakColumn,fileBreakColumn,hyperLinkColumn,addTitleSheet), 6.0.4.0 (2014/11/28) zipFilename属性を追加。, 6.1.0.0 (2014/12/26) omitNames 属性を追加, 6.2.0.0 (2015/02/27) EXCEL出力のparamLevel初期値変更 3:標準推奨 → 4:個人設定可, 5.9.12.1 (2016/09/09) sheetOverwrite で、雛形ｼｰﾄの使用時に、元のｼｰﾄ名を使用します。, 6.9.5.0 (2018/04/23) direct 廃止(false固定), 8.0.0.2 (2021/10/15) ﾛｰｶﾙﾌｧｲﾙとｸﾗｳﾄﾞﾌｧｲﾙ間の移動, 8.0.1.0 (2021/10/29) useLocal 属性を追加。

    • setTableId

      public void setTableId(String id)
      【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのｷｰを指定します (初期値:HybsSystem#TBL_MDL_KEY[=])。
      パラメータ:
      id - ﾃｰﾌﾞﾙID (sessionに登録する時のID)
      説明:
      検索結果より、DBTableModelｵﾌﾞｼﾞｪｸﾄを作成します。これを、下流のviewﾀｸﾞ等に 渡す場合に、通常は、session を利用します。その場合の登録ｷｰです。 query ﾀｸﾞを同時に実行して、結果を求める場合、同一ﾒﾓﾘに配置される為、 この tableId 属性を利用して、ﾒﾓﾘ空間を分けます。 (初期値:HybsSystem#TBL_MDL_KEY[=])。

    • setSeparator

      public void setSeparator(String separator)
      【TAG】可変長ﾌｧｲﾙを作成するときの項目区切り文字をｾｯﾄします (初期値:TableWriter#TAB_SEPARATOR[=])。
      パラメータ:
      separator - 項目区切り文字
      関連項目:
      説明:
      可変長ﾌｧｲﾙを作成するときの項目区切り文字をｾｯﾄします。 (初期値:TableWriter#TAB_SEPARATOR[=])。

    • setHeaderSequence

      public void setHeaderSequence(String hs)
      【TAG】DBTableModelの出力順(LNSCD など)をｾｯﾄします。
      パラメータ:
      hs - 出力順 (LNSCD など)
      説明:
      Label,Name,Size,Class,Data の各ﾌｨｰﾙﾄﾞの頭文字のｱﾙﾌｧﾍﾞｯﾄで 出力順を設定します。 N: Name(名前)属性。ﾌｧｲﾙを読み取る(DBTableReader)場合には必要です。 L: Label(ﾗﾍﾞﾙ)属性。指定のｶﾗﾑの名称を表示します。 S: Size(ｻｲｽﾞ)属性。指定のｶﾗﾑの桁数を表示します。 C: Class(ｸﾗｽ)属性。指定のｶﾗﾑのｸﾗｽ(文字、数字など)を表示します。 -: ----(区切り記号)属性。必要な箇所に入れることで、ﾍｯﾀﾞｰ部とﾃﾞｰﾀ部を分離します。 D: Data(ﾃﾞｰﾀ)属性。実際のﾃﾞｰﾀを繰り返し表示します。 H:#なしのLabel(ﾗﾍﾞﾙ)属性を出力します(EXCELは除く) ※ 7.2.6.1 (2020/07/17) H:Header(ﾍｯﾀﾞｰ)属性追加。Label(ﾗﾍﾞﾙ)属性の先頭の#を削除します。

    • setFileURL

      public void setFileURL(String url)
      【TAG】ﾌｧｲﾙ保存先ﾃﾞｨﾚｸﾄﾘ名を指定します (初期値:FILE_URL[=])。
      パラメータ:
      url - 保存先ﾃﾞｨﾚｸﾄﾘ名
      変更履歴:
      3.5.4.3 (2004/01/05) 内部処理を、makeFileURL に移動。, 4.0.0.0 (2005/01/31) StringUtil.urlAppend ﾒｿｯﾄﾞの利用, 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。, 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
      説明:
      この属性で指定されるﾃﾞｨﾚｸﾄﾘに、ﾌｧｲﾙをｾｰﾌﾞします。 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、２文字目が、 ":" (Windows)の場合は、指定のURLそのままのﾃﾞｨﾚｸﾄﾘに、そうでない場合は、 ｼｽﾃﾑﾊﾟﾗﾒｰﾀ の FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、作成されます。 fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、 さらに、各個人ID別のﾌｫﾙﾀﾞを作成して、そこにｾｰﾌﾞします。

    • setBaseURL

      public void setBaseURL(String url)
      【TAG】ﾌｧｲﾙ保存先ﾃﾞｨﾚｸﾄﾘ名を指定します(初期値:ｺﾝﾃｷｽﾄﾊﾟｽ)。
      パラメータ:
      url - 保存先ﾃﾞｨﾚｸﾄﾘ名
      変更履歴:
      7.2.7.0 (2020/08/07) ｺﾝﾃｷｽﾄﾊﾟｽを基準ﾊﾟｽとするfileURLの設定
      説明:
      この属性で指定されるﾃﾞｨﾚｸﾄﾘに、ﾌｧｲﾙをｾｰﾌﾞします。 絶対ﾊﾟｽに関しては、fileURL の指定と同じですが、相対ﾊﾟｽで指定する場合は、 基準ﾊﾟｽが、ｺﾝﾃｷｽﾄﾊﾟｽ になります。 この属性は特殊で、互換性のために持っています。 fileUpdate や、fileDownload ｻｰﾌﾞﾚｯﾄなどの基準ﾊﾟｽが、ｺﾝﾃｷｽﾄﾊﾟｽなので、これらの ﾀｸﾞと組み合わせて使用する場合に、使用します。

    • setFilename

      public void setFilename(String filename)
      【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします (初期値:FILE_FILENAME[=])。
      パラメータ:
      filename - ﾌｧｲﾙ名
      関連項目:
      説明:
      ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします。 (初期値:ｼｽﾃﾑ定数のFILE_ENCODE[=])。

    • setSheetName

      public void setSheetName(String sheet)
      【TAG】EXCELﾌｧｲﾙを書き出すときのｼｰﾄ名を設定します(初期値:Sheet1)。
      パラメータ:
      sheet - ｼｰﾄ名
      変更履歴:
      3.5.4.2 (2003/12/15) 新規追加
      説明:
      EXCELﾌｧｲﾙを書き出す時に、ｼｰﾄ名を指定します。これにより、複数の形式の 異なるﾃﾞｰﾀを順次書き出したり(appendﾓｰﾄﾞを併用)することや、ｼｰﾄを指定して 新規にEXCELを作成することが可能になります。 初期値は、Sheet1 です。

    • setEncode

      public void setEncode(String enc)
      【TAG】ﾌｧｲﾙを作成するときのﾌｧｲﾙｴﾝｺｰﾃﾞｨﾝｸﾞ名をｾｯﾄします (初期値:FILE_ENCODE[=])。
      パラメータ:
      enc - ｴﾝｺｰﾃﾞｨﾝｸﾞ名 (例:DEFAULT,JISAutoDetect,JIS,EUC_JP,MS932,SJIS,Windows-31J,Shift_JIS)
      関連項目:
      変更履歴:
      2.2.0.0 (2002/12/17) 中国語(国際化)対応 ｴﾝｺｰﾄﾞの取得方法変更, 3.1.3.0 (2003/04/10) FILE_ENCODE から、ｴﾝｺｰﾄﾞ情報を取得する。
      説明:
      "DEFAULT","JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS" (初期値:ｼｽﾃﾑ定数のFILE_ENCODE[=])。

    • setWriterClass

      public void setWriterClass(String writerClass)
      【TAG】実際に書き出すｸﾗｽ名の略称()を指定します (初期値:TABLE_WRITER_DEFAULT_CLASS[=])。
      パラメータ:
      writerClass - ｸﾗｽ名(の略称)
      関連項目:
      説明:
      実際に書き出すｸﾗｽ名(の略称)をｾｯﾄします。 org.opengion.hayabusa.io.TableWriter ｲﾝﾀｰﾌｪｰｽを継承したｻﾌﾞｸﾗｽです。 これは、org.opengion.plugin.io 以下の TableWriter_**** ｸﾗｽの **** を与えます。 属性ｸﾗｽ定義の TableWriter を参照願います。 ExcelRenderer と、Renderer は、特別な名前で、useRenderer 属性に、"true" をｾｯﾄするのと同じ効果があります。 実際は、ExcelRenderer ⇒ Excel、Renderer ⇒ Default のｸﾗｽが呼ばれます。 (初期値:TABLE_WRITER_DEFAULT_CLASS[=])。

    • setFileAppend

      public void setFileAppend(String flag)
      【TAG】追加ﾓｰﾄﾞで書き込むかどうか[true/false]を指定します(初期値:false[新規ﾓｰﾄﾞ])。
      パラメータ:
      flag - 追加ﾓｰﾄﾞか [true:追加ﾓｰﾄﾞ/それ以外:新規ﾓｰﾄﾞ]
      説明:
      DBTableModelのﾌｧｲﾙを、追加ﾓｰﾄﾞで書き込むかどうかをｾｯﾄします。

    • setZip

      public void setZip(String flag)
      【TAG】結果をﾌｧｲﾙに出力するときに、ZIPで圧縮するかどうか[true/false]を指定します(初期値:false)。
      パラメータ:
      flag - ZIPで圧縮する [true:圧縮する/それ以外:しない]
      説明:
      初期値は、圧縮しないです。

    • setZipFilename

      public void setZipFilename(String zipFile)
      【TAG】ZIPﾌｧｲﾙを作成するときのZIPﾌｧｲﾙ名をｾｯﾄします(初期値:filename + ".zip")。
      パラメータ:
      zipFile - ZIPﾌｧｲﾙ名
      関連項目:
      変更履歴:
      6.0.4.0 (2014/11/28) Zipﾌｧｲﾙ名を外部から与えられるように修正
      説明:
      zip 属性に、true を指定した場合に、ZIPﾌｧｲﾙ化します。その場合のﾌｧｲﾙ名を指定します。 なにも指定しない場合は、filename + ".zip" になります。

    • setRefFileURL

      public void setRefFileURL(String url)
      【TAG】EXCEL雛型参照ﾌｧｲﾙのﾃﾞｨﾚｸﾄﾘ名をｾｯﾄします (初期値:FILE_URL[=])。
      パラメータ:
      url - 雛型ﾃﾞｨﾚｸﾄﾘ名
      変更履歴:
      3.5.4.3 (2004/01/05) 新規作成, 4.0.0.0 (2005/01/31) StringUtil.urlAppend ﾒｿｯﾄﾞの利用, 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。, 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
      説明:
      この属性で指定されるﾃﾞｨﾚｸﾄﾘに、ﾌｧｲﾙをｾｰﾌﾞします。 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、２文字目が、 ":" (Windows)の場合は、指定のURLそのままのﾃﾞｨﾚｸﾄﾘに、そうでない場合は、 ｼｽﾃﾑﾊﾟﾗﾒｰﾀ の FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、作成されます。 fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、 さらに、各個人ID別のﾌｫﾙﾀﾞを作成して、そこにｾｰﾌﾞします。

    • setRefFilename

      public void setRefFilename(String filename)
      【TAG】EXCEL雛型参考ﾌｧｲﾙ名をｾｯﾄします。
      パラメータ:
      filename - 雛型ﾌｧｲﾙ名
      変更履歴:
      3.5.4.3 (2004/01/05) 新規作成
      説明:
      内部処理的には、雛形ﾌｧｲﾙの雛形ｼｰﾄをﾒﾓﾘ上に構築し、 そのｼｰﾄのｾﾙに、ﾃﾞｰﾀを追加していきます。 最後には、雛形ｼｰﾄとして存在しない部分は、すべて削除します。 雛形ｼｰﾄを使わない場合は、新規ｼｰﾄに追加していくことになります。 appendﾓｰﾄﾞの場合は、ｵﾘｼﾞﾅﾙが雛形ﾌｧｲﾙになります。 雛形ﾌｧｲﾙの指定は、無効になります。 ※ 互換性の為、同じ名前の設定は有効です。

    • setRefSheetName

      public void setRefSheetName(String sheet)
      【TAG】EXCEL雛型参考ﾌｧｲﾙのｼｰﾄ名を設定します。
      パラメータ:
      sheet - 雛型ｼｰﾄ名
      変更履歴:
      3.5.4.3 (2004/01/05) 新規追加
      説明:
      EXCELﾌｧｲﾙを書き出す時に、雛型として参照するｼｰﾄ名を指定します。 これにより、複数の形式の異なるﾃﾞｰﾀを順次書き出したり(appendﾓｰﾄﾞを併用)する ことや、ｼｰﾄを指定して新規にEXCELを作成する場合にﾌｫｰﾑを設定する事が可能になります。 初期値は、null(第一ｼｰﾄ) です。

    • setSheetOverwrite

      public void setSheetOverwrite(String flag)
      【TAG】雛形のｼｰﾄ名を、そのまま使用する(true)か、新規、または、外部指定のｼｰﾄ名を使用する(false)を指定します。(初期値:false[外部指定のｼｰﾄ名を使用])。
      パラメータ:
      flag - 元のｼｰﾄ名を使用するかどうか [true:使用する/false:新規、または、外部指定のｼｰﾄ名を使用]
      変更履歴:
      6.5.0.0 (2016/09/30) sheetOverwrite で、雛形ｼｰﾄの使用時に、元のｼｰﾄ名を使用します。
      説明:
      ※ Ver5では、追記ﾓｰﾄﾞ時に、指定ｼｰﾄが存在した場合は上書きします(初期値:false[上書きしない])。5.9.12.1 (2016/09/09) Ver6では、追記ﾓｰﾄﾞ時に、雛形を指定できないため、雛形のｼｰﾄ名を、そのまま使用する(true)か、 新規、または、外部指定のｼｰﾄ名を使用する(false)を指定する属性になります。

    • setRecalcSheetName

      public void setRecalcSheetName(String sheet)
      【TAG】EXCELで、出力処理の最後に、ｾﾙ内の計算式を再計算させるｼｰﾄ名をCSV形式で指定します。
      パラメータ:
      sheet - 対象ｼｰﾄ名(CSV形式文字)
      変更履歴:
      6.5.0.0 (2016/09/30) recalcSheetName で、ｾﾙ内の計算式を再計算させるｼｰﾄ名を指定。5.9.12.1 (2016/09/09)
      説明:
      通常は利用する必要はありません。 一覧結果を利用した集計用ｼｰﾄを別に持っているような雛形を利用した出力で利用します。

    • setFontName

      public void setFontName(String name)
      【TAG】EXCEL出力時のﾃﾞﾌｫﾙﾄﾌｫﾝﾄ名を設定します (初期値:TABLE_WRITER_DEFAULT_FONT_NAME[=])。
      パラメータ:
      name - ﾃﾞﾌｫﾙﾄﾌｫﾝﾄ名
      関連項目:
      変更履歴:
      3.8.5.3 (2006/08/07) 新規追加
      説明:
      これは、EXCEL追加機能として実装されています。 EXCELﾌｧｲﾙを書き出す時に、ﾃﾞﾌｫﾙﾄﾌｫﾝﾄ名を指定します。 ﾌｫﾝﾄ名は、EXCELのﾌｫﾝﾄ名をそのまま使用してください。 内部的に、POI の org.apache.poi.hssf.usermodel.HSSFFont#setFontName( String ) に設定されます。 (初期値:ｼｽﾃﾑ定数のTABLE_WRITER_DEFAULT_FONT_NAME[=])。

    • setFontPoint

      public void setFontPoint(String point)
      【TAG】EXCEL出力時のﾃﾞﾌｫﾙﾄﾌｫﾝﾄﾎﾟｲﾝﾄ数を設定します (初期値:TABLE_WRITER_DEFAULT_FONT_POINTS[=])。
      パラメータ:
      point - ﾌｫﾝﾄﾎﾟｲﾝﾄ数
      関連項目:
      変更履歴:
      3.8.5.3 (2006/08/07) 新規追加
      説明:
      これは、EXCEL追加機能として実装されています。 EXCELﾌｧｲﾙを書き出す時に、ﾃﾞﾌｫﾙﾄﾎﾟｲﾝﾄ数を指定します。 内部的に、POI の org.apache.poi.hssf.usermodel.HSSFFont#setFontHeightInPoints( short ) に設定されます。 (初期値:ｼｽﾃﾑ定数のTABLE_WRITER_DEFAULT_FONT_POINTS[=])。

    • setUseNumber

      public void setUseNumber(String useNo)
      【TAG】ﾌｧｲﾙ出力時に、行番号情報を、出力する/しない[true/false]を指定します(初期値:true)。
      パラメータ:
      useNo - 行番号情報 [true:出力する/false:しない]
      変更履歴:
      3.7.0.2 (2005/02/14) 新規追加
      説明:
      通常のﾌｫｰﾏｯﾄでは、各行の先頭に行番号を出力します。 これは、#NAME 属性を使用する場合には、必ず出力する必要があります。 (#NAME 属性は、読み取り時にあれば、自動的にｶﾗﾑに割り当てられます。) この、先頭の行番号が不要な場合(つまり、他のｼｽﾃﾑへのﾃﾞｰﾀ出力等) の為に出力する場合に、false を設定することで、行番号列を出力しない ようにできます。 初期値は、true(出力する) です。

    • setColumns

      public void setColumns(String clms)
      【TAG】書き込み先ﾌｧｲﾙのｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します。
      パラメータ:
      clms - 書込ｶﾗﾑ列 (CSV形式)
      変更履歴:
      4.0.0.0 (2005/12/31) 新規作成
      説明:
      この指定により、書き込むｶﾗﾑを限定的に使用することが可能です。 ｶﾗﾑ名は、検索したDBTableModel上に含まれる名前で指定する必要があります。 別名で書き込みたい場合は、予めその名前で検索しておく必要があります。 ｶﾗﾑ名を指定しない場合(例えば ,,, など)は、ｶﾗﾑを書き飛ばします。

    • setOmitNames

      public void setOmitNames(String clms)
      【TAG】書き込み対象外のｶﾗﾑ列を、外部(ﾀｸﾞ)よりCSV形式で指定します。
      パラメータ:
      clms - 書込対象外ｶﾗﾑ列 (CSV形式)
      変更履歴:
      6.1.0.0 (2014/12/26) omitNames 属性を追加
      説明:
      指定するｶﾗﾑ名に対して、書き込み処理を行いません。 ここで指定するｶﾗﾑ名は、検索したDBTableModel上に含まれる必要はありません。 その場合は、ここでの指定は無視されます。

    • setUseRenderer

      public void setUseRenderer(String flag)
      【TAG】書込処理でｺｰﾄﾞﾘｿｰｽのﾗﾍﾞﾙ変換を行うかどうかを指定します (初期値:USE_TABLE_WRITER_RENDERER[=])。
      パラメータ:
      flag - ﾗﾍﾞﾙ変換可否 [true:する/false:しない]
      関連項目:
      変更履歴:
      5.2.1.0 (2010/10/01) 新規作成
      説明:
      ｺｰﾄﾞﾘｿｰｽをそのままの値で出力すると、数字や記号になり何が書かれているのか 不明になります。 これは、ｺｰﾄﾞﾘｿｰｽをﾗﾍﾞﾙに変換して出力するかどうかを指定します。 当然、ｺｰﾄﾞはﾕﾆｰｸですが、ﾗﾍﾞﾙはﾕﾆｰｸになるかどうか保障はされていませんので TableReader 系で読み込む場合には、ﾘｽｸが発生します。 また、TableReader 系で読み込む場合にも、ﾗﾍﾞﾙからｺｰﾄﾞを求める逆変換を行うように、 setUseRenderer ﾒｿｯﾄﾞで指定する必要があります。 従来は、TableWriter 系に、TableWriter_Renderer 系のｸﾗｽを作って対応していましたが、 このﾒｿｯﾄﾞの属性値のﾌﾗｸﾞで、制御します。 (初期値:ｼｽﾃﾑ定数のUSE_TABLE_WRITER_RENDERER[=])。

    • setSkipRowCount

      public void setSkipRowCount(String count)
      【TAG】(通常は使いません)EXCEL出力時のﾃﾞｰﾀの書き込み開始行番号を設定します(初期値:0)。
      パラメータ:
      count - 書き込み開始行番号
      変更履歴:
      5.7.9.0 (2014/08/08) 新規作成
      説明:
      EXCELのﾃﾞｰﾀの書き込みの開始行番号を指定します。 属性名は、行を飛ばす処理ということで、readTable ﾀｸﾞと同じ名称です。 ﾌｧｲﾙの先頭行が、0行としてｶｳﾝﾄしますので、設定値は、読み飛ばす 件数になります。(1と指定すると、1行読み飛ばし、2行目から読み込みます。) 行の読み飛ばしと、ｶﾗﾑの読み飛ばし(columns)、refFileURL、refFilename、 refSheetName とともに使用すれば、ある程度のﾚｲｱｳﾄ設定が可能です。 現時点では、Excel の場合のみ有効です。

    • setUseCellStyle

      public void setUseCellStyle(String useStyle)
      【TAG】EXCEL出力時に、ﾃﾞｰﾀを書き込んだ範囲に罫線を入れるかどうかを指定します(初期値:false)。
      パラメータ:
      useStyle - 罫線追記 [true:する/false:しない]
      関連項目:
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      ﾃﾞｰﾀを書き込んでEXCELを作成しても、ﾉｰﾏﾙのｾﾙに値がｾｯﾄされている だけなので、ある程度加工が必要です。 そこで、ﾃﾞｰﾀのｾｯﾄされたｾﾙに罫線を入れることで、それなりのﾃﾞｰﾀが 出力された感じになります。 この設定と、useAutoCellSize="true" で、ｾﾙの幅を自動調整すれば、見栄えが良くなります。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setUseAutoCellSize

      public void setUseAutoCellSize(String useAutoSize)
      【TAG】EXCEL出力時に、ｾﾙの幅をﾃﾞｰﾀの幅に自動的に合わせるかどうかを指定します(初期値:false)。
      パラメータ:
      useAutoSize - 幅の自動的調整 [true:する/false:しない]
      関連項目:
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      ﾃﾞｰﾀを書き込んでEXCELを作成しても、ﾉｰﾏﾙのｾﾙに値がｾｯﾄされている だけなので、ある程度加工が必要です。 そこで、ﾃﾞｰﾀのｾｯﾄされたｾﾙの幅を自動調整することで、それなりのﾃﾞｰﾀが 出力された感じになります。 この設定と、useCellStyle="true" で、ｾﾙの罫線を自動設定すれば、見栄えが良くなります。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setUseActiveWorkbook

      public void setUseActiveWorkbook(String useActWB)
      【TAG】EXCEL出力時に、ｾﾙの有効範囲を設定するかどうかを指定します(初期値:false)。
      パラメータ:
      useActWB - 有効範囲の設定 [true:する/false:しない]
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      ｾﾙの有効範囲というのは、EXCELでの 空行、空列の存在しない範囲を指します(初期値:false)。 通常、空行でも、ﾃﾞｰﾀとして残っている場合は、EXCELのｾﾙｵﾌﾞｼﾞｪｸﾄは存在します。 ここで、useActiveWorkbook="true" とすると、空行、空列を削除します。 雛形を使用した場合は、ﾃﾞｰﾀより多めに設定した計算などは、この処理で 削除されますので、ﾃﾞｰﾀｻｲｽﾞにﾌｨｯﾄさせることができます。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setPageBreakColumn

      public void setPageBreakColumn(String pbColumn)
      【TAG】EXCEL出力時に、ｼｰﾄ変更するｷｰとなるｶﾗﾑ名を指定します(このｶﾗﾑの値がｼｰﾄ名になります)。
      パラメータ:
      pbColumn - ｼｰﾄ変更ｶﾗﾑ名
      関連項目:
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      EXCEL帳票では、帳票雛形に、PAGE_BRAKE ｷｰを設定しましたが、TableWriterでは、 ﾒﾓﾘ上のｶﾗﾑの値が変更したときに、ｼｰﾄ変更させることができます。 このｶﾗﾑの値がｷｰﾌﾞﾚｲｸすると、新しいｼｰﾄに書き出し始めます。 ｼｰﾄ名は、このｶﾗﾑの値（ｷｰﾌﾞﾚｲｸする値）です。 雛形ﾌｧｲﾙを使用する場合、雛形ｼｰﾄもｷｰﾌﾞﾚｲｸに伴って、＋１されます。 つまり、雛形ｼｰﾄとﾃﾞｰﾀｼｰﾄは同時に変更されます。 ただし、雛形ｼｰﾄは、最後の雛形ｼｰﾄで止まります。 これは、雛形ｼｰﾄにﾍｯﾀﾞｰ雛形とﾎﾞﾃﾞｨ雛形を用意しておき、最初のｷｰﾌﾞﾚｲｸで ﾍｯﾀﾞｰからﾎﾞﾃﾞｨの書き込みにﾁｪﾝｼﾞするｲﾒｰｼﾞで使用できます。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setFileBreakColumn

      public void setFileBreakColumn(String fbColumn)
      【TAG】EXCEL出力時に、ﾌｧｲﾙ名を変更するｷｰとなるｶﾗﾑ名を指定します(このｶﾗﾑの値がﾌｧｲﾙ名になります)。
      パラメータ:
      fbColumn - ﾌｧｲﾙﾌﾞﾚｲｸｶﾗﾑ
      関連項目:
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      EXCEL帳票では、ﾒﾓﾘ上のｶﾗﾑの値が変更したときに、ﾌｧｲﾙ名を変更することができます。 このｶﾗﾑの値がｷｰﾌﾞﾚｲｸすると、新しいﾌｧｲﾙに書き出し始めます。 ﾌｧｲﾙ名は、このｶﾗﾑの値（ｷｰﾌﾞﾚｲｸする値）＋ 元の出力ﾌｧｲﾙ名の拡張子(.xlsなど)です。 この設定を使用する場合は、出力ﾌｧｲﾙ名は無視されますが、拡張子だけは使用されます。 雛形ﾌｧｲﾙを使用する場合、雛形ﾌｧｲﾙもｷｰﾌﾞﾚｲｸに伴って、再利用されます。 例えば、pageBreakColumn と併用する場合、ｷｰﾌﾞﾚｲｸで雛形ｼｰﾄも最初から適用になります。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setHyperLinkColumn

      public void setHyperLinkColumn(String hlColumn)
      【TAG】EXCEL出力時に、Hyperlinkを作成するｷｰとなる｢ｶﾗﾑ名:値｣形式のｶﾗﾑ名を指定します。
      パラメータ:
      hlColumn - ﾘﾝｸ作成ｶﾗﾑ名 (｢ｶﾗﾑ名:値｣形式)
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      ここで、作成するﾊｲﾊﾟｰﾘﾝｸは、EXCELのｼｰﾄに対するﾊｲﾊﾟｰﾘﾝｸです。 それ以外のﾘﾝｸ(本当のURLやﾌｧｲﾙ等)のﾘﾝｸは(今は)作成できません。 ﾊｲﾊﾟｰﾘﾝｸを作成するには、①作成するｶﾗﾑ と ②作成する値 が必要です。 このﾒｿｯﾄﾞで設定するのは、｢①:②｣という形式でｶﾗﾑ名を指定します。 ②がなければ、①と同じとします。 ②の値のｼｰﾄの存在有無は、無視します。ﾊｲﾊﾟｰﾘﾝｸを作成するｼｰﾄを作成する前に ﾊｲﾊﾟｰﾘﾝｸを作成するｹｰｽが存在します。 (例えば、各ｼｰﾄへのﾘﾝｸを持った一覧を作成してから、明細の各ｼｰﾄを作成する様なｹｰｽ) なお、この機能は、TableWriter_Excel のみに実装します。

    • setAddTitleSheet

      public void setAddTitleSheet(String sheetName)
      【TAG】EXCEL出力時に、Sheet一覧を作成する場合のSheet名を指定します。
      パラメータ:
      sheetName - ﾀｲﾄﾙｼｰﾄ名
      変更履歴:
      6.0.2.0 (2014/09/19) 新規作成
      説明:
      これは、Workbook に含まれる Sheet 一覧を作成する場合に、利用可能です。 なお、この機能は、TableWriter_Excel のみに実装します。

    • setSelectedAll

      public void setSelectedAll(String flag)
      【TAG】ﾁｪｯｸ行のみを対象にするかを指定します(初期値:true)。
      パラメータ:
      flag - 対象にするか [true:全件/false:対象のみ]
      変更履歴:
      5.5.5.5 (2012/08/24) 新規作成
      説明:
      falseを指定する事で、前画面でﾁｪｯｸした行のみを出力します。 初期値は全ての行を出力(true)です。 出力されるﾌｧｲﾙの行番号は、1から振りなおされます。

    • setUseLocal

      public void setUseLocal(String flag)
      【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても、ｸﾗｳﾄﾞ環境を使用しない場合、trueを指定します(初期値:false)。
      パラメータ:
      flag - ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
      変更履歴:
      8.0.1.0 (2021/10/29) useLocal 属性を追加。
      説明:
      ｸﾗｳﾄﾞ設定は、ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが、 どうしてもﾛｰｶﾙでのみ使いたい場合は、この属性を true に設定します。 標準はfalse:設定どおりとなります。 true/false以外を指定した場合はfalse扱いとします。

    • setBeforeDelete

      public void setBeforeDelete(String flag)
      【TAG】事前にﾌｧｲﾙを削除するかどうかを指定します(初期値:false)。
      パラメータ:
      flag - 事前削除するかどうか [true:削除する/false:削除しない]
      変更履歴:
      5.5.9.1 (2012/12/07) 新規作成
      説明:
      出力元の DBTableModel が、存在しないか、0件の場合、過去に作成したﾌｧｲﾙが そのまま、残っていると、不要なﾄﾗﾌﾞﾙのもととなる為、実行前に削除するか どうかを指定できます。 なお、fileAppend="true"(追加ﾓｰﾄﾞで書き込むを指定)時には、ﾃﾞｰﾀが0件でも 事前削除は行いません。 初期値は互換性のため削除しない(false)です。

    • addParam

      protected void addParam(HybsEntry entry)
      WriteTable ｵﾌﾞｼﾞｪｸﾄに渡すﾊﾟﾗﾒｰﾀｵﾌﾞｼﾞｪｸﾄをｾｯﾄします。 WriteTableParamTag ｸﾗｽよりｾｯﾄされます。
      パラメータ:
      entry - HybsEntryｵﾌﾞｼﾞｪｸﾄ
      変更履歴:
      4.0.0.0 (2005/02/28) 新規追加

    • toString

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