如何在程序中嵌入FOP????
FOP 簡介
馬 路 (stevema@263.net)
2001 年 11 月
如何在程序中嵌入FOP？FOP是由James Tauber發(fā)起的一個開源項(xiàng)目，最初的目的是利用xsl-fo將xml文件轉(zhuǎn)換成pdf文件。目前最新的版本是2001年9月29日發(fā)布的0.20.2，它可以將xml文件轉(zhuǎn)換成pdf，mif，pcl，txt等多種格式以及直接輸出到打印機(jī)，并且支持使用SVG描述圖形。XML顯然是最好的內(nèi)容存儲格式，而PDF是目前最流行的內(nèi)容載體格式，F(xiàn)OP顯然希望借助這種必然的XML to PDF需求，來推動xsl-fo規(guī)范的發(fā)展。雖然xsl-fo規(guī)范停滯不前，但利用FOP能使自己的程序具有將XML內(nèi)容輸出成PDF等流行格式的功能無疑是令人興奮的。
FOP使用方式
FOP有3種使用方式，分別為命令行，程序嵌入，XT 嵌入，這里將主要介紹如何在程序中嵌入FOP功能。將XML文件轉(zhuǎn)換為PDF實(shí)際上分為2步，第1步是利用XSLT將XML轉(zhuǎn)換為XSL-FO，第2步是將XSL-FO轉(zhuǎn)換為PDF。這里不想講述XSLT和XSL-FO有關(guān)的知識（這方面的文檔相當(dāng)多），而只將講述如何進(jìn)行第2步的轉(zhuǎn)換編程。
在程序中嵌入FOP
1． 范例simple.fo文件
<?xml version="1.0" encoding="utf-8"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
? <fo:layout-master-set>
??? <fo:simple-page-master master-name="simple"
????????????????? page-height="29.7cm"
????????????????? page-width="21cm"
????????????????? margin-top="1cm"
????????????????? margin-bottom="2cm"
????????????????? margin-left="2.5cm"
????????????????? margin-right="2.5cm">
????? <fo:region-body margin-top="3cm"/>
????? <fo:region-before extent="3cm"/>
????? <fo:region-after extent="1.5cm"/>
??? </fo:simple-page-master>
? </fo:layout-master-set>
? <fo:page-sequence master-name="simple">
??? <fo:flow flow-name="xsl-region-body">
?????? <!-- Title -->
????? <fo:block font-size="18pt"
??????????? font-family="sans-serif"
??????????? line-height="24pt"
??????????? space-after.optimum="15pt"
??????????? background-color="blue"
??????????? color="white"
??????????? text-align="center"
??????????? padding-top="3pt">
??????????? FOP 0.20.2
????? </fo:block>
????? <!-- Normal Text -->
????? <fo:block font-size="12pt"
??????????????? font-family="sans-serif"
??????????????? line-height="15pt"
??????????????? space-after.optimum="3pt"
??????????????? text-align="justify">
FOP is the world's first print formatter driven by XSL formatting objects.
It is a Java application that reads a formatting object tree and then turns it into a PDF document.
????? </fo:block>
??? </fo:flow>
? </fo:page-sequence>
</fo:root>
上述是一個很簡單的fo文件，將顯示兩塊文字，具體的fo語法請讀者自己查看相應(yīng)資料。
2． 簡單調(diào)用FOP
FOP提供的所有對外調(diào)用接口都在org.apache.fop.apps下，其下的AWTStarter.class是一個用AWT寫的轉(zhuǎn)換結(jié)果預(yù)覽程序，CommandLineStarter.class提供命令行使用方式，PrintStarter.class提供打印接口，XTDriver.class提供XT嵌入方式接口，Driver.class則是我們要在這里討論的程序接口。下面這個程序foptest.java演示了FOP的最簡單也是最常用的使用方式。
import java.io.*;
import org.xml.sax.InputSource;
import org.xml.sax.XMLReader;
import org.apache.fop.apps.*;
public class foptest {
public static void main(String[] args) {
try {
Driver driver = new Driver();
//設(shè)置要轉(zhuǎn)換的fo文件名
driver.setInputSource(new InputSource (args[0]));
//設(shè)置輸出文件名
driver.setOutputStream(new FileOutputStream(args[1]));
//設(shè)置轉(zhuǎn)換類型
//還可以為RENDER_PCL,RENDER_PS,RENDER_TXT,RENDER_MIF
driver.setRenderer(Driver.RENDER_PDF);
//開始轉(zhuǎn)換
driver.run();
}
catch( Exception e ){
e.printStackTrace();
}
}
}
上述程序?qū)⒔邮軆蓚€命令行參數(shù)，第一個參數(shù)是需要轉(zhuǎn)換的fo文件名，第二個參數(shù)是輸出文件名。在CLASSPATH中添加下述jar文件：
{FOP安裝目錄}\build\fop.jar
{FOP安裝目錄}\lib\batik.jar
{FOP安裝目錄}\lib\xalan-2.0.0.jar
{FOP安裝目錄}\lib\xerces-1.2.3.jar
{FOP安裝目錄}\lib\avalon-framework-4.0.jar
{FOP安裝目錄}\lib\logkit-1.0b4.jar
{FOP安裝目錄}\lib\jimi-1.0.jar
然后執(zhí)行java foptest simple.fo simple.pdf
執(zhí)行后產(chǎn)生的simple.pdf文件效果如下
3． 顯示中文
上面的演示程序段可以應(yīng)付絕大部分轉(zhuǎn)換編程的需要，不過對于國內(nèi)用戶來說，不可避免的需要產(chǎn)生中文PDF文件，讓我們把上述simple.fo的標(biāo)題從"FOP 0.20.2"改成"支持中文的FOP 0.20.2"，不改動程序的情況下執(zhí)行結(jié)果顯示如下
可以看到由于沒有加入相應(yīng)的字體支持，漢字被顯示成了#。
東方字符的顯示在FOP的早期版本中并不被支持，最早嘗試對FOP打補(bǔ)丁以解決顯示東方字符的是日本人。從FOP 0.16版本開始，他們在sourceforge上建立了一個jpfop項(xiàng)目來解決日文字符的顯示問題，使用相同的方法也可以被用來顯示中文字符。幸運(yùn)的是，當(dāng)前的FOP版本已經(jīng)能很好的解決中文顯示的問題，不再需要我們打補(bǔ)丁，下面是在FOP中使用中文的步驟：
第一步，建立font metrics文件對于后綴為ttf的TrueType字體文件，我們可以執(zhí)行以下命令來產(chǎn)生font metrics文件
java org.apache.fop.fonts.apps.TTFReader C:\WINNT\Fonts\simkai.ttf simkai.xml
這里simkai.xml就是我們?yōu)榭w產(chǎn)生的font metrics文件。
對于Windows下的宋體來說，存在的是后綴為ttc的TrueType Collection文件，即包含多個TrueType的文件，這時首先要做的是得到這個Collection中所有TrueType的名字，執(zhí)行以下命令（這個命令其實(shí)有錯誤）：
java org.apache.fop.fonts.apps.TTFReader C:\WINNT\Fonts\simsun.ttc simsun.xml
產(chǎn)生輸出如下：
This is a TrueType collection file with2 fonts
Containing the following fonts:
SimSun
NSimSun
java.io.IOException: Failed to read font
??????? at org.apache.fop.fonts.TTFFile.readFont(TTFFile.java:388)
??????? at org.apache.fop.fonts.apps.TTFReader.loadTTF(TTFReader.java:181)
??????? at org.apache.fop.fonts.apps.TTFReader.main(TTFReader.java:143)
后面的異常是由于我們給的參數(shù)不對（因?yàn)閠tc不是ttf字體文件）造成的，F(xiàn)OP開發(fā)小組知道這個問題，但是可能覺得無關(guān)痛癢而沒去修正它。無論怎樣，我們得到了我們要得到的結(jié)果，里面含的字體名為SimSun和NSimSun，通過以下命令為其中的SimSun字體產(chǎn)生font metrics文件：
java org.apache.fop.fonts.apps.TTFReader -ttcname "SimSun" C:\WINNT\Fonts\simsun.ttc simsun.xml
-ttcname后面指定需要從ttc文件中提取的字體名稱
第二步，登記上述字體
在FOP主目錄下的conf子目錄下有一個userconfig.xml文件，為了方便，我們將它和上一步產(chǎn)生的simsun.xml，simkai.xml都拷貝到與我們的演示程序同一目錄下。在userconfig.xml的最后幾行有一個<fonts></fonts>標(biāo)記區(qū)，我們在其中加入以下項(xiàng)：
<font metrics-file="simsun.xml" kerning="yes" embed-file="c:\WINNT\fonts\simsun.ttc">
??? <font-triplet name="mysimsun" style="normal" weight="normal"/>
</font>
<font metrics-file="simkai.xml" kerning="yes" embed-file="c:\WINNT\fonts\simkai.ttf">
??? <font-triplet name="mysimkai" style="normal" weight="normal"/>
</font>
其中metrics-file里可以設(shè)相對路徑或絕對路徑（因?yàn)槲覀冞@里在同一目錄下，所以只需寫文件名即可），font-triplet里的name可以自己自由設(shè)定，并不要求與字體名一樣。設(shè)定這個名字后，在fo里就只能通過這個名字引用這個字體。
為了演示中文顯示，范例simplecn.fo文件為
<?xml version="1.0" encoding="gb2312"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
? <fo:layout-master-set>
??? <fo:simple-page-master master-name="simple"
????????????????? page-height="29.7cm"
????????????????? page-width="21cm"
????????????????? margin-top="1cm"
????????????????? margin-bottom="2cm"
????????????????? margin-left="2.5cm"
????????????????? margin-right="2.5cm">
????? <fo:region-body margin-top="3cm"/>
????? <fo:region-before extent="3cm"/>
????? <fo:region-after extent="1.5cm"/>
??? </fo:simple-page-master>
? </fo:layout-master-set>
? <fo:page-sequence master-name="simple">
??? <fo:flow flow-name="xsl-region-body">
????? <fo:block font-size="18pt"
??????????? font-family="mysimsun"
??????????? line-height="24pt"
??????????? text-align="center"
??????????? padding-top="3pt">
??????????? 這是宋體
????? </fo:block>
????? <fo:block font-size="18pt"
??????????? font-family="mysimkai"
??????????? line-height="24pt"
??????????? text-align="center"
??????????? padding-top="3pt">
??????????? 這是楷體
????? </fo:block>
??? </fo:flow>
? </fo:page-sequence>
</fo:root>
上述fo文件使用兩種字體分別顯示一行文字，注意在<fo:block>的屬性中的font-family被我們設(shè)成userconfig.xml中相應(yīng)的名字。
由于需要讀入userconfig.xml來得到字體信息，程序主體修改如下：
Driver driver = new Driver();
driver.setInputSource(new InputSource (args[0]));
driver.setOutputStream(new FileOutputStream(args[1]));
driver.setRenderer(Driver.RENDER_PDF);
//讀入配置（在Options的構(gòu)造函數(shù)中完成）
Options options = new Options(new File("userconfig.xml"));
driver.run();
這里在run之前一行讀入配置（產(chǎn)生的Options的實(shí)例在以后沒有用處），執(zhí)行結(jié)果為：
總結(jié)
FOP從技術(shù)上說無疑是一個非常優(yōu)秀的產(chǎn)品，但是目前它對用戶的開發(fā)支持顯然很欠缺。FOP的開發(fā)小組也意識到了這個問題，他們允諾在將來會建立一個專門的Web站點(diǎn)以及豐富它的文檔。如果現(xiàn)在就想使用更方便的產(chǎn)品的話，你也可以考慮一些商用產(chǎn)品，如RenderX和X2P。
另外需要注意的是，今年8月推出的FOP 0.20.1版本非常的不好，不但一些范例無法運(yùn)行，而且附帶的源代碼有若干錯誤，而這個9月29日推出的0.20.2RC版本有極大的改進(jìn)，建議大家盡快升級到這個版本。
參考資料
FOP主站點(diǎn) http://xml.apache.org/fop
FO規(guī)范 http://www.w3.org/TR/xsl/
關(guān)于作者：
馬路，2000級清華大學(xué)計(jì)算機(jī)系研究生，目前在清華大學(xué)Java應(yīng)用技術(shù)實(shí)驗(yàn)室學(xué)習(xí)。E-mail:stevema@263.net