CookBook1 基礎編

1-13付録

1-13-1 CookBookで作成したサンプルを動かすには

CookBook1（基礎編）が収められているcookbookディレクトリの構造を次に示します。

|cookbook
|- chapter1-1    空文書を準備する
|- chapter1-2    ページを新規作成する
|- chapter1-3    指定したフィールドに文字列を埋め込む
|- chapter1-4    埋め込み文字列のフォントサイズを全て変更する
|- chapter1-5    フィールドに埋め込んだ文字列を右揃えにする
|- chapter1-6    複数行の文字列をフィールドの上端から表示する
|- chapter1-7    フォントサイズを変更する
|- chapter1-8    フォント名を変更する
|- chapter1-9    フォントカラーを変更する
|- chapter1-10   フィールドの背景色を設定する
|- chapter1-11   フィールドの枠線を引く
|- chapter1-12   まとめ
|- chapter1-13   付録
|- images         説明用画像
|- resources     プログラム実行に使用するファイル
|  |- form       テンプレートファイルを配置したディレクトリ
|  +- initial    テンプレートの元ファイルを配置したディレクトリ
|

サンプルプログラムは次に示すように、Chapter毎に用意したディレクトリ配下にOrderFormFin.javaファイルを配置しています。
chapter1-1 には、他のChapterと異なりCookBook1（基礎編）で使用するテンプレートをコンパイルするためのTemplateCreate.javaとコードを追記していく練習用のソースコードとしてOrderFormFin_try.javaを用意しています。
chapter1-2 以降のディレクトリには、サンプルプログラムOrderFormFin.java、追記したコード箇所を表示したOrderFormFin.html、サンプルプログラム実行結果OrderFormFin.pdfファイルを配置しています。

|cookbook
|- chapter1-1                空文書を準備する
|  |- build.xml              サンプルプログラムをコンパイル・実行するAntファイル
|  |- OrderFormFin.html      追記したコード箇所を表示したHTML文書
|  |- OrderFormFin.java      サンプルプログラム
|  |- OrderFormFin.pdf       サンプルプログラムの実行結果
|  |- OrderFormFin_try.java  練習用ソースコード
|  +- TemplateCreate.java    使用するテンプレートをコンパイルするプログラム
|- chapter1-2                ページを新規作成する
|  |- build.xml               サンプルプログラムをコンパイル・実行するAntファイル
|  |- OrderFormFin.html      追記したコード箇所を表示したHTML文書
|  |- OrderFormFin.java      サンプルプログラム
|  +- OrderFormFin.pdf       サンプルプログラムの実行結果
|

サンプルプログラムを簡単に実行するために、Chapter ディレクトリ毎にAnt ビルドツールのビルドファイルbuild.xmlを用意しています。

Ant ビルドツールは、1.5.xに対応しています。
それ以前のバージョンをお使いやプラットフォームにAntビルドツールがインストールされていない場合には、Antビルドツールをインストールしてください。
Ant ウェブページ http://ant.apache.org/から安定バージョンのAntビルドツールをダウンロードできます。
Antを動作させるために、Ant配布のbinディリクトリをあなたの PATH環境変数に、あなたのOS環境の標準的な方法で追加してください。
これが完了すれば、Ant は、シェルコマンドから直接起動することができます。

サンプルを実行するには、実行したい Chapter ディレクトリに移動して、Ant コマンドを実行してください。

% ant
Buildfile: build.xml
compile:
    [depend] Deleted 0 out of date files in 0 seconds
    [javac] Compiling 1 source file to XXXXXXX/XXX/chapter1-2
run:
BUILD SUCCESSFUL
Total time: 2 seconds

【 注意 】
サンプルを実行するには、wkc-pdflib.jarにライセンスを登録する必要があります。
ライセンス登録についての詳細はこちらをご覧ください。

chapter1-2 以降のサンプルプログラムを実行する前に、chapter1-1 のAnt コマンドを実行して使用するテンプレートをコンパイルしてください。

作成したプログラムを実行するためには

本ライブラリを使用したアプリケーションを実行するには、以下のシステムプロパティをJavaVM実行環境に設定する必要があります。

プロパティ名説明
wkc.pdf.lib.home環境変数 WKC_PDF_HOME に設定したパスを設定してください。
これは、本ライブラリが使用するホームディレクトリを指定します。
通常は、WPRLインストールディレクトリをホームディレクトリとして設定してください。
xGram.0 ～xGram.9申込グラム数

1-13-2 テンプレートPDFファイルに定義されているフィールド

基礎編のテンプレートPDFファイルに定義してあるフィールドは、以下の通りです。

フィールド定義一覧

フィールド名称フィールド意味
xFormTypeフォーム利用目的
xGram.0 ～xGram.9申込グラム数
xAmountC.0～xAmountC.9豆合計金額
xNumber.0～xNumber.8数量
XAmountA.0～xAmountA.8アクセサリー合計金額
xAllAmount総合計金額
xPayment.0～xPayment.2 お支払方法
xCard.0～xCard.2カード種類
xCardNo.0～xCardNo.3カード番号
xCardTermYカード期限年
xCardTermMカード期限月
xCardNameカードご名義
xSendDay.0～xSendDay.2希望配達日
xSendTime.0～xSendTime.2希望配達時間
xYear受付年
xMonth受付月
xDay受付日
xCustomerNameお客様氏名
xCustomerNoお客様番号
xPostCode郵便番号
xAddressご住所
xPhoneNoお電話番号
xFree備考欄
xFaxFAX番号

◎フィールド定義位置のイメージ：cookbook1/chapter1-13/preview_OrderForm.pdf

1-13-3 TrueTypeフォントを登録する

「1-8 フォント名を変更する」以降では、TrueTypeフォント - MSGothic を使用しています。
TrueTypeフォントを使用するにはフォントをWPRLに登録することが必要です。

TrueTypeフォントのWPRLへの登録は、waddTTFユーティリティを実行して行ないます。
「1-8 フォント名を変更する」以降のプログラムを実行する前に、WPRLホームディレクトリ下のfontsディレクトリにサンプルで使用しているMSGothicフォントを登録します。
MSGothicフォントは、Windows OS 環境に標準でmsgothic.ttcファイルとして含まれています。
以後、例示は実行環境としてWindows OS 環境を想定することにします。
Linux/Unix OS 環境でプログラムを実行する方は、適宜読みかえてください。
MSGothicフォントは、Windows OS 環境では以下に示すパスのどちらかにフォントファイルは存在します。

c:\windows\fonts\msgothic.ttc
c:\winnt\fonts\msgothic.ttc

このファイルをWPRLホームディレクトリ下のfontsディレクトリにコピーしてください。 以降WPRLホームディレクトリを示す環境変数を%WKC_PDF_HOME%とします。

% copy msgothic.ttc %WKC_PDF_HOME%\fonts
%

【 注意 】
Windows OS 環境以外のLinux/Unix OS環境などでプログラムを実行する場合は、お手数ですが OS 環境に標準でバンドルされているゴシックフォントを利用するか別途購入したTrueTypeフォントを使用するように 1-8 以降のプログラムを修正してください。
これらの環境で、MSGothicフォントを使用するとフォントの使用許諾違反になります。
フォントをコピー後、waddTTFユーティリティを実行してください。

% waddTTF
TrueType Font Index Creator [bulid. 2004.16]
scan fonts directory : %WKC_PDF_HOME%\fonts
append TrueType font index ...
ＭＳ ゴシック , MSGothic , msgothic.ttc,0
ＭＳ ゴシック , MS-Gothic , msgothic.ttc,0
ＭＳ Ｐゴシック , MSPGothic , msgothic.ttc,1
ＭＳ Ｐゴシック , MS-PGothic , msgothic.ttc,1
MS UI Gothic , MSUIGothic , msgothic.ttc,2
MS UI Gothic , MS-UI-Gothic , msgothic.ttc,2
... finished.

fontsディレクトリのtrue_type_fonts.propertiesプロパティファイルの内容が以下のようになることを確認してください。

MS-Gothic=msgothic.ttc,0
MSGothic=msgothic.ttc,0
MS-PGothic=msgothic.ttc,1
MSPGothic=msgothic.ttc,1
MS-UIGothic=msgothic.ttc,2
MSUIGothic=msgothic.ttc,2

これで設定は終了です。
なおより詳細な説明については、こちらをご覧ください。

PAGE TOP