nablarch.common.io

クラス FileRecordWriterHolder

java.lang.Object

nablarch.common.io.FileRecordWriterHolder

@Published(tag="architect")
public class FileRecordWriterHolder
extends Object

FileRecordWriterのインスタンスをスレッド毎に管理するクラス。

スレッド毎に管理するFileRecordWriterインスタンスの生成及び取得、クローズ機能を持つ。

FileRecordWriterDisposeHandlerをハンドラとして設定する場合、 本クラスがスレッド上で管理するすべてのFileRecordWriterがFileRecordWriterDisposeHandlerにより自動的にクローズされるので、 業務アプリケーションで本クラスの#closeメソッドを呼び出す必要はない。

#close(String, String)及び#close(String)では、ThreadLocal.remove()の呼び出しを行わない。 スレッド上の値を削除するためには、#closeAll()の呼び出しが必要となる。

作成者:

Masato Inoue

関連項目:

FileRecordWriter

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static void	open(String dataFileName, String layoutFileName) FilePathSettingから"output"という論理名で取得したベースパス配下のファイルをオープンする。
static void	open(String dataFileName, String layoutFileName, int bufferSize) FilePathSettingから"output"という論理名で取得したベースパス配下のファイルをオープンする。
static void	open(String dataFileBasePathName, String dataFileName, String layoutFileName) FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。
static void	open(String dataFileBasePathName, String dataFileName, String layoutFileName, int bufferSize) FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。
static void	open(String dataFileBasePathName, String dataFileName, String layoutFileBasePathName, String layoutFileName) FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。
static void	open(String dataFileBasePathName, String dataFileName, String layoutFileBasePathName, String layoutFileName, int bufferSize) FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。
static void	write(Map<?> record, String fileName) FilePathSettingから"output"という論理名で取得したベースパス配下のデータファイルにレコードを出力する。
static void	write(Map<?> record, String basePathName, String fileName) FilePathSettingに設定した論理名(論理ベースパス）配下のデータファイルにレコードを出力する。
static void	write(String recordType, Map<?> record, String fileName) FilePathSettingから"output"という論理名で取得したベースパス配下のデータファイルにレコードを出力する。
static void	write(String recordType, Map<?> record, String basePathName, String fileName) 引数で指定したデータファイルにレコードを出力する。

メソッドの詳細

open

@Published
public static void open(String dataFileName,
                                   String layoutFileName)

FilePathSettingから"output"という論理名で取得したベースパス配下のファイルをオープンする。

このとき、フォーマット定義ファイルもFilePathSettingから"format"という論理名で取得したベースパス配下より読み込む。
また、バッファサイズには、デフォルトの値(8192B)が使用される。

パラメータ:

dataFileName - 書き込むデータファイルのファイル名

layoutFileName - フォーマット定義ファイルのファイル名

open

@Published
public static void open(String dataFileName,
                                   String layoutFileName,
                                   int bufferSize)

FilePathSettingから"output"という論理名で取得したベースパス配下のファイルをオープンする。

このとき、フォーマット定義ファイルもFilePathSettingから"format"という論理名で取得したベースパス配下より読み込む。
また、引数でデータファイルに書き込む際のバッファサイズを指定する。

パラメータ:

dataFileName - 書き込むデータファイルのファイル名

layoutFileName - フォーマット定義ファイルのファイル名

bufferSize - バッファサイズ

open

@Published
public static void open(String dataFileBasePathName,
                                   String dataFileName,
                                   String layoutFileName)

FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。

このとき、フォーマット定義ファイルはFilePathSettingから"format"という論理名で取得したベースパス配下より読み込む。
また、データファイルに書き込む際のバッファサイズはデフォルト値(8192B)が使用される。

パラメータ:

dataFileBasePathName - 書き込むデータファイルのベースパスの論理名

dataFileName - 書き込むデータファイルのファイル名

layoutFileName - フォーマット定義ファイルのファイル名

open

@Published
public static void open(String dataFileBasePathName,
                                   String dataFileName,
                                   String layoutFileName,
                                   int bufferSize)

FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。

このとき、フォーマット定義ファイルはFilePathSettingから"format"という論理名で取得したベースパス配下より読み込む。
また、引数でデータファイルに書き込む際のバッファサイズを指定する。

パラメータ:

dataFileBasePathName - 書き込むデータファイルのベースパスの論理名

dataFileName - 書き込むデータファイルのファイル名

layoutFileName - フォーマット定義ファイルのファイル名

bufferSize - バッファサイズ

open

@Published
public static void open(String dataFileBasePathName,
                                   String dataFileName,
                                   String layoutFileBasePathName,
                                   String layoutFileName)

FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。

このとき、フォーマット定義ファイルはFilePathSettingから"format"という論理名で取得したベースパス配下より読み込む。 また、データファイルに書き込む際のバッファサイズはデフォルト値(8192B)が使用される。

パラメータ:

dataFileBasePathName - 書き込むデータファイルのベースパスの論理名

dataFileName - 書き込むデータファイルのファイル名

layoutFileBasePathName - フォーマット定義ファイルのベースパス論理名

layoutFileName - フォーマット定義ファイルのファイル名

open

@Published
public static void open(String dataFileBasePathName,
                                   String dataFileName,
                                   String layoutFileBasePathName,
                                   String layoutFileName,
                                   int bufferSize)

FilePathSettingに設定した論理名(論理ベースパス）配下のファイルをオープンする。

また、引数でデータファイルに書き込む際のバッファサイズと、FilePathSettingに設定したフォーマット定義ファイルの論理名を指定する。

パラメータ:

dataFileBasePathName - 書き込むデータファイルのベースパスの論理名

dataFileName - 書き込むデータファイルのファイル名

layoutFileBasePathName - フォーマット定義ファイルのベースパスの論理名

layoutFileName - フォーマット定義ファイルのファイル名

bufferSize - バッファサイズ

例外:

IllegalArgumentException - bufferSize以外の引数がnullまたは空の場合

IllegalStateException - カレントスレッド上のFileRecordWriterが既にオープンしている場合

write

@Published
public static void write(Map<?> record,
                                    String fileName)

FilePathSettingから"output"という論理名で取得したベースパス配下のデータファイルにレコードを出力する。

パラメータ:

record - ファイルに出力するレコード

fileName - 書き込むデータファイルのファイル名

write

@Published
public static void write(Map<?> record,
                                    String basePathName,
                                    String fileName)

FilePathSettingに設定した論理名(論理ベースパス）配下のデータファイルにレコードを出力する。

パラメータ:

record - ファイルに出力するレコード

basePathName - 書き込むデータファイルのベースパスの論理名

fileName - 書き込むデータファイルのファイル名

write

@Published
public static void write(String recordType,
                                    Map<?> record,
                                    String fileName)

FilePathSettingから"output"という論理名で取得したベースパス配下のデータファイルにレコードを出力する。

また、引数で出力するレコードのレコードタイプを指定する。

パラメータ:

recordType - 出力するレコードのレコードタイプ

record - ファイルに出力するレコード

fileName - 書き込むデータファイルのファイル名

write

@Published
public static void write(String recordType,
                                    Map<?> record,
                                    String basePathName,
                                    String fileName)

引数で指定したデータファイルにレコードを出力する。

パラメータ:

recordType - 出力するレコードのレコードタイプ

record - ファイルに出力するレコード

basePathName - 書き込むデータファイルのベースパスの論理名

fileName - 書き込むデータファイルのファイル名