How-To: 用 Pentaho SDK 进行开发
July 14, 2006
For the latest information, please visit our web site at www.pentaho.org
pentaho-preconfiguredinstall 文件夹.... 6
学习工具：在 Standalone 平台项目中调试.... 8
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 产品信息 | |
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 是公开可访问的 | |
Developer Zone 这个网站提供了最新的信息， 论坛， F.A.Q.s (一些不是那么常见的问题)，以及额外的设计文档。 | 点击 ‘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-{latestdate-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”，如何配置插件。
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 文件夹有一个简单的 solution，平台库和依赖，不使用 J2EE 应用服务器，独立运行平台的 Java 应用的代码。
pentaho-data 文件夹
pentaho-data 文件夹有 HSQLDB 文件，其为我们的 demo 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 文件夹作为根目录。
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/755847/viewspace-998730/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/755847/viewspace-998730/
141
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
