ExcelとPOJOマッピングライブラリプロジェクト

ExcelとPOJOマッピングライブラリへようこそ。

ExcelとPlain Old Java Object(POJO) をマッピングするためのライブラリ作成プロジェクトです。
Jakarta POIやJava Excel APIなどを使用して実現した場合の煩雑なコーディングを避けるため、
XMLの定義あるいはアノテーションにより、データのセルや表の見出し情報を指定した読み込み/書込みをを実現します。
Excel→POJO、POJO→Excel、共に同じ定義を用いて実行できます。

わざわざ作る背景

Excel→POJO、POJO→Excelのどちらか一方であれば、世の中に優秀なアプリが存在します。
特にExcel → POJOは「XLSBeans」が優れており、特に参考にさせてもらいました。(ソースは再利用していません)
まことに勝手ながらここで感謝の意を表したいと思います。
読み込みと書込みを1つの設定で実現したいため、プロジェクトを立ち上げました。

機能概要

  • Excelを読み込みPOJOに値を詰めて返す、また逆にPOJOからExcelへの書き出しを行う。
  • 1つのマッピング定義で読み込み・書き込みが可能
  • XMLによるマッピングの定義が可能
  • アノテーションによるマッピングの定義が可能
  • セル位置の特定に、文字列の検索と位置情報の指定が可能
  • 縦・横両方向の表へのマッピングが可能
  • (予定)定義に従って読み込んだPOJOを作成・保持する代わりに、任意のメソッドへ引き渡して繰り返し実行させることが可能

実現方法・PG設計方針

XMLまたはアノテーションを読み込むパーサーを用意
パーサが読み込んだ設定からExcelのセルを特定し、
設定で指定されているPOJOを作成して setter を呼び出す。

逆変換はPOJOの getter を呼び出して値を取得して、
設定で指定されているセルに書き出す。

ExcelとPOJOマッピングライブラリの使い方

ExcelとPOJOマッピングライブラリの使い方をご参照ください。

XMLマッピング仕様

XMLマッピング仕様をご参照ください。

アノテーションマッピング仕様

アノテーションマッピング仕様をご参照ください。


依存関係

下記モジュールを使用しています。 開発・実行時にクラスパスに追加してください。

依存するモジュール確認しているバージョン
使用するモジュール
ライセンス
spring2.5
spring.jar
Apache License Version 2.0
POI3.6
dom4j-1.6.1.jar
geronimo-stax-api_1.0_spec-1.0.jar
poi-3.6-20091214.jar
poi-ooxml-3.6-20091214.jar
poi-ooxml-schemas-3.6-20091214.jar
xmlbeans-2.3.0.jar
Apache License Version 2.0

実行時にはさらに下記ライブラリを使用します。

ライブラリライセンス
commons-loggingApache License Version 2.0
Apache log4jApache License Version 2.0


最新リリース情報

excelpojo (1.1.2)2010-08-19 16:11

最近のチケット一覧

定義情報を継承できるようにしたい2010-08-17 15:51
Spring(2.0以降)の標準機能では、abstract,parentなどを指定して、定義情報に継承関係をつくることができます。 せっかくS...(未割り当て)
表の1行ごとに任意の処理を実行させたい2010-08-06 17:39
表を読み込んむ際に、1行ごとPOJOに詰めるのだが、このPOJOを用いて実行するメソッドを指定できるようにしたい。 先のチケ...(未割り当て)
表を1行ごと取得できるとうれしい2010-08-06 17:35
open(), close(), readNext()のような処理で、表を1行ごとPOJOとして取得できるとうれしい。 例えば大福帳の読み込みで、顧...(未割り当て)
書き込みの際に追加書きができるとうれしい2010-08-06 17:30
表を書き込む際に、検索された表の最終行に追加書きするモードがあるとうれしい。 例えば部署ごとの社員のリストを取得し、...(未割り当て)
拡張可能な構造にしたい2010-07-16 12:44
例えば新しいタグによる動作など、ユーザがあとから処理を組み込めるポイントを用意できれば、 案件に対してすべての要望に...(未割り当て)