创建数据适配器
数据适配器是一个指定到哪里获取数据,以及如何获取数据的资源。
数据适配器以 XML 文件的形式保存。它使得在 JasperReports 环境之间移植报表配置和数据源创建很容易。
在项目中创建数据适配器
当在项目中创建数据适配器时,它会以一个 XML 文件的形式被保存在这个项目中。将这个 XML 文件和你的报表保存在相同的项目中,可以使向 JasperReports Server 部署中部署这个数据适配器更容易。
-
在 Project Explorer 中,右击要创建数据适配器的项目,选择 New > Data Adapter。
-
在 DataAdapter File 窗口,选择你要保存数据适配器文件的项目。这里应该选择包含着要用到该数据适配器的报表的项目。
输入文件名。
点击 Next。
-
在 Data Adapters 窗口,选择你要的数据适配器类型(这里以 Database JDBC Connection)为例。
点击 Next。
-
为适配器输入名字。当要为报表选择一个适配器时,会用到这个名字。
选择 JDBC 驱动器(这里以 com.mysql.jdbc.Driver)为例。
输入正确的 JDBC Url、Username、Password。注意!密码会以明文的形式被保存。
-
在 Connection Properties 页签,可以配置其他属性。建议配置如下属性,以免中文字符无法显示等其他问题出现:
property value useUnicode true characterEncoding utf-8 zeroDateTimeBehavior convertToNull transformedBitIsBoolean true
-
点击 Test,测试链接情况。
成功,则点击 OK。
点击 Finish,完成适配器的创建。
Database JDBC Connection 故障诊断
ClassNotFoundError
在测试连接时出现这个问题,一般是 classpath 中不存在所需的 JDBC 驱动。可以通过向 Jaspersoft Studio classpath 中添加相关的 jar 资源来解决:
- 单击 Project > Properties > Java Build Path > Libraries,然后单击 Add JARs 或 Add External JARs。
- 浏览到要添加的 jar 的路径。
- 选取你要添加到 classpath 的文件。
- 单击 OK。
以这种方式添加的资源,是对所有数据适配器来说都可用的。