使用 Lotus Notes 和 Eclipse 管理和运行 Java 程序
利用EclipseIDE为LotusNotes/Domino开发Java代理。下载并安装Eclipse，然后 解使用Eclipse创建项目、调试Java、重构代理以及将代理导入DominoDesigner 何等轻松。
Java和LotusNotes/Domino 理想 开发组合。将它们组合 起，可以使Notes/Domino开发 员充分利用其常用开发环境DominoDesigner中目前可用 所 Java代码和包。
Eclipse大概 最好 集成开发环境之 ，它提供 非常丰富 特性，其中包括上下文相关操作、视图、富调试程序（richdebugger）和重构。重构可以将Java代码重新命名、移动、添加和提取到新 方法中，以减轻清除初始编码尝试 工作量，使其简洁易读，并使其成为您要向其他开发 员显示 代码。对许多开发工作来说，重构 Eclipse最好 项功能。
调试LotusNotes/Domino7中 Java代理 能力，现 就可以协调LotusNotes/Domino和Eclipse，为Notes/Domino应用程序创建设计优良 可调试Java代理项目。
进行任何LotusWorkplace开发都需要确实 解Eclipse 如何工作 。LotusNotes/Domino7提供 个现 开始学习Eclipse 极好理由，既将它用于Notes/Domino 些操作，增加将来也可以应用于LotusWorkplace项目 技能。
本文讲述 如何安装Eclipse，如何为LotusNotes/Domino创建项目，以及如何将这个项目导入DominoJava代理中，然后调试该代理。本文还提供 调试这些代理 些技巧和可能遇到 陷阱。
安装EclipseWebSphereStudioApplicationDeveloper 基于Eclipse ，所以如果安装 Eclipse，就可以随同本文 解如何使用WebSphereStudioApplicationDeveloper。如果没 安装Eclipse或WebSphereStudioApplicationDeveloper，那么您需要先获得这两个应用程序。Eclipse可以从Eclipse基础网站免费下载。WebSphereStudioApplicationDeveloper 试用版也能找到。
下载Eclipse或WebSphereStudioApplicationDeveloper。Eclipse很容易安装；Eclipse Web站点上 安装说明。下载 用于Windows zip文件之后，需要运行eclipse.exe文件。WebSphereStudioApplicationDeveloper比较复杂。请参考相应文档，以获得安装说明。
注意：下面 步骤讲述 Eclipse3.0。如果您安装 Eclipse 其他版本，可能会发现用户界面以及步骤 本文中讲述 所 同。
Eclipse和RationalClearCase源代码控制如果要集成Eclipse和RationalClearCase源代码控制系统，可以下载并安装IBMRationalClearCaseSCMadaptersforEclipse2.11。否则，默认源代码控制系统 CVS。
Eclipse中创建新 Java项目安装 Eclipse和所 插件后，现 就可以创建项目，并以此作为Notes/Domino工作 开始。必须 个项目内存储所 Java代码。 工作区中可以 多个项目。 计算机中还可以 多个工作区，可以使用eclipse.exe –data开关来指向 同 工作区。
要创建新 Java项目，需要打开Eclipse，选择File-New-Project。然后 NewProject对话框中选择JavaProject，最后单击Next。
图1.NewProject对话框
输入项目名称，然后单击Finish。创建 项目后，要更改项目属性中 路径，使其指向Notes.jar文件。右击PackageExplorer附签中 项目并选择Properties。 Properties对话框中，选择JavaBuildPath，然后选择Libraries附签。单击AddExternalJARs按钮，导航到Notes.jar文件，以将其添加到类路径中。
图2.Properties对话框
添加 JAR文件之后，可以使用项目中NotesJavaAPI定义 类和接口。DominoDesigneron-linehelp中 关于NotesJavaAPI 文档。
接着，需要下载Sun1.3.1JRE。或者，如果计算机上安装 Domino服务器，可以使用该服务器 JVM。Notes客户机和Domino服务器应该 匹配 ，以确保构建项目所用 JVM 从服务器任务或代理服务器任务调用时代理和程序将运行 JVM相同。
LotusNotes/Domino 当前版本使用 Java1.3.1，所以必须安装该软件以使用正确 版本来构建项目。（LotusNotes/Domino7使用JDK1.4。）虽然许多Java代理和程序都可以编译，而且没什么问题，但可能会陷入另 些问题，比如使用 个JDK版本构建程序，却 另 个版本上运行。如果安装 Eclipse3.0，因为它 基于Java1.4.2 ，所以需要删除JDKSystemLibrary并创建 个新库来指向JDK1.3.1安装。要进行这项操作，需要选中Libraries附签 Properties对话框中 JRESystemLibrary，并单击Remove。
要添加新库，可以单击AddLibrary按钮。 AddLibrary对话框中，选择JRESystemLibrary，然后单击Next。选择AlternativeJRE选项（如果尚未选择）。然后单击InstalledJREs按钮。单击Add并完成AddJRE对话框来添加JDK1.3.1。
图3.AddJRE对话框
保存对项目 更改。
创建第 个Java代理DominoDesigner 开始时会自动为您填充第 个Java代理。 过，Eclipse 会这样，所以它需要创建新类，来实现正确 AgentBase接口，获取Domino会话和agentcontext对象。可以使用DominoDesigner中 代码作为指导。
图4.DominoDesignerJava代理
将骨干Java代码从DominoDesigner直接复制到Eclipse项目中 新类中。 们建议您创建新 包，并于其中存储代理。这将 助于组织项目，并且这符合 般Java设计原则。要创建新 包，可以选择File-New-Package。
图5.NewJavaPackage对话框
们创建名为com.ibm.NotesJava.agents 包，因为 IBM工作，并且这 们 NotesJava项目。 们将 这个包中存储代理。可以看到 其他常见包 com.sun.*、org.apache.*和核心Java语言函数 java.lang.*。至于如何组织包 整套原则，但这 本文讨论范围内，重要 要将代理和代码放 默认包中，因为这个包杂乱且 专业。
现 已经 新包，所以可以创建新 Java类。要 Eclipse中创建新 Java类，可以选择File–New–Class。Eclipse 效率非常高，所以如果已经选择 包，那么Eclipse将填充包名称。可以 这里添加名称和超类 。对于Notes代理，超类必须始终 lotus.domino.AgentBase。 DominoDesigner中，该操作 自动进行 ，但 Eclipse中，必须手工完成这项操作。
图6.NewJavaClass对话框
创建类之后，就可以输入剩余 代理代码，从而使其看起来 DominoDesigner示例中 代理 样。
图7.Eclipse中 JavaAgent
构建代理时，将 包目录中创建JavaAgent.class文件。现 已经 类文件， 们可以将其导入DominoDesigner中 代理中，并 Eclipse中管理代码。 DominoDesigneron-linehelp中，请参阅“ImportJava”主题，以获取更多信息。 将文件导入代理中之后，当调用该代理时，可以运行已经编写 Java代码。现 就可以使用Eclipse调试程序来调试该代码 。
调试Java代码Eclipse封装 Java调试程序，使您能够遍历和更改变量，监视项并 Java代码中添加断点。第 步 调试模式下加载LotusDomino中JVM。这样可以强迫JVM停止，等到附加 调试程序后再继续进行其操作。LotusNotes/Domino6或之后 版本中包含这项功能，要启用该功能，可以添加Notes.ini变量JavaEnableDebug=1，然后重新启动服务器。
下 阶段 服务器上运行代理，并等待服务器冻结代理 执行。 冻结代理 执行之后，JVM将等待调试程序附加到TCP/IP端口9788。
打开Eclipse和项目。选择Run-Debug来打开Debug对话框，然后选择RemoteJavaApplication，单击New创建新 调试会话。最后， Connect附签中，指定服务器 主机名称，如果服务器 所调试 计算机上，则指定本地主机 名称。
图8.Debug对话框
对于高级用户，可以按如下所示改变端口号和调试设置：
JavaDebugOptions=transport=dt_socket,server=y,suspend=n,address=8000
Suspend=n没 冻结服务器来等待调试连接，所以可以错过代理 启动。该调试设置允许您将额外参数传送给服务器中 JVM调试程序。如果您 自己喜欢 设置，也可以 这里使用。
最好 代理代码中已经设置 断点。当 调试模式下使用Eclipse将代码附加到服务器时，它应该会自动断开，并允许您检查变量，设置其他断点，执行需要使用 其他所 调试任务。
其他Eclipse指针现 Eclipse中已经 项目，它提供 DominoDesigner内大型Java项目所没 许多增强开发和组织任务。DominoDesigner适用于较小 Java任务，比如获取或设置多个值或简单 报表。 过， 旦开始将代码分入 同 包、定义接口并将工作委托给其他 ，项目管理会变得更复杂。
Eclipse包含用于协同工作 内置工具，其中包括CVS源代码控制集成。RationalClearCase源代码控制插件允许您附加到ClearCase中存储 Eclipse项目中。它提供 自动或即时 代码检入和检出、简洁 修饰符，从而可以轻松地标识源代码控件中 对象及其状态。
Eclipse中另 项非常 用 功能 可以重构项目。例如，可以选择代码 部分并将其移至它自己 方法中。如果您 个非常长 方法，想将其分入较小 步骤中，那么可以将这项操作自动化，Eclipse能够帮助您实现该自动化。下列代码片断 个重构示例：
InitialfunctionpublicvoidNotesMain(){try{Sessionsession=getSession();AgentContextagentContext=session.getAgentContext();Databasedb;//Iamrunningthis,usetheserver-oritcanassumeitislocalif(session.getUserName().equals("CN=IanConnor/OU=Westford/O=IBM")==true)db=session.getDatabase("support/iris","support/retain.nsf");elsedb=session.getDatabase("","support/retain.nsf");System.out.print(db.getFileName());}catch(Exceptione){e.printStackTrace();}}可以选择要移至其自己 函数 代码部分，然后选择Refactor-ExtractMethod。这将确定需要传送 参数和应该返回 数据。您所需要做 就 选择方法名称。然后可以预览更改，查看要进行 操作。这将 助于您更好地组织代码，使试图 解代码 其他 更容易维护代码。正如所 开发 员都知道 ，包含较短函数 、简洁 、组织良好 代码基数（codebase）要比非常长 、似乎 会结束 1000行函数容易使用得多。
publicvoidNotesMain(){try{Sessionsession=getSession();AgentContextagentContext=session.getAgentContext();Databasedb;db=getRetainDatabase(session);System.out.print(db.getFileName());}catch(Exceptione){e.printStackTrace();}}privateDatabasegetRetainDatabase(Sessionsession)throwsNotesException{Databasedb;//Iamrunningthis,usetheserver-oritcanassumeitislocalif(session.getUserName().equals("CN=IanConnor/OU=Westford/O=IBM")==true)db=session.getDatabase("support/iris","support/retain.nsf");elsedb=session.getDatabase("","support/retain.nsf");returndb;}重构 所 开发工作 基础部分。 们总 愿意立即共享代码 第 个cut。 使用新 API或新 工作方式时更 如此。先 花费大量时间编写 小部分代码，以测试其如何工作，然后当可以运行该代码时，将停下来适当组织代码，使查看该代码 能够看懂。
结束语Eclipse Notes开发 员可以 其当前和将来项目中使用 非常 用 平台。它可以帮助开发 员更好地组织项目， 小组中 其他 共享代码，并更好地利用Java设计技术，如接口和代码分隔。随着LotusWorkplace和LotusNotes/Domino 集成度越来越高，Java和Eclipse将发挥重要 作用。Notes开发 员现 可以凭借自己 合并和群件技能进行构建，同时还要准备应付未来 挑战。
新 产品或工作方式必须具 些重要功能和优点，才能确保 们愿意采用该产品或方式。对于必须提交编写得很好 、提供优质Java代码 应用程序 Notes开发 员来说，Eclipse提供 调试、重构和源代码控制。所 这些 任何重要 开发工作中都 重要 功能，它们将确保 得到 成果相比，您花费时间学习如何使用Eclipse进行Notes开发 非常值得 。
,