DataRecordFormatterSupport (Nablarch-API)

java.lang.Object
- nablarch.core.dataformat.DataRecordFormatterSupport

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

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

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

FixedLengthDataRecordFormatter, StructuredDataRecordFormatterSupport, VariableLengthDataRecordFormatter
```
@Published(tag="architect")
public abstract class DataRecordFormatterSupport
extends java.lang.Object
implements DataRecordFormatter
```
フォーマット定義ファイルの内容に従い、ファイルデータの読み書きを行うクラスの抽象基底クラス。
本クラスでは、フォーマット定義情報保持クラス（LayoutDefinition）の初期化および内容の妥当性検証を行い、実際のファイルデータの読み書きはサブクラスにて行う。

本クラスを継承するクラスでは、以下のディレクティブを指定することができる。
- ファイルタイプ
- 文字エンコーディング
- レコード終端文字列（改行コード）
※ディレクティブとは、文字エンコーディングや改行コード、フィールド区切り文字など、ファイルを読み書きする際に"ファイル単位"で定義できる各種設定項目のことを示す。

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

ネストされたクラス
修飾子とタイプ	クラスと説明
`static class`	`DataRecordFormatterSupport.Directive` ファイルフォーマッタが共通的に使用するディレクティブの名前と値の型。

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

コンストラクタ
コンストラクタと説明

DataRecordFormatterSupport()
コンストラクタ。

コンストラクタ
コンストラクタと説明
`DataRecordFormatterSupport()` コンストラクタ。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド abstractメソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`protected void`	`addConvertorToField(FieldDefinition field, RecordDefinition recordDefinition)` フィールドのフォーマット定義を保持するクラスに関連するコンバータを生成し、フィールド定義クラスに設定する。
`protected InvalidDataFormatException`	`addFormatAndRecordNumberTo(InvalidDataFormatException e)` `InvalidDataFormatException`にフォーマットファイルのパスと例外発生時の行番号を設定する。
`protected CharacterReplacer`	`createCharacterReplacer(FieldDefinition field, java.lang.String replacementType)` デフォルトの寄せ字コンバータを生成する。
`protected java.util.Map<java.lang.String,DataRecordFormatterSupport.Directive>`	`createDirectiveMap()` 使用するディレクティブの名前とDirectiveのMapを生成する。
`protected abstract ConvertorSetting`	`getConvertorSetting()` コンバータの設定情報を取得する。
`java.nio.charset.Charset`	`getDefaultEncoding()` デフォルトの文字エンコーディングを取得する。
`protected LayoutDefinition`	`getDefinition()` フォーマット定義ファイルの情報を保持するクラスを取得する。
`java.lang.String`	`getFileType()` このフォーマッタが取り扱うファイル種別を返却する。
`java.lang.String`	`getMimeType()` このフォーマッタが取り扱うファイルのmime-typeを返却する。
`int`	`getRecordNumber()` 読み込みまたは書き込み中のレコードのレコード番号を取得する。
`protected java.lang.String`	`getRecordSeparator()` レコード終端文字列を取得する。
`protected void`	`incrementRecordNumber()` 読み込みまたは書き込み中のレコードのレコード番号をインクリメントする。
`DataRecordFormatter`	`initialize()` フォーマット定義情報保持クラスの初期化を行う。
`protected void`	`initializeClassifier()` レコード識別情報が存在する場合（マルチレイアウトファイルの場合）、レコード識別情報に関連するフィールド定義クラスの初期化（コンバータ設定およびエンコーディング設定）を行う。
`protected void`	`initializeDefinition()` フォーマット定義情報保持クラス(`LayoutDefinition`）の初期化および内容の妥当性を検証し、フォーマット定義情報保持クラスから必要な情報を本クラスのプロパティに設定する。
`protected void`	`initializeField(java.util.Map<java.lang.String,java.lang.Object> directive)` フィールドを初期化する。
`protected void`	`initializeFieldDefinition()` フィールド定義クラスについて、以下の初期化処理を行う。
`protected InvalidDataFormatException`	`newInvalidDataFormatException(java.lang.Object... msgElements)` 引数を連結したものをメッセージとして、`InvalidDataFormatException`を生成する。
`DataRecordFormatterSupport`	`setAllowedRecordSeparatorList(java.util.List<java.lang.String> allowedRecordSeparatorList)` 許容するレコード終端文字列のリストを設定する。
`protected DataRecordFormatterSupport`	`setDataTypeProperty(DataType<?,?> dataType)` データタイプの設定を行う。
`DataRecordFormatterSupport`	`setDefaultReplacementType(java.util.Map<java.lang.String,java.lang.String> defaultReplacementType)` データタイプ名に対応するデフォルトの寄せ字変換タイプ名を設定する。
`DataRecordFormatter`	`setDefinition(LayoutDefinition definition)` フォーマット定義ファイルの情報を保持するクラスを設定する。
`protected void`	`setFieldProperty(FieldDefinition field, RecordDefinition recordDef)` フィールド定義情報保持クラスのプロパティを設定する。
`protected void`	`setRecordNumber(int recordNumber)` 読み込みまたは書き込み中のレコードのレコード番号を設定する。
`protected void`	`setValueConvertorProperty(ValueConvertor<?,?> valueConvertor)` コンバータの設定を行う。
`protected void`	`validateDirectives(java.util.Map<java.lang.String,java.lang.Object> directive)` ディレクティブの内容の妥当性を検証する。
`protected void`	`validateDirectivesDataType(java.util.Map<java.lang.String,java.lang.Object> directive)` 定義されたすべてのディレクティブの値のデータ型が正しいことを検証する。
`protected void`	`validatePosition(int head, FieldDefinition field)` 開始位置と、現在位置の妥当性を検証する。
`protected void`	`validateRecordLength(int head, RecordDefinition record)` レコード長の妥当性を検証する。

クラスから継承されたメソッド java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースから継承されたメソッド nablarch.core.dataformat.DataRecordFormatter
close, hasNext, readRecord, setInputStream, setOutputStream, writeRecord, writeRecord

- コンストラクタの詳細
  - DataRecordFormatterSupport
```
public DataRecordFormatterSupport()
```
    コンストラクタ。ディレクティブを初期化する。
- メソッドの詳細
  - createDirectiveMap
```
protected java.util.Map<java.lang.String,DataRecordFormatterSupport.Directive> createDirectiveMap()
```
    使用するディレクティブの名前とDirectiveのMapを生成する。サブクラスで使用するディレクティブを追加する場合は、本メソッドをオーバーライドし、任意のディレクティブを追加すること。
    
    戻り値:
    
    使用するディレクティブの名前と値の型のMap
  - getConvertorSetting
```
protected abstract ConvertorSetting getConvertorSetting()
```
    コンバータの設定情報を取得する。
    
    戻り値:
    
    コンバータの設定情報
  - initialize
```
public DataRecordFormatter initialize()
```
    フォーマット定義情報保持クラスの初期化を行う。初期化は本メソッドの1回目の実行時のみ行われ、2回目以降の実行時に初期化は行われない。
    
    定義:
    
    initialize インタフェース内 DataRecordFormatter
    
    戻り値:
    
    このオブジェクト自体
  - initializeDefinition
```
protected void initializeDefinition()
```
    フォーマット定義情報保持クラス(LayoutDefinition）の初期化および内容の妥当性を検証し、フォーマット定義情報保持クラスから必要な情報を本クラスのプロパティに設定する。フォーマット定義情報保持クラスがすでに初期化されている場合、初期化は行わない。
  - validateDirectives
```
protected void validateDirectives(java.util.Map<java.lang.String,java.lang.Object> directive)
```
    ディレクティブの内容の妥当性を検証する。
    サブクラスで独自のディレクティブを使用する場合は、このメソッドをオーバーライドし、独自のディレクティブに対して妥当性検証を行うこと。
    
    DataRecordFormatterでは以下の仕様を満たしているかどうかの検証を行う。
    - ディレクティブの値のデータ型が正しい
    - ファイルタイプが定義されている
    - エンコーディングが定義されている
    - エンコーディングがCharset型に変換できる
    - レコード終端文字列が許容されている文字である
    妥当性検証に失敗した場合は、SyntaxErrorExceptionがスローされる。
    パラメータ:
    
    directive - ディレクティブ
  - initializeField
```
protected void initializeField(java.util.Map<java.lang.String,java.lang.Object> directive)
```
    フィールドを初期化する。
    DataRecordFormatterSupportでは、ディレクティブに設定された以下の値をフィールドに設定する。
    - レコード終端文字列
    - 文字エンコーディング
    パラメータ:
    
    directive - ディレクティブ
  - validateDirectivesDataType
```
protected void validateDirectivesDataType(java.util.Map<java.lang.String,java.lang.Object> directive)
```
    定義されたすべてのディレクティブの値のデータ型が正しいことを検証する。
    
    パラメータ:
    
    directive - ディレクティブ
  - initializeClassifier
```
protected void initializeClassifier()
```
    レコード識別情報が存在する場合（マルチレイアウトファイルの場合）、レコード識別情報に関連するフィールド定義クラスの初期化（コンバータ設定およびエンコーディング設定）を行う。
    レコード種別識別定義の場合は、フィールド位置の整合性チェックは行わない。
  - initializeFieldDefinition
```
protected void initializeFieldDefinition()
```
    フィールド定義クラスについて、以下の初期化処理を行う。
    - コンバータ設定
    - エンコーディング設定
    - 差分定義が行われている場合は、親のフィールド定義情報を反映
    - レコード長、フィールド長の妥当性検証
  - setFieldProperty
```
protected void setFieldProperty(FieldDefinition field,
                                RecordDefinition recordDef)
```
    フィールド定義情報保持クラスのプロパティを設定する。
    
    パラメータ:
    
    field - フィールド定義情報保持クラス
    
    recordDef - レコード定義情報保持クラス
  - validateRecordLength
```
protected void validateRecordLength(int head,
                                    RecordDefinition record)
```
    レコード長の妥当性を検証する。
    
    パラメータ:
    
    head - 位置
    
    record - レコード定義情報保持クラス
  - validatePosition
```
protected void validatePosition(int head,
                                FieldDefinition field)
```
    開始位置と、現在位置の妥当性を検証する。
    
    パラメータ:
    
    head - 位置
    
    field - フィールド定義情報保持クラス
  - addConvertorToField
```
protected void addConvertorToField(FieldDefinition field,
                                   RecordDefinition recordDefinition)
```
    フィールドのフォーマット定義を保持するクラスに関連するコンバータを生成し、フィールド定義クラスに設定する。コンバータを生成する役割を担うコンバータファクトリは、サブクラスで指定されたコンバータ情報設定クラスをもとに生成する。 getConvertorSetting()
    
    パラメータ:
    
    field - フォーマット定義を保持するクラス
    
    recordDefinition - レコード定義情報保持クラス
  - createCharacterReplacer
```
protected CharacterReplacer createCharacterReplacer(FieldDefinition field,
                                                    java.lang.String replacementType)
```
    デフォルトの寄せ字コンバータを生成する。
    
    パラメータ:
    
    field - フィールド
    
    replacementType - 寄せ字変換タイプ
    
    戻り値:
    
    デフォルトの寄せ字コンバータ
  - setDataTypeProperty
```
protected DataRecordFormatterSupport setDataTypeProperty(DataType<?,?> dataType)
```
    データタイプの設定を行う。ファイルタイプ個別の設定を行う必要がある場合、必要に応じてサブクラスでオーバーライドする。
    
    パラメータ:
    
    dataType - データタイプ
    
    戻り値:
    
    このオブジェクト自体
  - setValueConvertorProperty
```
protected void setValueConvertorProperty(ValueConvertor<?,?> valueConvertor)
```
    コンバータの設定を行う。ファイルタイプ個別の設定を行う必要がある場合、必要に応じてサブクラスでオーバーライドする。
    
    パラメータ:
    
    valueConvertor - コンバータ
  - setDefinition
```
public DataRecordFormatter setDefinition(LayoutDefinition definition)
```
    フォーマット定義ファイルの情報を保持するクラスを設定する。
    
    定義:
    
    setDefinition インタフェース内 DataRecordFormatter
    
    パラメータ:
    
    definition - フォーマット定義ファイルの定義情報
    
    戻り値:
    
    本クラスのインスタンス
  - getDefinition
```
protected LayoutDefinition getDefinition()
```
    フォーマット定義ファイルの情報を保持するクラスを取得する。
    
    戻り値:
    
    フォーマット定義ファイルの情報を保持するクラス
  - setAllowedRecordSeparatorList
```
public DataRecordFormatterSupport setAllowedRecordSeparatorList(java.util.List<java.lang.String> allowedRecordSeparatorList)
```
    許容するレコード終端文字列のリストを設定する。
    
    パラメータ:
    
    allowedRecordSeparatorList - 許容されるレコード終端文字列のリスト
    
    戻り値:
    
    このオブジェクト自体
  - getRecordNumber
```
public int getRecordNumber()
```
    読み込みまたは書き込み中のレコードのレコード番号を取得する。
    
    定義:
    
    getRecordNumber インタフェース内 DataRecordFormatter
    
    戻り値:
    
    recordNumber 読み込みまたは書き込み中のレコードのレコード番号
  - incrementRecordNumber
```
protected void incrementRecordNumber()
```
    読み込みまたは書き込み中のレコードのレコード番号をインクリメントする。
  - setRecordNumber
```
protected void setRecordNumber(int recordNumber)
```
    読み込みまたは書き込み中のレコードのレコード番号を設定する。
    
    パラメータ:
    
    recordNumber - 読み込みまたは書き込み中のレコードのレコード番号
  - getDefaultEncoding
```
public java.nio.charset.Charset getDefaultEncoding()
```
    デフォルトの文字エンコーディングを取得する。
    
    戻り値:
    
    文字エンコーディング
  - getRecordSeparator
```
protected java.lang.String getRecordSeparator()
```
    レコード終端文字列を取得する。
    
    戻り値:
    
    レコード終端文字列
  - setDefaultReplacementType
```
public DataRecordFormatterSupport setDefaultReplacementType(java.util.Map<java.lang.String,java.lang.String> defaultReplacementType)
```
    データタイプ名に対応するデフォルトの寄せ字変換タイプ名を設定する。
    
    パラメータ:
    
    defaultReplacementType - データタイプ名に対応するデフォルトの寄せ字変換タイプ名
    
    戻り値:
    
    このオブジェクト自体
  - newInvalidDataFormatException
```
protected final InvalidDataFormatException newInvalidDataFormatException(java.lang.Object... msgElements)
```
    引数を連結したものをメッセージとして、InvalidDataFormatExceptionを生成する。
    この例外には、フォーマットファイルのパスと例外発生時の行番号が設定される。
    
    パラメータ:
    
    msgElements - メッセージ要素
    
    戻り値:
    
    InvalidDataFormatExceptionインスタンス
  - addFormatAndRecordNumberTo
```
protected final InvalidDataFormatException addFormatAndRecordNumberTo(InvalidDataFormatException e)
```
    InvalidDataFormatExceptionにフォーマットファイルのパスと例外発生時の行番号を設定する。
    
    パラメータ:
    
    e - 設定対象の例外インスタンス
    
    戻り値:
    
    引数で与えられたインスタンス
  - getFileType
```
public java.lang.String getFileType()
```
    このフォーマッタが取り扱うファイル種別を返却する。
    
    戻り値:
    
    ファイル種別
  - getMimeType
```
public java.lang.String getMimeType()
```
    このフォーマッタが取り扱うファイルのmime-typeを返却する。
    デフォルトではtext/plainを返却する。必要に応じサブクラスでオーバーライドすること。
    
    戻り値:
    
    ファイルのmime-type

クラス DataRecordFormatterSupport

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

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

メソッドのサマリー

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

インタフェースから継承されたメソッド nablarch.core.dataformat.DataRecordFormatter

コンストラクタの詳細

DataRecordFormatterSupport

メソッドの詳細

createDirectiveMap

getConvertorSetting

initialize

initializeDefinition

validateDirectives

initializeField

validateDirectivesDataType

initializeClassifier

initializeFieldDefinition

setFieldProperty

validateRecordLength

validatePosition

addConvertorToField

createCharacterReplacer

setDataTypeProperty

setValueConvertorProperty

setDefinition

getDefinition

setAllowedRecordSeparatorList

getRecordNumber

incrementRecordNumber

setRecordNumber

getDefaultEncoding

getRecordSeparator

setDefaultReplacementType

newInvalidDataFormatException

addFormatAndRecordNumberTo

getFileType

getMimeType