nablarch.core.dataformat

クラス StructuredDataRecordFormatterSupport

java.lang.Object

nablarch.core.dataformat.DataRecordFormatterSupport

nablarch.core.dataformat.StructuredDataRecordFormatterSupport

すべての実装されたインタフェース:

java.io.Closeable, java.lang.AutoCloseable, DataRecordFormatter

直系の既知のサブクラス:

JsonDataRecordFormatter, XmlDataRecordFormatter

public abstract class StructuredDataRecordFormatterSupport
extends DataRecordFormatterSupport

フォーマット定義ファイルの内容に従い、構造化データの読み書きを行うクラス。

本クラスはスレッドセーフを考慮した実装にはなっていないので、呼び出し元で同期化の制御を行うこと。

ディレクティブの設定

XMLデータを読み込む際は、以下のディレクティブの設定が必須となる。

• ファイルの文字エンコーディング

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	クラスと説明
static class	StructuredDataRecordFormatterSupport.StructuredDataDirective XMLデータフォーマッタが使用するディレクティブの名前と値の型。

クラスから継承されたネストされたクラス/インタフェース nablarch.core.dataformat.DataRecordFormatterSupport

DataRecordFormatterSupport.Directive

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
StructuredDataRecordFormatterSupport()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	close() 内部的に保持している各種リソースを開放する。
ConvertorSetting	getConvertorSetting() 構造化データのコンバータの設定情報保持クラスを取得する。
protected StructuredDataBuilder	getDataBuilder() 構造化データビルダーを返却する
protected StructuredDataParser	getDataParser() 構造化データパーサーを返却する
boolean	hasNext() 次に読み込む行の有無を判定する。
DataRecordFormatter	initialize() フォーマット定義情報保持クラスの初期化を行う。
DataRecord	readRecord() 入力ストリームから1レコード分のデータを読み込み、データレコードを返却する。
protected void	setConvertorSetting(ConvertorSetting convertorSetting) 構造化データのコンバータの設定情報保持クラスを取得する。
void	setDataBuilder(StructuredDataBuilder dataBuilder) 構造化データビルダーを設定する
void	setDataParser(StructuredDataParser dataParser) 構造化データパーサーを設定する
DataRecordFormatter	setInputStream(java.io.InputStream stream) 入力ストリームを設定する。
DataRecordFormatter	setOutputStream(java.io.OutputStream stream) 出力ストリームを設定する。
void	writeRecord(java.util.Map<java.lang.String,?> record) 出力ストリームに1レコード分の内容を書き込む。
void	writeRecord(java.lang.String recordType, java.util.Map<java.lang.String,?> record) 指定したデータレイアウト（レコードタイプ）で、出力ストリームに1レコード分の内容を書き込む。

クラスから継承されたメソッド nablarch.core.dataformat.DataRecordFormatterSupport

addConvertorToField, addFormatAndRecordNumberTo, createCharacterReplacer, createDirectiveMap, getDefaultEncoding, getDefinition, getFileType, getMimeType, getRecordNumber, getRecordSeparator, incrementRecordNumber, initializeClassifier, initializeDefinition, initializeField, initializeFieldDefinition, newInvalidDataFormatException, setAllowedRecordSeparatorList, setDataTypeProperty, setDefaultReplacementType, setDefinition, setFieldProperty, setRecordNumber, setValueConvertorProperty, validateDirectives, validateDirectivesDataType, validatePosition, validateRecordLength

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

StructuredDataRecordFormatterSupport

public StructuredDataRecordFormatterSupport()

メソッドの詳細

setDataParser

public void setDataParser(StructuredDataParser dataParser)

構造化データパーサーを設定する

パラメータ:

dataParser - 構造化データパーサー

getDataParser

protected StructuredDataParser getDataParser()

構造化データパーサーを返却する

戻り値:

構造化データパーサー

setDataBuilder

public void setDataBuilder(StructuredDataBuilder dataBuilder)

構造化データビルダーを設定する

パラメータ:

dataBuilder - 構造化データビルダー

getDataBuilder

protected StructuredDataBuilder getDataBuilder()

構造化データビルダーを返却する

戻り値:

構造化データビルダー

getConvertorSetting

public ConvertorSetting getConvertorSetting()

構造化データのコンバータの設定情報保持クラスを取得する。

定義:

getConvertorSetting クラス内 DataRecordFormatterSupport

戻り値:

構造化データのコンバータの設定情報保持クラス

setConvertorSetting

protected void setConvertorSetting(ConvertorSetting convertorSetting)

構造化データのコンバータの設定情報保持クラスを取得する。

パラメータ:

convertorSetting - 構造化データのコンバータの設定情報保持クラス

initialize

public DataRecordFormatter initialize()

フォーマット定義情報保持クラスの初期化を行う。 初期化は本メソッドの1回目の実行時のみ行われ、2回目以降の実行時に初期化は行われない。

定義:

initialize インタフェース内 DataRecordFormatter

オーバーライド:

initialize クラス内 DataRecordFormatterSupport

戻り値:

このオブジェクト自体

setInputStream

public DataRecordFormatter setInputStream(java.io.InputStream stream)

入力ストリームを設定する。

パラメータ:

stream - 入力ストリーム

戻り値:

本クラスのインスタンス

setOutputStream

public DataRecordFormatter setOutputStream(java.io.OutputStream stream)

出力ストリームを設定する。

パラメータ:

stream - 出力ストリーム

戻り値:

本クラスのインスタンス

readRecord

public DataRecord readRecord()
                      throws java.io.IOException,
                             InvalidDataFormatException

入力ストリームから1レコード分のデータを読み込み、データレコードを返却する。 入力ストリームが既に終端に達していた場合はnullを返却する。

戻り値:

データレコード

例外:

java.io.IOException - 入力ストリームの読み込みに失敗した場合

InvalidDataFormatException - 読み込んだデータがフォーマット定義に違反している場合

writeRecord

public void writeRecord(java.util.Map<java.lang.String,?> record)
                 throws java.io.IOException,
                        InvalidDataFormatException

出力ストリームに1レコード分の内容を書き込む。

出力時に使用するデータレイアウト（レコードタイプ）は、Mapの内容をもとに自動的に判定される。

引数がDataRecord型かつレコードタイプが指定されている場合、 フォーマット定義ファイルのレコードタイプ識別フィールド定義よりも、指定されたレコードタイプを優先して書き込みを行う。

パラメータ:

record - 出力するレコードの内容を格納したMap

例外:

java.io.IOException - 出力ストリームの書き込みに失敗した場合

InvalidDataFormatException - 書き込むデータの内容がフォーマット定義に違反している場合

writeRecord

public void writeRecord(java.lang.String recordType,
                        java.util.Map<java.lang.String,?> record)
                 throws java.io.IOException

指定したデータレイアウト（レコードタイプ）で、出力ストリームに1レコード分の内容を書き込む。

パラメータ:

recordType - レコードタイプ

record - 出力するレコードの内容を格納したMap

例外:

java.io.IOException - 出力ストリームの書き込みに失敗した場合

close

public void close()

内部的に保持している各種リソースを開放する。 この実装では、setInputStream(java.io.InputStream)メソッドおよびsetOutputStream(java.io.OutputStream)メソッドで渡されたストリームをクローズする。

hasNext

public boolean hasNext()
                throws java.io.IOException

次に読み込む行の有無を判定する。

戻り値:

次に読み込む行がある場合true

例外:

java.io.IOException - 入力ストリームの読み込みに失敗した場合