pentaho超级文档1201V10Session.docx

pentaho超级文档1201V10Session.docx

《pentaho超级文档1201V10Session.docx》由会员分享，可在线阅读，更多相关《pentaho超级文档1201V10Session.docx（74页珍藏版）》请在冰豆网上搜索。

pentaho超级文档1201V10Session

用 Eclipse 构建和调试 Pentaho

ThispagelastchangedonNov30,2006by bhagan.

这篇文档的目的是教会开发人员如何开始进行 Pentaho 的开发。

这篇文档解释了如何在 Eclipse 中设置一个开发环境，包括如何连接到 PentahoSubversionrepository，检出 Pentaho 项目，使用一个 '1stand-alone'1 Java 应用和EclipseJBossIDE 来构建调试它们。

这篇文档也解释了 Pentahorepository 结构和对于开发Pentaho 来说，许多很重要的 buildtargets。

目标读者是软件开发人员。

我们假设读者已经很熟悉 Eclipse 平台和 Java 开发。

如果目的是将平台配置为一个 J2EE 应用，我们假设读者了解 J2EE 和应用服务器。

我们此处就是使用 JBoss 应用服务器进行演示。

虽然不是很重要，但如果读者有使用 ApacheAnt 的经验也会很有用处。

如果你仔细阅读了这个指南中的说明，但仍没有解决你的问题，请到论坛寻找答案：

 http:

//forums.pentaho.org/.

01. 设置你的环境

ThispagelastchangedonApr03,2007by dkincade.

以下是开始研究 Pentaho，你需要使用的工具列表。

推荐你现在就下载所有必需的包，这样你就可不间断的进行试用。

1.       一个 JavaSDK：

PentahoBIPlatform 在 JavaSDK1.4 上构建和测试。

注意你需要完整的 SDK，而不仅仅是 runtime（JRE）。

2.       Ant：

基于 Java 的构建工具。

3.       Eclipse：

平台 IDE。

4.       Subclipse：

一个 Eclipse 插件，其在 EclipseIDE 上添加了 Subversion 集成。

5.       JBossIDEforEclipse。

为开始设置：

1.  下载和安装你的 JavaSDK。

2.  下载和安装 Ant。

3.  下载和安装 Eclipse。

4.  下载和安装 Subclipse。

5.  下载和安装 JBossIDEforEclipse。

以后章节是关于 Pentaho 团队使用的这些工具的版本说明，以及使环境适合于 Pentaho 平台 codeline 开发的技巧。

每个工具在其各自的下载中有详细的安装指令，这里我们不详细介绍。

JavaSDK

PentahoBIPlatform 在 JavaSDK1.4 上构建和测试。

注意你需要完整的 SDK，而不仅仅是runtime（JRE）。

在后面几步中，你会看到为了使 Ant 构建脚本正确运行，你必须指定 Java 编译器可执行程序（javac）。

这个可执行程序位于你安装的 Java SDK 的 /bin 目录下，因此记住你将 SDK 安装到了哪里。

Ant

Ant 是一个基于 Java 的构建工具，我们将之用于构建平台，以及支持用 Eclipse 进行 Pentaho 进行开发中的活动。

目前用于构建 Pentaho 的可下载的二进制的版本是 Ant1.6.5。

建议使用 Ant 工具从命令行构建一些 PentahoAnttargets（在某些环境下是必要的）。

EclipseIDE 中自带了 Ant 的一个版本。

这个版本被 IDE 用于构建功能，为了作为 Eclipse 的插件可能也进行了一些修改。

为确定 EclipseIDE 中的 ant 版本，从 Eclipse 顶部的 Window 菜单浏览至Preferences...|Ant|Runtime，在插件的路径中检查其版本。

EclipseIDE

只是最近在设置你的 Pentaho 开发环境时，才需要有一个 Eclipse，但与 Pentaho 的代码没啥关系。

如果你想在 JBoss 应用服务器中运行和调试代码，你需要 JBossIDE（参考下面），那里有一些兼容性问题（IDE 的最新版本在Eclipse 的最新版本上好像有些问题）。

Pentaho 团队使用的是以下版本，这些配置是没问题的：

1.       从 JBoss 网站下载带有最新 JBossIDE 插件的 Eclipse – 带有 JBossIDEversion2.0.0beta2 的EclipseIDE 版本 3.2.1. 或

2.       从 Eclipse 网站下载 Eclipse3.2.1M20060921-0945；然后从 JBoss 下载和安装 JBoss IDE 插件版本 2.0.0beta2。

Subclipse

Subclipse 是 Eclipse 的一个插件，在 Eclipse 环境上激活 Subversion 功能。

Subversion 是大多数 Pentaho 项目使用的源代码控制库。

Subclipse 利用了 EclipseUpdateManager，其允许你用一个 URL 进行注册，在 EclipseIDE 上自动获取和安装插件。

和我们的配置兼容的 Subclipse 版本是 Subclipse1.2.x。

你可在 Tigris.org 网站找到详细的安装指令，或按照以下简短的指令：

在 Eclipse 中，选择菜单条 Help|SoftwareUpdates|FindandInstall...

1.       在向导的第一步中，选中 "Searchfornewfeaturestoinstall"，点击 "next" 按钮。

2.       在下一步中，点击按钮 "NewRemoteSite..."。

3.       在弹出式窗口中，输入你选择的站点名，输入以下url：

http:

//subclipse.tigris.org/update 1.2.x，点击 "OK" 按钮。

4.    在下一步中，你应该看到一个可从中选择的功能列表，选择适合于你的 Eclipse 版本的 "Subclipseplugin"。

5. 允许插件安装完成。

使用 Subclipse的详细命令，请到 Eclipse Help 菜单，选择 HelpContents，然后在内容表中浏览 Subclipse 树。

JBossIDE

如果你想在 JBoss 应用服务器中调试，那么你需要安装 Eclipse 的 JBossIDE 插件。

如果你下载了打包的 Eclipse\JBossIDE 包，这样你就不需要安装 JBossIDE 插件 – 你已经有了。

Eclipse 的 JBossIDE 插件是一个工具，允许你一步步的调试在一个 JBoss 应用服务器中作为一个 web 应用的一部分运行的 Java 类。

JBossIDE 插件通常通过 EclipseUpdateManager 获取。

然而，在这篇文档写作时，JBossIDE 版本2.0.0beta2 并没有安装命令，文档或到 UpdateManager 的链接。

That'swhatwegetforusingadevelopmentbuild。

这并不是一个问题，它很简单，我们会尽力描述。

从此处获取 JBoss 插件：

1.       下载插件，JBossIDE-2.0.0.Beta2-ALL.zip （不是 plugin\Eclipse 包!

）。

2.       将包解压进你的 eclipse 安装目录 – 不是 zip 文件中 /eclipse 开头的那个目录结构。

3.  启动\重启 Eclipse。

一旦你成功安装了 JBossIDE 插件，继续到下一节。

在 "DebugginginJBossApplicationServer" 这个练习中，我们会介绍如何配置插件用于调试。

02. 探索 PentahoRepository

ThispagelastchangedonNov30,2006by bhagan.

PentahoBIPlatform 代码位于 Subversionrepository 中的 svn:

//source.pentaho.org/。

如果你没有使用Subversion 的经验，不要怕 – 这里有本在线电子书：

http:

//svnbook.red-.

Subversion 中的 Pentaho 项目是：

●        pentaho– 主要的 Pentaho 源代码树

●        pentaho-cubedesigner– 用于连接到关系数据源的，向导驱动的图形用户界面的源代码，定义了 analyticaldimensions，确定了用于分析的 measures 或 "facts"。

●        pentaho-data– 默认 sample 数据库

●        pentaho-designstudio- 用于构建和测试 ActionSequencedocuments 的图形 eclipse 环境的源代码。

●        pentaho-designstudioIDE– 本质上是带有 build 文件的 eclipse，其将安装 pentaho action-sequence-plugin 和 splashscreen。

●        pentaho-preconfiguredinstall- 预配置的 Jboss 应用服务器的源代码。

●        pentaho-reportdesigner- 创建 JFreeReports 的 standalonedesigner 的源代码。

●        pentaho-reportwizard- 创建 JFreeReports 的 standalone 向导的源代码。

●        pentaho-solutions-samplesolutions。

●        pentaho-standalone- 单独运行平台的 Java 应用的代码，没有一个 J2EE 应用服务器。

我们一直致力于保持简单健全的项目结构和开发团队。

下面会描述这篇文档中将要探讨的项目的描述：

●        pentaho

●        pentaho-data

●        pentaho-solutions

●        pentaho-preconfiguredinstall

●        pentaho-standalone

在这篇文档里，我们不会讨论 Pentaho 客户端工具：

●        pentaho-cubedesigner

●        pentaho-designstudio

●        pentaho-designstudioIDE

●        pentaho-reportdesigner

●        pentaho-reportwizard

pentaho 项目

pentaho 项目有源代码，资源和 PentahoBI 平台的项目设置。

在这个项目里，你可浏览平台代码和体系结构。

目录/文件

描述

/pentaho

源代码树的根目录。

/cobertura

包含库，用于确定单元测试应该覆盖代码中的多少百分比。

/scripts

包含用于构建 PreconfiguredInstall 时使用的 startup 脚本。

/server

服务器代码的 Sourcetree。

/third-party

包含 lib 目录，包含编译和构建所需的所有第三方库。

.classpath

设置项目 classpath 的 Eclipse 文件。

.project

描述项目的 Eclipse 文件。

build.xml

用于 Pentaho 项目的 Antbuild 文件。

default.properties

用于构建 Pentaho 项目的属性，通过在相同的目录中，创建一个override.properties 文件，并在其中增加你想覆盖的那些属性的方法来覆盖这个文件中的属性。

deployment_build.properties

deployment_build.xml 所用的属性文件。

deployment_build.xml

Build 文件，其包含用于构建 appserverspecificdeliverables 的 targets。

它被build.xml 使用，作为 j2eedeployments 的一部分。

excludejars.generic

文本文件，列出了那些不应该被包含在 .war 文件中的 jars，其在 build 文件中用于tomcat-wartarget。

excludejars.jboss

文本文件，列出了那些不应该被包含在 .war 文件中的 jars，其在 build 文件中jboss-wartarget。

pentaho-data 项目

PentahoBIPlatform 带有一套默认数据库（使用 HypersonicSQL） 来容纳几个功能组件和子系统所必需的 repositories。

为了使得平台的这些 parts 能运行，你需要这些 repositories。

这个数据存在于模块'pentaho-data'。

Pentaho-data 也包含数据库的启动和关闭脚本。

目录/文件

描述

/pentaho-data

数据库树的根目录。

/hibernate

包含用于 HypersonicSQL 的平台 repository 脚本。

/quartz

包含用于 HypersonicSQL 的  Quartzscheduler 脚本。

/sampledata

包含用于 HypersonicSQL 的 sample 数据脚本。

/shark

包含用于 Hypersonic SQL 的 Shark 工作流脚本。

start_hypersonic.bat

Windows 平台的启动批处理文件，用于启动 Windows 上的数据库。

start-hypersonic.sh

*nix 平台上的启动批处理文件，用于启动 *nix 上的数据库。

stop_hypersonic.bat

Windows 平台上的关闭批处理文件，用于关闭 Windows 上的数据库。

stop-hypersonic.sh

*nix 平台上的关闭批处理文件，用于关闭 *nix 上的数据库。

重要：

'pentaho-data' 模块是一个 standalone 组件，其充当一个数据库服务器。

项目中提供的脚本用于启动和关闭Hypersonic 数据库。

脚本依赖于 Hypersonicjdbc 类，其位于 'pentaho-data 目录中的一个 /lib 目录中。

因此为了使得这些脚本正确运行，你需要将 Hypersonicdriverjar 放在脚本需要的位置，如下所示：

1.    在 'pentaho-data' 目录中创建一个名为 lib 的目录。

2.    将 Hypersonicjdbcdriver.jar 文件 （hsqldb.jar） 复制到 lib 目录。

建议你从 'pentaho'项目的 third-party/lib 目录中获取这个文件，因为那个版本比较可靠。

pentaho-preconfiguredinstall 项目

preconfigured-install 项目包含一个完整的 JBoss 应用服务器，配置并调优来运行 PentahoBI 平台代码。

JBoss 应用服务器目录结构的详细信息请参考 JBossWiki。

pentaho-solutions 项目

如果你的目标是将平台设置为一个 web 应用，或仅仅作为你自己的 solutions 的起点，你需要从 Subversion 获取最新的 samples。

设置 samples 是一个相对小的练习，提供了一个很好的方式来测试你的配置中的各种组件。

samples 位于名为 '1pentaho-solutions'1 的项目中。

pentaho-solutions 项目包含一套samples，其演示了平台的几种组件功能，还包括一套 clean 配置文件。

为运行 samples，你也需要下载默认的 Hypersonic 数据库。

获取数据库的详细命令请参考上一节。

目录/文件

描述

/pentaho-solutions

solutiontree 的根目录。

/admin

administrativesamples 的根目录。

/samples

samplesolution 的根目录。

/system

系统目录，其包含所有平台和组件配置信息。

/test

testsolution 的根目录。

重要：

将 samples 下载到一个目录，其是你的应用服务器的根目录的兄弟目录。

不用进行任何配置上的修改，web应用会找到"pentaho-solutions" 目录，只要其如上所述作为 appserver 的兄弟。

pentaho-standalone 项目

pentaho-standalone 文件夹有一个简单的 solution，平台库和 dependencies，以及不使用 J2EE 应用服务器，单独运行平台的 Java 应用的代码。

目录/文件

描述

/resource

resource 目录，包含我们实例的 solution 文件。

这些文件很类似于包含在我们的 demo 中的那些。

在我们的 solution 中，有两个 actionsequences：

'HelloWorld' 和 'SimpleReport'。

如果你浏览resource/solution 目录，你会看到用于 actionsequences 的文件。

/src

src 目录包含源代码，用于以一个 standaloneJava 应用来执行平台。

/.classpath

设置项目 classpath 的 Eclipse 文件。

/.project

描述项目的 Eclipse 文件。

/build.xml

Pentaho 项目的 Antbuild 文件。

03. 创建 Repository 连接

ThispagelastchangedonMar01,2007by gmoran.

Eclipse 是 Pentaho 团队选中的 IDE，一直使用 Subclipse 作为 Subversion 插件。

插件提供了 "SVNRepositoryExploringPerspective"，你可从中创建一个连接。

为使用 Subclipse 插件创建一个连接：

1.       在 SVNRepositoryExploring 透视图中，右击，选择 New，选择 RepositoryLocation，就会出现 AddNewRepositoryLocation 对话框。

2.       在 Url 复选框中，输入 svn:

//source.pentaho.org/svnroot.

3.  点击 Finish。

现在你就有了一个到 Subversionrepository 的连接。

展开，会看到项目。

通常对于 Subversionrepositories，每个项目有 3 个子目录：

branches，tags 和 trunk。

project/trunk 目录有最新的代码，很可能是你想要检出的。

"pentaho" 项目结构的完整解释请参考02.ExploringPentahoRepositoryStructure。

04. 检出项目

ThispagelastchangedonFeb26,2007by gmoran.

Eclipse 有几种不同类型的项目，Pentaho 使用简单的项目和 Java 项目。

简单项目有最基础的 Eclipse 项目配置和能力，和文件浏览没啥差别。

Java 项目包含需要编译和配置文件的源代码，例如.classpath 文件， 其将设置源码树中的 \lib 子目录下的库文件。

pentaho-data，pentaho-solutions 和 pentaho-preconfiguredinstall 项目都是 Eclipse 简单项目。

pentaho 项目和 pentaho-standalone 项目都是EclipseJava 项目。

你从 Subversion 获取模块的推荐结构是以兄弟目录下载它们 – 这个结构使得平台能自动找到你的solutions 目录，也使得跟踪不同的模块更容易。

在检出 pentaho 项目之后，你立即会注意到（如果你激活了 "BuildAutomatically" 设置） 那个项目正在被编译。

编译过程中可能会出现警告信息，但是没有编译错误。

耐心点，这个任务会持续一分钟，依赖于你的计算机的速度。

pentaho-standalone 项目不会自动编译，因为在项目能运行前，必须先完成一些设置步骤。

为完成这篇文档中的例子，你需要检出以下项目：

●        pentaho

●        pentaho-data

●        pentaho-solutions

●        pentaho-preconfiguredinstall

●        pentaho-standalone

获取不同的 Codelines

此处，你可能想获取平台的最新代码，那就是构建好，用于我们下一次发布的 codeline，版本 1.6。

或，如果你正研究最新版本中的一个问题，你可能需要版本 1.2.x。

下两节解释了如何获取代码的 1.2 分支中的一个版本，而不是最新版本，Subversion 术语中，这称之为 "trunk"。

为获取源码，你可简单的从命令行中向 Subversion 发布一个命令，或通过你喜欢的 Subversion 客户端应用。

我们一直使用 Subclipse。

获取最新代码

在 SVNRepository 视图中，展开你的 repository 连接，之前，我们已经创建了svn:

//source.pentaho.org/svnroot.

1.       展开一个项目。

在这个实例中，我们使用 pentaho。

2.      右击 trunk。

3.       从右键菜单中，选择 Checkout...CheckoutfromSVNwizardloads。

4.       按照向导中的命令，将项目检出到你的 workspace。

将新的 Eclipse 项目命名成和 Subversion 中的项目相同的名字。

5.       为之前列出的每个项目重复这些步骤。

在你检出 pentaho 项目之后，如果它没有自动编译，从 Project 菜单中手动编译。

从左边的视图中选择pentaho 项目，然后从 Project 菜单中，选择 'BuildProject' 选项。

仅有 pentaho 项目需要被编译。

剩下的项目是简单项目，不需要编译