如何在程序中嵌入FOP－－FOP简介

page-height="29.7cm"
page-width="21cm"
margin-top="1cm"
margin-bottom="2cm"
margin-left="2.5cm"
margin-right="2.5cm">

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


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文件，将显示两块文字，具体的fo语法请读者自己查看相应资料。

2． 简单调用FOP

FOP提供的所有对外调用接口都在org.apache.fop.apps下，其下的AWTStarter.class是一个用AWT写的转换结果预览程序。

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();
//设置要转换的fo文件名
driver.setInputSource(new InputSource (args[0]));
//设置输出文件名
driver.setOutputStream(new FileOutputStream(args[1]));
//设置转换类型
//还可以为RENDER_PCL,RENDER_PS,RENDER_TXT,RENDER_MIF
driver.setRenderer(Driver.RENDER_PDF);
//开始转换
driver.run();
}
catch( Exception e ){
e.printStackTrace();
}
}
}

上述程序将接受两个命令行参数，第一个参数是需要转换的fo文件名，第二个参数是输出文件名。在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
然后执行java foptest simple.fo simple.pdf

执行后产生的simple.pdf文件效果如下：

3． 显示中文

上面的演示程序段可以应付绝大部分转换编程的需要，不过对于国内用户来说，不可避免的需要产生中文PDF文件，让我们把上述simple.fo的标题从"FOP 0.20.2"改成"支持中文的FOP 0.20.2"，不改动程序的情况下执行结果显示如下：

可以看到由于没有加入相应的字体支持，汉字被显示成了#。

东方字符的显示在FOP的早期版本中并不被支持，最早尝试对FOP打补丁以解决显示东方字符的是日本人。从FOP 0.16版本开始，他们在sourceforge上建立了一个jpfop项目来解决日文字符的显示问题，使用相同的方法也可以被用来显示中文字符。幸运的是，当前的FOP版本已经能很好的解决中文显示的问题，不再需要我们打补丁，下面是在FOP中使用中文的步骤：

第一步，建立font metrics文件对于后缀为ttf的TrueType字体文件，我们可以执行以下命令来产生font metrics文件

java org.apache.fop.fonts.apps.TTFReader C:\WINNT\Fonts\simkai.ttf simkai.xml

这里simkai.xml就是我们为楷体产生的font metrics文件。

对于Windows下的宋体来说，存在的是后缀为ttc的TrueType Collection文件，即包含多个TrueType的文件，这时首先要做的是得到这个Collection中所有TrueType的名字，执行以下命令（这个命令其实有错误）：

java org.apache.fop.fonts.apps.TTFReader C:\WINNT\Fonts\simsun.ttc simsun.xml

产生输出如下：

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)

后面的异常是由于我们给的参数不对（因为ttc不是ttf字体文件）造成的，FOP开发小组知道这个问题，但是可能觉得无关痛痒而没去修正它。无论怎样，我们得到了我们要得到的结果，里面含的字体名为SimSun和NSimSun，通过以下命令为其中的SimSun字体产生font metrics文件：
java org.apache.fop.fonts.apps.TTFReader -ttcname "SimSun" C:\WINNT\Fonts\simsun.ttc simsun.xml
-ttcname后面指定需要从ttc文件中提取的字体名称

第二步，登记上述字体

在FOP主目录下的conf子目录下有一个userconfig.xml文件，为了方便，我们将它和上一步产生的simsun.xml，simkai.xml都拷贝到与我们的演示程序同一目录下。在userconfig.xml的最后几行有一个标记区，我们在其中加入以下项：

其中metrics-file里可以设相对路径或绝对路径（因为我们这里在同一目录下，所以只需写文件名即可），font-triplet里的name可以自己自由设定，并不要求与字体名一样。设定这个名字后，在fo里就只能通过这个名字引用这个字体。

为了演示中文显示，范例simplecn.fo文件为

http://www.w3.org/1999/XSL/Format">