3.例子：PDFServlet我们的例子应用由一个类组成：PDFServlet。这个servlet采用B技术。输出流OutputStream是java.io.ByteArryOutputStream。用ByteArrayOutputStream，PDF文档字节将存储在内存中。当PDFServlet接收到一个HTTP请求时，它将动态地生成一个PDF文档并将该文档发送到客户端。 PDFServlet类扩展了javax.servlet.http.HttpServlet类并导入了两个iText包：com.lowagie.text和com.lowagie.text.pdf。 doGet方法 大多数servlet覆盖了doPost和doGet方法中的一个方法。我们的servlet没有什么不同。PDFServlet类覆盖了doGet方法。该servlet将在接收到HTTP GET请求后生成一个PDF文件。 在核心部分，servlet的doGet方法做了如下的工作： 1.创建一个包含PDF文档字节的ByteArrayOutputStream对象； 2.在reponse对象上设置HTTP响应头内容； 3.得到servlet输出流； 4.把文档字节写到servlet的输出流中； 5.刷新servlet输出流； generatePDFDocumentBytes方法 generatePDFDocumentBytes方法负责创建PDF文档。在这个方法中三个最重要的对象是Document对象，ByteArrayOutputStream对象和PdfWriter对象。PdfWriter使用ByteArrayOutputStream关联Document。 Document doc = new Document(); ByteArrayOutputStream baosPDF = new ByteArrayOutputStream(); PdfWriter docWriter = null; docWriter = PdfWriter.getInstance(doc, baosPDF); // ... 用add方法把内容添加到Document中。 doc.add(new Paragraph( "This document was created by a class named: " + this.getClass().getName())); doc.add(new Paragraph( "This document was created on " + new java.util.Date())); 当你添加完内容后，要关闭Document和PdfWriter对象。 doc.close(); docWriter.close(); 当关闭文档后，ByteArrayOutputStream对象返回到调用者。 return baosPDF; ByteArrayOutputStream包含了PDF文档的所有字节。 HTTP响应头 在这个应用中，我们仅仅关注四个HTTP 响应头：Content-type,Content-disposition,Content-length,和Cache-control。如果你从没有使用过HTTP头，请参考HTTP 1.1规范。 研究在PDFServlet中的doGet方法，你会注意到要在任何数据写到servlet输出流之前设置HTTP响应头内容，这是很重要的，也是细微的一点。 让我们更详细地说明一下每个响应头的含义。 Content-type 在servlet中，HttpServletResponse有一个表明响应所包含内容类型的参数。对PDF文件而言，内容类型是application/pdf。如果servlet没有设置类型，web浏览器很难决定如何处理这个文件。 PDFServlet用下边的代码设置内容类型： resp.setContentType("application/pdf"); Content-disposition Content-disposition头提供给浏览器确定HTTP响应内容的信息。当浏览器读到这些头信息后，它能确定： RFC 2183中有对Content-disposition头完整的解释。 通过合适地设置Content-disposition的值，servlet能指示浏览器是“内嵌”显示文件还是把它当作附件处理。 例1.内嵌显示一个文件 Content-disposition: inline; filename=foobar.pdf 例2.往response里附加一个文件 Content-disposition: attachment; filename=foobar.pdf 下边的伪码说明了如何设置头信息： public void doGet(HttpServletRequest req, HttpServletResponse resp) { // ... resp.setHeader( "Content-disposition", "inline; filename=foobar.pdf" ); // ... } Cache-Control 根据你应用的特性不同，你可以让浏览器缓存或者不缓存你正在生成的PDF文件。服务器端应用可以有很多种HTTP 头来控制内容缓存。下边是一些例子： 关于Cache-Control头的全面解释见HTTP 1.1规范。 PDFServlet把Cache-Control设置为max-age=30。这个头信息告诉浏览器缓存这个文件的最长时间为30秒。 Content-length Content-length头必须设置成PDF文件中字节的数值。如果Content-length没有设置正确，浏览器可能不能正确地显示该文件。下边是例子代码： ByteArrayOutputStream baos = getByteArrayOutputStream(); resp.setContentLength(baos.size()); 把PDF文档送到Web浏览器 PDFServlet通过把字节流写到servlet的输出流的方式把PDF文档送到客户端。它通过调用HttpServletResponse对象的getOutputStream方法来获得输出流。getOutputStream方法返回一个javax.servlet.ServletOutputStream类型的对象。 ServletOutputStream sos; sos = resp.getOutputStream(); baos.writeTo(sos); sos.flush(); 在把所有的数据写到流之后，调用flush()方法把所有的字节发送到客户端。 打包和部署 为了在Tomcat中运行PDFServlet，你需要把应用打包在WAR文件中。iText JAR文件(itext-0.99.jar)必须放在WAR文件的lib目录下边。如果你忘了把iText JAR文件打包进去，servlet会报一个java.lang.NoClassDefFoundError的错误并停止运行。 运行应用 在WAR文件部署之后，你已经准备好了测试servlet了。Jakarta Tomcat在8080端口上监听请求。 在浏览器中请求http://hostname:8080/pdfservlet/createpdf。servlet将会执行并返回浏览器一个PDF文档。 4.iText之外的方案iText提供了许多产生PDF文档的底层API。然而，它不是对任何应用都有效。 在我的日常工作中，我结合Microsoft Word和Adobe Acrobat使用iText。首先，我们的团队使用Microsoft Word设计了一个出货表单。之后，我们用Acrobat把Word文档转换成PDF文档。然后，我们使用iText的模板的功能，我们把PDF文件装入到我们的应用中。从这里，把数据填入表格和输出最终的PDF文档是相当容易的。 对基于报表的Web应用，像JasperReports这样的工具,它提供了比iText更高层次的抽象。 5.总结当你的应用需要动态地创建PDF文档的时，iText类库是一个不错的方案。你可以通过增强和扩展本文中的代码来体验iText的能力。很快，由于提供了完善的PDF文档，你将会给你的同事和客户留下深刻的印象。 |
