14. XLSBeansとの違い¶

XlsMapperは、XLSBeans ver.1.1 のソースを元に開発を行っています。

そのため、仕様、特にアノテーションの使い方はXLSBeansと共通しています。 XLSBeansとの違いを以下に示します。

14.1. 改善機能¶

アノテーションの名称を @Xls～ （例. @Column => @XlsColumn ）として、他のライブラリのアノテーションと区別がつきやすいようにしています。
アノテーション @XlsCell などセルの座標を指定する際に、Excel形式 A3 のように指定する属性address を追加し、指定しやすいようにしています。
エラーメッセージの内容を詳細に表示し、設定間違いの対応をしやすくしています。
Generics対応として、@XlsMapColums、@XlsIterateTables にも対応しており、マッピング先のClassを指定する必要がありません。
シートの座標位置の取得が、@XlsMapColumn を付与したフィールドにも対応しています。
- フィールド Map<String, String> positions を定義しておけば、キーに見出し名が入ります。
アノテーションを付与するフィールドの修飾子として、public以外のprivate/protectedにも対応しています。

書き込み機能があります。
- アノテーション @XlsHorizontalRecords 、 @XlsVerticalRecords に書き込み用の属性を追加し、行が余ったときや足りないときの動作をカスタマイズできます。
読み込み時、書き込み時のコールバック用メソッドを定義するためのアノテーション @XlsPreLoad/@XlsPostLoad/@XlsPreSave/@XlsPostLoad が使用できます。
型変換機能として、 @XlsConverter などの型変換用アノテーションを利用して各フィールドごとに細かく設定できます。
読み込んだシートの内容をチェックする Validation機能があります。
- 独自にValidatorを実装する方式の他、Bean Validation 1.0/1.1に対応しています。
セルの座標位置のように、マッピング対象の見出し名を取得するこができます。

コードをシンプルにするため、JExcelAPI対応を排除し、Apache POIのみに対応しています。
- XlsMapperのプログラム中で利用する機能でJExcelAPIに優位であったユーザ定義などの書式対応は、外部ライブラリ excel-cellformatter を利用することでJExcelAPIとApache POIの差をなくしています。
アノテーション @PostProcessor を削除しました。
- 代わりに、@XlsPreLoad/@XlsPostLoad/@XlsPreSave/@XlsPostLoad が使用できます。
独自実装のProcessorを、プロパティファイル xlsbeans.properties で設定できる機能を削除しました。
- 代わりに、システム設定用の Configuration#getConverterRegistry()#registerProcessor(...) から登録できます。