今週のキャリッジさん

新年あけましておめでとうございます。今年もどうぞよろしくお願い申し上げます。

早速ですが、タイトルの件。 iTextが年末に2.1.7→5.0.0へ大幅バージョンアップしました。 （と言うより、メジャーバージョンをiText.jarをコンパイルしたJavaのバージョンに合わせたのだろうと思われます。） iText2.1.7以前のバージョンをGAE(Google App Engine)上で使う場合、GAEの制約でjava.awtパッケージを使わないようにするためのパッチを当てる必要がありました。iText5.0.0(以降？)では一部改修され、パッチを当てなくてもGAE上でiTextを使用することができるようになった。とっても素晴らしい！！

※具体的には、com.itextpdf.text.BaseColor、com.itextpdf.text.pdf.ICC_Profile、com.itextpdf.text.pdf.codec.wmf.Pointの３クラスのjava.awtパッケージ依存が無くなっただけ。なので、iTextが標準で持っている、java.awtパッケージに依存しているクラス・メソッドは依然として使用できない。それでも十分ですよ！

そこで、iText.jarをダウンロードして早速試してみる。・・・、が、GAE＆iText2.1.7用に作成した自前のクラスが軒並みコンパイルエラーを起こす。原因は、iTextのパッケージが、「com.lowagie」→「com.itextpdf」へ変更されているからだ。おぉぅ。。。

気を取り直して、importパッケージ名を全置換して再度コンパイル・・・、上手くいった。では、ローカルのGAE環境で実行！！　あれ？　実行エラーが発生。

Exception in thread "main" com.itextpdf.text.DocumentException: No message found for font.1.with.2.is.not.recognized
 at com.itextpdf.text.pdf.BaseFont.createFont(Unknown Source)
 at com.itextpdf.text.pdf.BaseFont.createFont(Unknown Source)
 at com.itextpdf.text.pdf.BaseFont.createFont(Unknown Source)
　：

あからさまにフォント絡みのエラーですよ。試しに、文字を出力しないコードに組み替えて実行してみると、正常に実行できた。が、文字を出力できないPDF生成って、ほとんど意味ないじゃん・・・。

がっかりな状態になってしまったが、ふとパッケージ名が変更されていることを思い出す。 我らは日本人なので、日本語フォントを使用できるように「iTextAsian.jar」と「iTextAsianCmaps.jar」を使っている。中には、「cmaps」というフォントファイルやプロパティファイルが転がっているだけなのだが、ご丁寧に「com.lowagie.・・・」とパッケージの中に入っている。そこで、このパッケージ名を変えてみることにした。面倒なので、jarコマンドを使用せず、zip解凍／圧縮ソフトを使っています。良い子の皆はちゃんとjarコマンドを使用しましょう。

手順：

・上記のiTextのホームページから、SourceForgeのiText　DOWNLOADページへ飛ぶ。

・iText.jar(5.0.0)をダウンロードしてなければ、ダウンロードする。 ・「extrajars＞ExtraJars1.0」を辿って、iTextAsian.jarとiTextAsianCmaps.jarをダウンロード。

・iTextAsian.jarとiTextAsianCmaps.jarの拡張子を「.zip」に変更して、その辺の解凍ソフトで解凍。（別のディレクトリでやること。ただし、この機会に１つのjarにしたい場合は、一緒のディレクトリで実行してOKだが、両zipの展開先が１つになるので、以降の手順に注意）

・各々、「com/lowagie」のディレクトリを「com/itextpdf」へ変更。 ・各々のディレクトリを、圧縮ソフトでzip圧縮する。zip内のディレクトリ構成は、元に戻すようにする。（つまり、「com」ディレクトリと「META-INF」ディレクトリがzip内のルートディレクトリに存在するようにする）

・ファイル名を「～.zip」からiTextAsian.jarとiTextAsianCmaps.jarに戻す。

これでできたjarを実行パスに追加して、再度自前クラスを実行！・・・おぉぉ、上手くいきました！！　全部のフォントを試した訳ではないですが、ひとまずこれでOKでしょう。そのうち、正式なjarファイルがアップロードされるでしょうけど、それまでの辛抱（？）です。

十分な動作検証を行っていませんが、「すぐに使いたい！」という方のために、ファイルをアップロードしておきます。ご自由にお使いください。（ただし、各種保証無しです）

・iTextAsian.zip(for iText5.0.0)

・iTextAsianCmaps.zip(for iText5.0.0)

追伸：実際にGAEへアップして実行したところ、com.itextpdf.text.pdf.PdfReaderクラスが使用しているcom.itextpdf.text.pdf.MappedRandomAccessFileクラスが、GAEのホワイトリストに登録されていないjava.nio.MappedByteBufferクラスを使用しているため、動きませんでした。orz　パッチ作るか・・・？？

ま、iText5.0.0で日本語を使える環境ができたから、とりあえず良しとしよう。