BIRT使用API进行简单部署到项目中.docVIP

首先，这个API部署其实在官网上是叫Servlet Example。我没有在网上找到中文的这个教程，所以我就以我这贫乏的英语水品来自己理解了官网上的步骤。下面直接开始，我不是原文翻译的所以有些地方用词不当也是正常。既然是个Servlet Exampl那么它肯定符合Java EE的规范。我先把目录结构贴到下面，让大家先有个整体感觉。图片不是很清楚，凑合着看吧。我先说下目录结构Tomcat和Webapps就不说了。下面就是自己新建一个自己的文件夹在tomcat/webapps下面是自己的API BIRT的项目。名字自己起就好了，官网上是叫WebReport吧，上面写的很清楚了。我自己是叫TestAPI??? Images和Reports是用来放报表的地方，Images是图片和图像报表，然后Reports是文字报表。就是把自己建好的报表copy到 Reports里面。具体建报表就不说了，自带的帮助文档和网上有很多资料。下面就是WEB-INF目录了，建立好这个目录，你的API所有配置和用的资源才可以发动。在WEB-INF下面的lib没用过也知道是放jar的地方。还有一个platform也是放一些报表运行所需的配置信息和一些jar。其实我们都知道上面图其实应该在WEB-INF下面还有个classes文件夹，用来放编译好的java文件。这也是个重要的目录。上面没有画。官网上是分了五步，我这里就按自己的来了，也不说分步了。首先也是需要一个runtime从/downloads/download.php?file=/birt/downloads/drops/R-R1-2_1_3-200707051847/birt-runtime-2.1.3.zip你可以下载到这个“runtime”不是很大。下载好以后打开，然后进入ReportEngine目录把lib里的所有jar包全部拷贝到自己建立的lib下面，如图然后开始往platform里面塞东西。把runtime/ReportEngine的两个文件夹（plugins和configuration）拷贝到你自己的platform里面。plugins里面也是一些报表所需的jar而configuration里面是什么东西？就是一个config.ini文件，我不知道是干什么用的。拷完之后如下：如果你的报表用到数据库驱动了，必须把数据库驱动文件拷贝到\WEB-INF\platform\plugins\org.eclipse.birt.report.data.oda.jdbc_2.1.1.1847\drivers这个路径下面，看着长其实不难找。拷贝完是这样，贴个图：配置就差不多了，就查一个web.xml文件了。下面是比较重要的东西。有三个文件。是API的核心操作文件。 ? BirtCperties - Configuration properties for the Engine. ? BirtEngine.java - Class used to initialize the Report Engine. ? WebReport.java - The servlet that handles report generation on a GET command. ? 就是上面三个文件是官网的原文，我拷贝过来的。第一个是构造报表引擎的资源文件。第二个用来初始化报表引擎的类。第三个用GET方法来调用报表。我英文不好，自己理解是这样的。（四级我都没考，我觉得找个美国人待上一个月英语水平就上去了）具体这三个文件的代码我贴到下面BirtCperties logDirectory=c:/templogLevel=FINEST BirtEngine.java import?java.io.InputStream;import?java.io.IOException;import?java.util.Properties;import?java.util.logging.Level;import?org.eclipse.birt.report.engine.api.EngineConfig;import?org.eclipse.birt.report.engine.api.IReportEngine;import?javax.servlet.*;import?org.eclipse.birt.core.framework.PlatformServletContext;import?org.eclipse.birt.core.framework.IPlatformContext;import??org.eclipse.bir