nablarch.core.dataformat

クラス CharacterReplacementManager

java.lang.Object

nablarch.core.dataformat.CharacterReplacementManager

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

Initializable

public class CharacterReplacementManager
extends java.lang.Object
implements Initializable

寄せ字変換処理を行うクラス。

本クラスは、文字列中のある特定の文字を等価な代替文字に変換する用途での使用を想定している。
想定する変換の例：　髙→高　碕→崎
このような文字列変換処理のことを、寄せ時変換処理と呼ぶ。

禁則文字を一括で豆腐（■）に変換するような処理は、本クラスでは想定していないので、
文字を検知した場合に、ワーニングログを出力する機能や、呼び出し元に検知したことを通知する機能は提供しない。
想定しない変換の例：　唖→■ \→[

寄せ字変換処理は、寄せ字タイプごとに定義された寄せ字変換定義ファイルの情報をもとに行う。
寄せ字変換定義ファイルは初期化時に読み込み、メモリ上にキャッシュする。

本クラスは、文字列中の特定の1文字を、特定の1文字に変換することしかサポートしない（サロゲートペアの変換もサポートしない）。
よって、寄せ字変換定義ファイルに、「ﾍ゜」のような半角2文字で1文字を表現する合字などの複数の文字や、サロゲートペアが定義された場合は、例外をスローする。

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

コンストラクタ

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

メソッドのサマリー

修飾子とタイプ	メソッドと説明
protected void	checkByteLength(java.lang.String fromStr, java.lang.String toStr, CharacterReplacementConfig config) 変換前文字列と変換後文字列のバイト長チェックを行う。
protected void	checkProperty(java.lang.String name, java.lang.String value, CharacterReplacementConfig config) 設定されたプロパティの妥当性をチェックする。
protected void	checkReplacementCharacterLength(java.lang.String fromStr, java.lang.String toStr, CharacterReplacementConfig config) 寄せ字変換定義ファイルに設定された変換前文字列と変換後文字列の文字列長が「1」であることを確認する。
boolean	checkReplacementTypeEncoding(java.lang.String typeName, java.nio.charset.Charset encoding) 引数で指定された寄せ字タイプ名と文字エンコーディングの組み合わせが、定義された組み合わせと一致するかどうかをチェックする。
boolean	containsReplacementType(java.lang.String typeName) 引数で指定された寄せ字タイプ名が、寄せ字タイプ名として定義されているかどうかチェックする。
protected nablarch.core.dataformat.CharacterReplacementManager.CharacterReplacementDefinition	createReplacementTable(CharacterReplacementConfig config) 寄せ字変換定義ファイルを読み込み、寄せ字変換テーブルを生成する。
protected void	createReplacementTables() 寄せ字変換定義ファイルを読み込み、寄せ字変換テーブルを生成する。
static CharacterReplacementManager	getInstance() FormatterFactoryクラスのインスタンスをリポジトリより取得する。
void	initialize() 初期化処理を行う。
protected java.util.Properties	loadPropertyFile(java.lang.String filePath) 寄せ字変換定義ファイルをロードする。
protected void	outputLog(java.lang.String typeName, char from, char to, java.lang.String input) 文字を変換した際のログを出力する。
java.lang.String	replaceCharacter(java.lang.String typeName, java.lang.String input) 引数で渡された文字列に対して、寄せ字変換処理を行う。
CharacterReplacementManager	setConfigList(java.util.List<CharacterReplacementConfig> configList) 寄せ字変換処理の設定を保持するListを設定する。
protected void	setEncodingToTable(CharacterReplacementConfig config, nablarch.core.dataformat.CharacterReplacementManager.CharacterReplacementDefinition definition) 寄せ字変換テーブルに、文字エンコーディングを設定する。

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

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

コンストラクタの詳細

CharacterReplacementManager

public CharacterReplacementManager()

メソッドの詳細

getInstance

public static CharacterReplacementManager getInstance()

FormatterFactoryクラスのインスタンスをリポジトリより取得する。 リポジトリより取得できなかった場合は、デフォルトで本クラスのインスタンスを返却する。

戻り値:

CharacterReplacementManagerのインスタンス

initialize

public void initialize()

初期化処理を行う。

定義:

initialize インタフェース内 Initializable

createReplacementTables

protected void createReplacementTables()

寄せ字変換定義ファイルを読み込み、寄せ字変換テーブルを生成する。

寄せ字変換定義ファイルに定義された変換前および変換後の文字列が1文字でない（Stringのlengthが1でない）場合は、 例外をスローする。

変換前と変換後の文字のバイト長一致チェックが有効な場合、 寄せ字変換定義ファイルに定義された変換前および変換後の文字列を指定されたエンコーディングに従いバイト配列に変換し、 変換前と変換後のバイト長が一致しない場合は、例外をスローする。

createReplacementTable

protected nablarch.core.dataformat.CharacterReplacementManager.CharacterReplacementDefinition createReplacementTable(CharacterReplacementConfig config)

寄せ字変換定義ファイルを読み込み、寄せ字変換テーブルを生成する。

パラメータ:

config - 寄せ字変換処理の設定を保持するクラス

戻り値:

寄せ字変換テーブルを保持するクラス

setEncodingToTable

protected void setEncodingToTable(CharacterReplacementConfig config,
                                  nablarch.core.dataformat.CharacterReplacementManager.CharacterReplacementDefinition definition)

寄せ字変換テーブルに、文字エンコーディングを設定する。

パラメータ:

config - 寄せ字変換処理の設定を保持するクラス

definition - 寄せ字変換テーブルを保持するクラス

loadPropertyFile

protected java.util.Properties loadPropertyFile(java.lang.String filePath)

寄せ字変換定義ファイルをロードする。

パラメータ:

filePath - 寄せ字変換定義ファイルのパス

戻り値:

寄せ字変換定義ファイルをロードしたPropertiesクラス

checkReplacementCharacterLength

protected void checkReplacementCharacterLength(java.lang.String fromStr,
                                               java.lang.String toStr,
                                               CharacterReplacementConfig config)

寄せ字変換定義ファイルに設定された変換前文字列と変換後文字列の文字列長が「1」であることを確認する。

パラメータ:

fromStr - 寄せ字変換前の文字列

toStr - 寄せ字変換後の文字列

config - 寄せ字変換処理の設定を保持するクラス

checkByteLength

protected void checkByteLength(java.lang.String fromStr,
                               java.lang.String toStr,
                               CharacterReplacementConfig config)

変換前文字列と変換後文字列のバイト長チェックを行う。 バイト長チェックは、文字エンコーディングに従い行う。

パラメータ:

fromStr - 変換前文字列

toStr - 変換後文字列

config - 寄せ字変換処理の設定を保持するクラス

checkProperty

protected void checkProperty(java.lang.String name,
                             java.lang.String value,
                             CharacterReplacementConfig config)
                      throws java.lang.IllegalStateException

設定されたプロパティの妥当性をチェックする。

パラメータ:

name - プロパティ名

value - プロパティの値

config - 寄せ字変換処理の設定を保持するクラス

例外:

java.lang.IllegalStateException - プロパティが設定されていない場合

replaceCharacter

public java.lang.String replaceCharacter(java.lang.String typeName,
                                         java.lang.String input)

引数で渡された文字列に対して、寄せ字変換処理を行う。

パラメータ:

typeName - 寄せ字タイプ名

input - 入力文字列

戻り値:

寄せ字変換処理後の文字列

outputLog

protected void outputLog(java.lang.String typeName,
                         char from,
                         char to,
                         java.lang.String input)

文字を変換した際のログを出力する。

パラメータ:

typeName - 寄せ字変換タイプ名

from - 寄せ字変換前の文字

to - 寄せ字変換後の文字

input - 入力文字列

setConfigList

public CharacterReplacementManager setConfigList(java.util.List<CharacterReplacementConfig> configList)

寄せ字変換処理の設定を保持するListを設定する。

パラメータ:

configList - 寄せ字変換処理の設定を保持するList

戻り値:

このオブジェクト自体

containsReplacementType

public boolean containsReplacementType(java.lang.String typeName)

引数で指定された寄せ字タイプ名が、寄せ字タイプ名として定義されているかどうかチェックする。

パラメータ:

typeName - 寄せ字タイプ名

戻り値:

引数で指定された寄せ字タイプ名が定義されている場合、true

checkReplacementTypeEncoding

public boolean checkReplacementTypeEncoding(java.lang.String typeName,
                                            java.nio.charset.Charset encoding)

引数で指定された寄せ字タイプ名と文字エンコーディングの組み合わせが、定義された組み合わせと一致するかどうかをチェックする。

寄せ字タイプ名と、文字エンコーディングの組み合わせは、通常コンポーネント設定ファイルで定義される。

パラメータ:

typeName - 寄せ字タイプ名

encoding - 文字エンコーディング

戻り値:

寄せ字タイプ名が