BIRT 2.2.2 运行时使用已有的java.sql.Connection来生成报表

   注：本文实现的思路不是原创，思路原文来自：

http://birtworld.blogspot.com/2005/12/using-supplied-connection-with-birt.html

 

   本文将介绍BIRT2.2 详细的扩展与配置：

 

   在ECLIPSE中新建一个工程 new-> Bussiness Intelligence Report Tools -> Web Project 名字：MyBirt

并设置好服务器信息（本文选用Tomcat5.5、JDK1.5）。

   建好工程以后，需要添家JDBC驱动程序到报表引擎中，本例连接ORACLE，因此将ORACLE的JDBC驱动包复制到 工程站点下的 /WEB-INF/platform/plugins/org.eclipse.birt.report.data.oda.jdbc_xxxxxxx/drivers目录下。

   接下来就是继承OdaJdbcDriver类了，再此之前需要在ClassPath中Add oda-jdbc.jar 和 org.eclipse.datatools.connectivity.oda_xxxxxxxxxxxx.jar这两个包，前者位于上边提到的drivers路径的上一级，后着则在plugins下。 新建一个Class：MyJdbcDriver，指定到某个包路径下，代码如下：

package com.wenmin.birt.data.oda.jdbc;

import org.eclipse.birt.report.data.oda.jdbc.OdaJdbcDriver;
import java.sql.Connection;
import java.util.HashMap;
import java.util.Properties;

import org.eclipse.birt.report.data.oda.jdbc.*;
import org.eclipse.datatools.connectivity.oda.IConnection;
import org.eclipse.datatools.connectivity.oda.OdaException;

public class MyJdbcDriver extends OdaJdbcDriver 
{

	private Connection passedInConnection;
	public static final String DATASOURCE_KEY_CONNECTION = "com.wenmin.birt.data.odb.jdbc.MyJdbcDriver";
	
	public void setAppContext( Object context ) throws OdaException
	{
	    HashMap ctx = (HashMap)context;
	    passedInConnection = (java.sql.Connection)ctx.get(DATASOURCE_KEY_CONNECTION);
	
	}	
	
	public IConnection getConnection(String connectionClassName) throws OdaException
	{
		if( passedInConnection != null){
			return new appContextDBConnection();
		}else{
			return new org.eclipse.birt.report.data.oda.jdbc.Connection();
		}
	}
	


	private class appContextDBConnection extends org.eclipse.birt.report.data.oda.jdbc.Connection
	{
	
			
		public void open(Properties connProperties) throws OdaException
		{
			super.jdbcConn = passedInConnection;			
		
		}
		
		public void close( ) throws OdaException
		{
			if ( jdbcConn == null )
			{
				return;
			}
			//should have call to return connection to the pool
			jdbcConn = null;						
		}				
		
		
		
	}
}

 

OK，接下来我们来打个包，利用ECLIPSE EXPORT一个 jar包，（“怎么做？”，“。。。拖下去，暴头！”）。

本例导出包名字为：cst_driver.jar，拷贝到/WEB-INF/platform/plugins/org.eclipse.birt.report.data.oda.jdbc_xxxxxxx/目录下。

      最后就是修改配置文件，第一个需要改的文件plugin.xml位于 /WEB-INF/platform/plugins/org.eclipse.birt.report.data.oda.jdbc_xxxxxxx/目录下

找到如下节点：

...
<extension
         point="org.eclipse.datatools.connectivity.oda.dataSource">
      <dataSource
            odaVersion="3.1"
            driverClass="org.eclipse.birt.report.data.oda.jdbc.OdaJdbcDriver"
            defaultDisplayName="%datasource.name"
            setThreadContextClassLoader="false"
            id="%oda.data.source.id">
....

 

修改为：

...
<extension
         point="org.eclipse.datatools.connectivity.oda.dataSource">
      <dataSource
            odaVersion="3.1"
            driverClass="com.wenmin.birt.data.oda.jdbc.MyJdbcDriver"
            defaultDisplayName="%datasource.name"
            setThreadContextClassLoader="false"
            id="%oda.data.source.id">
...

 其他内容不需要改变。

 然后在META-INF下的MANIFEST.MF中找到如下位置，添加刚才导出的包cst_driver.jar

Bundle-ClassPath: oda-jdbc.jar,derby.jar,cst_driver.jar

 

大功告成，接下来在程序中使用：

//....   
     HashMap contextMap = new HashMap();   

    //...
     contextMap.put(MyJdbcDriver.DATASOURCE_KEY_CONNECTION, conn);  //conn为系统中获得的数据库连接
    task.setAppContext( contextMap );   //IRunAndRenderTask 
//...

 这样，无论在设计时指定了什么数据源，都会在运行时通过已有的conn连接数据库了。

 由于是这两天才接触的BIRT，文章有不足之处还请多多指正，谢谢。

这种方式是变相修改BIRT自带的JDBC ODA Driver实现，也许能工作，但风险较大，例如会不会导致其他问题，在BIRT升级后依然有效吗等。

事实上，不久，BIRT就会支持通过传入java.sql.Connection实例的方式创建数据源了，见
https://bugs.eclipse.org/bugs/show_bug.cgi?id=236565

BIRT开发团队实际上就在国内:)推荐BIRT官方中文论坛：http://www.actuatechina.com/index.php