Pentaho技术白皮书中文版（七）--How-To: 用 Pentaho SDK 进行开发

Pentaho BI Platform SDK 是一个包，其包含：

Ø         Pentaho BI Platform 源码

Ø         一个 sample solution

Ø         一个 standalone Eclipse 项目实例

Ø         sample 数据

Ø         一个为运行平台专门定制的 JBoss 应用服务器

这个包的目的是使得开发人员有一组可放进 IDE 的文件，相对简单的开始编译和逐步运行 Pentaho 源码。我们已经以其他各种格式发布了这个包中的内容，但为响应我们社团的需求，将之放进了这个一站式开发人员工具包中。我们的目标就是使得我们的社团更容易的扩展平台满足他们的需求，而不必花费很大的精力来入门。

这个 SDK (和相关文档) 并不讨论 Pentaho Design Suite，或是 Report Designer。我们的目标是立刻为那些项目提供额外的 how-to’s 帮助。

我们选择的 IDE 是 Eclipse。这篇文档的余下部分介绍了在 Eclipse 中设置 SDK 的指令，但项目结构在其他环境中也应该正常运行。如果你有在另一个 IDE 中为 Pentaho 进行开发的相关信息，我们很欢迎你提供给我们，以添加进这个文档中。

目标读者

SDK 和这篇文档主要用于软件开发者。我们假设读者已经很熟悉 Eclipse 平台和 Java 开发。

我们将逐步介绍平台的两个不同的配置安装：为一个 J2EE 应用开发，以及为一个不需要应用服务器的“stand-alone” Java 应用开发。如果目标就是将平台部署为一个 J2EE 应用， 我们假设读者有 J2EE 和应用服务器的相关经验。此处，我们使用 JBoss 应用服务器进行演示。

然而不是很重要的一点是：如果读者有一点 Apache Ant 的知识，将会更好。

其他资源

除了这篇文档，还有以下可用的下载，文档和资源：

资源

如何获取

Pentaho Web Site

产品信息

http://www.pentaho.org

Technical Whitepaper

这篇文档描述了 Pentaho BI 平台的体系结构，以及它为何是唯一的。

一个 PDF 下载文件

http://sourceforge. net/project/showfiles.php?group_id=140317

Advanced Installation Guide

这篇文档回答了平台安装中的问题，以及如何从源和部署信息构建平台。

一个 PDF 下载文件

http://sourceforge. net/project/showfiles.php?group_id=140317

Creating Pentaho Solutions

这篇文档对于如何构建 Pentaho solutions 提供了详细信息。

一个 PDF 下载文件

http://sourceforge. net/project/showfiles.php?group_id=140317

Product Roadmap

我们的 development roadmap 是公开可访问的

http://www.pentaho.org/jira/roadmap.html

Developer Zone

这个网站提供了最新的信息， 论坛， F.A.Q.s (一些不是那么常见的问题)，以及额外的设计文档。

http://www.pentaho.org

点击 ‘Developer Zone’

 

需求和推荐

以下是你遵照这个 how-to 进行操作需要使用的工具列表。建议你在这个练习的开始就下载所有必需的包，这样你就可不间断的执行安装指令。

Ø         Eclipse 平台 IDE。我们的研发队伍目前使用 3.1.X 下的各种版本。你可从以下网址下载 Eclipse IDE： http://www.eclipse.org/downloads/index.php

Ø         一个 Java SDK。Pentaho BI 平台在 Java SDK 1.4 上构建和测试，可在 http://java.sun.com/j2se/corejava/index.jsp 下载各种平台上的 JDK，注意你需要完整的 SDK，而不仅仅是runtime (JRE)。

Ø         Pentaho SDK。你应该和这篇文档一起使用的包是 pentaho-sdk-{latest­date-time}.zip，可在此处下载： http://www.pentaho.org/download/latest.html

Ø         如果你想运行练习“Debugging in JBoss Application Server”，你需确保你的计算机上的 8080 端口没被另一个应用占用。这是 SDK 中 JBoss 应用服务器使用的默认端口。虽然你也可改变 SDK 使用的端口，但你不必在这一点上使得问题复杂化。如果端口 8080 被占用了，我们建议当你运行 SDK 的应用服务器时，临时关闭使用 8080 端口的应用。

Eclipse 入门

那么让我们开始。

目前你需要已经安装了 Eclipse。如果你还没有下载 Eclipse，从上述的 URL 中下载。如果你已经安装了 Eclipse，想使用你当前的安装和 workspace，那么你可跳过这一步，直接进入下一节，JBoss IDE 入门。

一旦你下载了 Eclipse，简单的将内容从包中解压到你的计算机上你喜欢的位置上。你应该看到一个类似下图的目录结构：

图 1. Eclipse 项目结构

为启动 Eclipse，执行 eclipse.exe 程序(或你的 *nix 平台上类似的可执行程序)。

你将被提示选择一个目录，作为你的 workspace。Eclipse workspace 是你的计算机上定义的一个文件夹，你的所有 Eclipse 项目文件，源代码和首选项均存放在那里。在 Eclipse 中的对话框中指定你想用作你的 workspace 的文件夹。

图 2. 选择一个 Eclipse workspace 文件夹

JBoss IDE 入门

如果你想运行练习“Debugging in JBoss Application Server”，那么你需为 Eclipse 安装 JBoss IDE 插件。Eclipse 的 JBoss IDE 插件是一个工具，其允许你逐步调试作为一个 JBoss 应用服务器中的web 应用的一部分运行的 Java 类。

安装 JBoss IDE 插件的指令可在这里找到： http://docs.jboss.com/jbosside/install/build/en/html/installation.html。如安装指令所述，这个插件是通过 Eclipse Update Manager 获取到的。Eclipse Update Manager 允许你直接从 Eclipse 平台安装和更新 Eclipse 插件。

图 3. Eclipse Update Manager

一旦你成功安装了 JBoss IDE 插件，请进入下一节。我们将描述为调试练习“Debugging in JBoss Application Server”，如何配置插件。

Pentaho BI Platform SDK

unpack Pentaho SDK into your Eclipse workspace folder now.

SDK 包包含了所有的文件和项目设置，使得你可在 Eclipse 中运行。文件被打包，这样你可将他们直接解压缩到你的 Eclipse workspace。

使用你最喜欢的 archive 工具(如 7-Zip，WinZip)，将 Pentaho SDK 解压进你的 Eclipse workspace 文件夹。

以下是一旦你解压了SDK，你应该在你的 workspace 文件夹中看到的内容的截图：

图 4. Eclipse workspace 文件夹中的 Pentaho SDK 文件

pentaho 文件夹

pentaho 文件夹有 Pentaho BI 平台的源码，资源和项目设置。这是你将浏览和逐步了解平台代码和体系结构的项目。

pentaho-standalone 文件夹

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

pentaho-data 文件夹

pentaho-data 文件夹有 HSQLDB 文件，其为我们的 demo solutions 组成了默认数据库，以及启动和关闭数据库的脚本。

pentaho-solutions 文件夹

pentaho-solutions 文件夹包含所有 xml 文件，xaction 文件和组成 Pentaho demo solutions 的其他资源。

pentaho-preconfiguredinstall 文件夹

preconfigured-install 文件夹中有一个完整的 JBoss 应用服务器，为运行 Pentaho BI 平台代码进行了调整和配置。

如上述，pentaho 文件夹包含 Pentaho BI 平台的源码。其他 3 个文件夹(除了 pentaho-standalone 文件夹) 是运行平台必需的支撑文件夹。这里的思路是使得作为开发人员的你能查看我们如何构建我们的 demo 应用，其应该为你提供足够的知识，然后为你自己的 solutions 修改这些文件，或在你自己的框架中使用平台 SDK(例如，Struts，JFaces，HTML，Java 应用等)。

在 Eclipse 中设置 SDK

既然你的计算机上已经有了源码，你需要告诉 Eclipse：在 Eclipse 透视图中有你想看到的定义好的项目。

Pentaho 平台被安装为5个单独的 Eclipse 项目。你不必将 5 个文件夹均设置为 Eclipse 项目，但如能看到 Eclipse 视图和透视图中的所有文件，确实有用。我们将预排所有项目的设置。

导入 Pentaho 项目

Pentaho，pentaho-data，pentaho-standalone，pentaho-solutions 和 pentaho-preconfiguredinstall 文件夹中均有 .project 文件，这些是 Eclipse 用来将这些文件夹配置为项目所用的文件。这些文件夹可作为项目导入进 Eclipse。

1.         启动 Eclipse，打开 Java 透视图

2.         从 File 菜单，选择 ‘Import...’ 选项

3.         从 Import 对话框，选择 ‘Existing Projects Into Workspace’ 选项

4.         将出现一个 Import Projects 提示对话框，其询问你想从那个目录导入文件。选择 ‘Select Root Directory’ 选项，并指定你的 workspace 文件夹作为根目录。

图 5. Eclipse 中的 Import Project 对话框

5.你将看到已经为导入选择了 Pentaho 文件夹。选择窗口底部的 Finish 按钮。

现在你将在 Eclipse中看到所有的 Pentaho 项目。

图 6. Eclipse 中的 Pentaho 项目

Eclipse 有几种不同类型的项目。Pentaho 利用了两种不同的 Eclipse 项目：simple 项目和 Java 项目。

pentaho-data，pentaho-solutions 和 pentaho-preconfiguredinstall 项目都是 Eclipse simple 项目。这意味着那些项目有大部分基本的 Eclipse 项目配置和能力，其和文件浏览一样。

pentaho 项目是一个 Eclipse Java 项目。这个项目是不同的，因为如前所述，这是唯一一个包含了需要编译的源码的项目。因为将之定义为一个 Java 项目，pentaho 项目有和 Java 相关的配置选项和功能。

你会立即注意到(如果你激活了“Build Automatically”)在导入时，就编译了 pentaho 项目。可能会有几个警告，但没有编译错误。耐心点，这可能需要持续一分钟，取决于你的计算机的速度。pentahostandalone 项目也是一个 Java 项目。它不会自动编译，因为在项目运行前，有一些必需的设置步骤。详细信息参考下一节。

如果项目没有在导入时进行自动编译，现在使用 Project 菜单手动编译。从左边的视图中选择 pentaho 项目，然后从 Project 菜单，选择 ‘Build Project’ 选项。

如果你此时碰到了编译错误，我们可提供帮助！将 Eclipse 报出的编译错误提交到我们的论坛，位于http://www.pentaho.org/discussion。论坛里的很多成员和 Pentaho 开发人员都可以提供帮助！

学习工具：在 Standalone 平台项目中调试

Standalone 项目，pentaho-standalone，包含在 Pentaho BI 平台 SDK 中以提供一个实例应用，其利用没有 J2EE 应用服务器的平台的能力。项目包含一个 Java 应用，其运行两个 action sequences，将每个的结果写进一个文件。

在这个学习工具中，我们将经过以下步骤：

1.         设置 standalone 项目；

2.         解释使得 standalone 配置运行起来的代码和资源；

3.         最后，在 sample 代码中设置一个断点，演示 standalone 应用的调试。

Standalone 项目设置

Standalone 项目依赖于 pentaho 项目。为开始使用 Standalone 项目，你必须首先运行一个 Ant target，sample-setup，它将为我们的实例生成适当的库。

为设置 Standalone 项目：

1.         从 Eclipse 中的 Java 透视图，选择 build.xml 文件，其位于 pentaho­standalone 项目的根目录。对于这个，我喜欢使用 Navigator 视图(默认不可见)，但有另几个使文件选择变得容易的视图– 使用你最喜欢的那个。

2.         右击 build.xml 文件，选择 ‘Run As...’ 选项，然后选择 ‘Ant Build...’ 选项。

3.         会出现一个 Ant Build 提示对话框。取消选择任何预先选择的 targets，仅选择sample-setup target。

图 7. Ant Build 对话框.

4.         选择对话框底部的 ‘Run’ 按钮。你将在 Eclipse 中的 Console 视图看到脚本的 activity 日志。一旦完成 target，你将看到消息“Build SUCCESSFUL”。

5.         在 Eclipse Navigator 视图中，选择 pentaho-standalone 项目的根文件夹。右击文件夹，选择 ‘Refresh’选项。这将刷新子文件夹，这样你可看见作为构建项目的结果添加的文件。

6.         下一步，让我们移除对 pentaho 项目的依赖性。右击 pentaho-standalone 项目，点击属性，出现 pentaho-standalone 的 Properties 对话框。

7.         在对话框的左边，选择 Java Build Path，选择 Projects 标签页，点击 remove 按钮。注意这样就从列表中删除了 pentaho。

8.         下一步点击 Libraries 标签页，点击 Add Jars 按钮，出现 Jar Selection 对话框。

9.         选择 pentaho-standalone，确保将每个 jar 添加进 lib 目录。

项目现在应该准备好逐步调试了，但让我们首先解释组成项目的文件。

Standalone 项目的代码和资源

你该看到类似于下图所示的 pentaho-standalone 项目的文件结构。我们以最少量必需的资源(文件和源码)构建了 standalone 项目，因此你可了解运行 standalone 平台的最低要求。

图 8. stand-alone 项目文件结构

lib 目录

lib 目录有运行 pentaho-standalone Java 应用所必需的所有依赖库。

库被放进了不同的子目录，以澄清为何包含每个库。Components 目录下的库主要用于组件功能。core 目录下是运行平台所必需的库。datasource 目录下是 HSQLDB driver 库，当然 pentaho-<version>.jar 是平台自身。

resource/solution 目录

resource/solution 目录下是我们的实例的 solution 文件。这些文件很类似于我们的 demo 中包含的那些。在我们的 solution 中有两个 action sequences，‘Hello World’ 和 ‘Simple Report’。如果你浏览 resource/solution 目录，你将看到 action sequences 的文件。

源文件

src 目录下是以 standalone Java 应用执行平台的源码。

org.pentaho.app.SimpleCase.java 类是运行平台，以及最后运行 solution 的一个主类。这个类初始化平台，运行一个很简单的 ‘Hello World’ action sequence，然后运行一个很简单的 JFreeReport action sequence。为了简化，两个 action sequences 均生成写进文件中的结果。

public static void main(String[] args) { try {

Init.initialize() ;

SimpleCase sCase = new SimpleCase();sCase.simpleCase( args );

} catch (Exception e) {e.printStackTrace();}

}

...

public void simpleHelloWorldCase( String outputPath ) {

try {

File f = new File( outputPath + File.separator + "hello _world.txt" );

FileOutputStream outputStream = new FileOutputStream(f);

HashMap parameters = new HashMap();

ISolutionEngine solutionEngine = SolutionHelper.execute( "Simple Case Example", "Hello World",

"getting-started/HelloWorld.xaction", parameters, outputStream );

} catch (Exception e) {e.printStackTrace();}

org.pentaho.app.Init.java 类仅有一个有趣的方法–初始化平台的方法：

public static boolean initialize() { try {

// We need to be able to locate solution files. in this example, we are using the relative path in our project/package.

File solutionRoot = new File( "resource/solution" );

// Create a standalone application context - our application toolbox if you will - passing the path to the solution files.

IApplicationContext context = new StandaloneApplicationContext(solutionRoot.getAbsolutePath(),

new File(".").getAbsolutePath() );

// Initialize the Pentaho system PentahoSystem.init( context ); return true;

} catch (Throwable t) {

t.printStackTrace();return false;

}

}

逐步运行 Sample 代码

你应该很熟悉如何在 Eclipse 中逐步运行代码，但我们仍然在此提供了一个实例。当你在 Eclipse 中运行 SimpleCase 类之前，你必须首先启动 demo 数据库。

为启动数据库：

1.         通过命令行或使用你最喜欢的文件浏览工具（在Eclipse 之外）浏览至 pentaho-data 文件夹。

2.         在 pentaho-data/demo-data 文件夹下，有 Windows OS 和 *nix 平台的启动和关闭脚本。执行适合于你的计算机的启动脚本(.bat 文件用于 Windows，.sh 文件用于 *nix)。

现在设置一个断点，并执行 SimpleCase main() 方法，这样你可看到正在进行的开发过程。

1.         先切换到 Eclipse Debug 透视图，如果你还没有的话。

2.         从 Eclipse 的很多文件浏览视图中的一个(我使用 Navigator)，在 pentaho­standalone 项目中浏览到 src/org/pentaho/app/SimpleCase.java，并打开那个文件。

3.         在 SimpleCase.java 文件的 73 行设置一个断点(从右键菜单)。(注意：当代码改变时，这个行号也很可能改变。我们设置断点的代码行就是包含 Init.initialize() 代码的那行)。

4.         右击你的文件浏览视图中的 SimpleCase.java 文件。选择 ‘Debug As...’ 选项，然后选择 ‘Java Application’ 选项。这将以一个 Java 应用启动类。

图 9. 在 Eclipse 中设置一个断点

5.         程序将在你的断点处停止执行。在此处，你可在 Eclipse 中 step into，step over 或继续执行。额外的调试信息请查看 Console 视图。

学习工具：在 JBoss 应用服务器中调试

现在你准备使用 pentaho-preconfiguredinstall 项目（一个JBoss 应用服务器）部署和调试平台。

这个学习工具包含以下练习：

1.       首先我们将逐个介绍对你来说，将平台 Java 代码和 web 应用文件从 pentaho 项目部署进 pentaho-preconfiguredinstall 项目可用的工具。

2.       下一步就是在 JBoss IDE 中配置一个服务器。我们将采用这个步骤，运行将平台部署为一个 web 应用的 JBoss 应用服务器。

3.       最后，在平台 Java 代码上设置一个断点，运行 ‘Hello World’ sample solution，从那个断点逐步运行代码。

部署和更新 Platform Web 应用

pentaho 项目和 pentaho-preconfiguredinstall 项目用于开发目的。这些项目的意义是：提供简单的方式获得编写为平台的一部分的代码(在 pentaho 项目中)，并将之作为部署在 JBoss 服务器(pentaho-reconfiguredinstall 项目)上的 web 应用的一部分，放进正确的结构中。

在 pentaho 项目的 build.xml 文件中定义了两个 Ant 任务，其调节这个开发过程：他们是 dev-setup 和 dev-update targets。

dev-setup Target

dev-setup target 是一个 Ant 脚本，其执行以下服务：

Ø         编译 src 文件夹下的平台源码。

Ø         构建一个 JBoss 4.0.3-compliant war 文件。如果你不熟悉 war 文件，参考 Sun 的关于 J2EE 和 web 应用 archives 的文档。

Ø         将 HSQLDB 库文件复制进 pentaho-data 项目(以后详细介绍)。

Ø         将平台 war 文件部署进 pentaho-preconfiguredinstall 项目。

Ø         将 pentaho-style war 文件部署进 pentaho-preconfiguredinstall 项目。这个 war 文件包含 demo web 应用的所有 style 资源。

Ø         将 pentaho-portal-layout war 文件部署进 pentaho-preconfiguredinstall 项目。这个 war 文件包含 demo web 应用的 portal 部分的所有 portal layout 资源。

Ø         部署 JBoss 应用服务器必需的数据定义 xml 文件，以识别 pentaho-data 项目中的 HSQLDB 数据库。

应该在你首次设置 Pentaho 项目时运行 dev-setup target。它用平台 web 应用完整组装 preconfigured-install。

为运行 dev-setup target：

1.       从 Eclipse 的 Java 透视图，选择文件 build.xml，其位于 pentaho 项目的根目录。对此，我喜欢使用 Navigator 视图(默认不可见)，但有另几个视图使得文件选择更容易 – 使用你最喜欢的那个。

2.       右击 build.xml 文件，选择 ‘Run As...’ 选项，然后选择 ‘Ant Build...’ 选项。确保你选择选项 with ellipses on end！‘Ant Build’ 选项构建 DEFAULT target，其可能不是 dev-setup target。

3.       将出现一个 Ant Build 提示对话框。取消选择任何预选择的 targets，并仅选择 dev-setup target。

图 10. Ant Build 对话框.

4.       选择对话框底部的 ‘Run’ 按钮。你应该在 Eclipse 的 Console 视图看到脚本的 activity 日志。一旦完成 target，你将看到消息 “Build SUCCESSFUL”。pentaho-preconfiguredinstall 项目现在已经被组装了 Pentaho 平台 web 应用。

dev-update Target

dev-update target 是一个脚本，其将更新 pentaho­preconfiguredinstall 项目中的平台 web 应用中任何你修改过的文件。因此，例如，如果你添加或修改了 pentaho 项目中的任何 .java 文件，dev-update target 将为你执行以下服务：

Ø         将任何新的或修改过的 java 类复制进 pentaho­preconfiguredinstall 项目中的适当目录。

Ø         将任何新的或修改过的 jsps 复制进 pentaho-preconfiguredinstall 项目中的适当目录。

Ø         将任何新的或修改过的 xml datasource 定义复制进 pentaho­preconfigured-install 项目中的适当目录。

Ø         修改 pentaho web 应用中的 web.xml 文件，其导致 JBoss 服务器自动重载 web 应用，并立即获得修改。

当你修改了源码，并想在 JBoss 应用服务器上测试这些修改时，运行这个 target。

你可利用以上为 dev-setup target 列出的指令运行 dev-update target，但当然要选择 dev-update target。

配置 JBoss IDE 服务器

既然你已经将 pentaho web 应用复制进 pentaho-preconfiguredinstall 项目，是时候启动 JBoss 应用服务器，并确保一切正常运行了。

JBoss IDE 是一个很好的工具。它易于配置，一旦完成配置，你所需做的就是通过 IDE 启动服务器，这样你就能调试 Java 代码。

为在 JBoss IDE 中配置一个新的服务器：

1.       切换到 Eclipse Debug 透视图

2.       从 Window 菜单，选择 ‘Show View’ 选项，然后选择 ‘Other...’ 选项。

3.       会出现一个具有指定 views 的提示对话框。选择 ‘JBoss IDE’ 选项，然后选择 ‘Server Navigator’ 视图。

图 11. 选择 JBoss IDE Server Navigator 视图

4.       选择 OK 按钮来完成。你应该看到 Server Navigator 视图出现在 Eclipse Debug 透视图的底部。

图 12. Eclipse Debug 透视图中的 Server Navigator 视图

5.       右击 Server Navigator 窗口 pane。选择 ‘Configuration...’选项。

6.       将会出现一个 Configuration 提示对话框。在左边的 pane 中，选择 ‘JBoss 4.0.x’ 选项，然后选择 left pane 下的 New 按钮。你应该一个类似于下图的对话框。

图 13. JBoss Server 配置对话框

7.       输入 ‘pentaho-server’ 作为你的新配置的名字。

8.       选择 ‘Browse...’ 按钮，浏览至 pentaho-reconfiguredinstall 文件夹。将这个文件夹设置为 JBoss 4.0.x Home 目录。

9.       选择 ‘default’ 作为服务器配置。

10.   选择 ‘Apply’ 按钮保存这个配置。

11.   切换到对话框中的 ‘Source’ 标签页。

12.   从下一个对话框中选择 ‘Add’ 按钮，然后选择 ‘Java Project’，从最后一个对话框中选择‘pentaho’，选择 OK。

图 14. 将源码连接到 JBoss Server 配置

13.   选择 ‘Apply’ 按钮保存这个配置。

14.   选择 ‘Close’ 按钮关闭对话框。

你现在应该看到 ‘pentaho-server’ 列在你的 Server Navigator 视图中。通过右击 Server Navigator 视图中的 pentaho-server 条目，你可启动和停止 pentaho-server。

注意!!! 在你启动 pentaho-server 前，为正确运行 demo，你必须首先启动数据库。启动数据库的指令请查看下一节。

逐步运行 ‘Hello World’

剩下的要做的就是启动平台，设置断点，监测其运行。

最后一步要注意的是，当你在 Eclipse 中试图启动 pentaho-server 之前，你必须首先启动 demo 数据库。

为启动数据库：

1.         通过命令行，或使用你喜欢的文件浏览工具（Eclipse之外）浏览至 pentaho-data 文件夹。

2.         在 pentaho-data/demo-data 文件夹下，有 Windows OS 和 *nix 平台下的启动和关闭脚本。执行适合你的计算机的启动脚本(.bat 文件用于 Windows，.sh 文件用于 *nix)。

现在启动 pentaho-server：

1.       从 Eclipse Debug 透视图的 Server Navigator 视图，右击 pentaho-server 条目。

2.       选择 ‘Start’ 选项。

在 Console 视图中上下滚动，你将看到很多启动消息和警告。只要启动时最后一条消息是 “Pentaho BI Platform server is ready.”，那么你就知道平台已经启动了，并运行成功。

现在设置一个断点，并执行 ‘Hello World’ demo solution，这样你可看到进行中的开发过程。

1.         切换到 Eclipse Debug 透视图，如果你还没在那里的话。

2.         从 Eclipse 的众多文件浏览视图之一(我使用 Navigator)，在 pentaho 项目中浏览至server/pentaho/src/org/pentaho/core/runtime/RuntimeContext.java，并打开那个文件。

3.         在文件 RuntimeContext.java 的 878 行设置一个断点(从右键菜单)(注意：因为代码的改变，这个行号很可能已经改变了。我们设置断点的代码行是包含 executeComponent() 代码的那行)。

图 15. 在 Eclipse 中设置一个断点

4.         下一步，打开一个 web 浏览器窗口，浏览至http://localhost:8080/pentaho/ViewAction?&solution=samples&path=getting-started&action=HelloWorld.xaction.

5.         你在 Eclipse 中的断点应该在组件执行结果从服务器发送回浏览器之前被点击。此处，你可在 Eclipse 中 step into，step over 或继续执行。额外的调试信息请查看 Console 视图。