lotus designer 8.5中创建JAVA代理（转自genusBIT的空间）

在开发LotusDomino数据库的过程之中，开发人员可以创建Java代理（Agent）程序，方便将LotusNotesJavaAPI和任何第三方的Java类库整合到Domino数据库中，使得Notes数据库具有强大的可扩展性。在DominoDesigner8.5.1中，集成了Eclipse开发环境，用于Java代理的开发。本文将通过一个具体的应用案例，向LotusDomino开发人员介绍如何使用DominoDesigner8.5.1开发依赖于第三方Java类库的Java代理程序，并阐述了如何部署基于事件触发和被调度的代理程序。

应用环境分析

我们需要对一个现有的Notes数据库进行改造，这个Notes数据库中存在一系列的视图，某些视图中包含的文档包含统一格式的Excel附件。我们需要批量地从这些Notes文档中提取出Excel附件，并将Excel文件中的数据保存到DB2数据库中。

客户存在两种不同的需求，一种是手动选择需要处理的Notes文档，另一种则是在每个月固定的时间点执行批处理程序，将符合特定条件的Notes文档批量进行处理。对于这两种需求，我们都可以通过建立Java代理程序来实现。

使用DominoDesigner8.5.1创建Java代理

在DominoDesigner8.5.1中打开Notes数据库文件TestNSF.nsf,展开Code节点，在Agents节点上点击右键，在菜单中选择”NewAgent”，在弹出的对话框中选择”Java”，命名为”DataExtractionAgent”。如图1所示：

图1.创建JavaAgent

系统会自动在默认包中创建JavaAgent.java文件，该类扩展了lotus.domino.AgentBase类，并重载了NotesMain()方法。

清单1.Java代理程序代码示例

publicvoidNotesMain(){

try{

Sessionsession=getSession();

AgentContextagentContext=session.getAgentContext();

//(Yourcodegoeshere)

}catch(Exceptione){

e.printStackTrace();

}

}

使用session对象可以获取当前的代理程序所处的Notes数据库或者其他数据库对象，并调用NotesJavaAPI实施数据库文档的增删改查，以及元数据的读取等操作。

agentContext对象是Java代理的运行环境对象，可用来获取被用户选择的Notes数据库文档列表等对象。当Java代理被触发时，AgentBase类的NotesMain()方法将被调用。

接下来，我们可以在Java代理中继续建立其它的Java包和类；如果我们需要在Java代理程序中调用第三方的JavaAPI，我们可以将依赖的Java类库拷贝到Notes或Domino内置的Jvm的lib/ext目录下。

在DominoDesigner中，切换到Java视图，发现DataExtractionAgent作为一个独立的Java项目存在，DominoJavaLibrary下可以看到新增加的Java类库，agent.jar包含了从Excel文件中读取数据保存在DB2数据库中业务逻辑，而db2开头的两个jar包提供了操作DB2数据库的API。

图2.Java代理程序在Java包视图中的显示

在Java视图中可以方便的完成Java代理程序的开发，之后可以回到DominoDesigner视图，执行Java代理的测试。

选择Code节点下的Agents项，在右边的窗体中得到所有Agent程序的列表，右键点击DataExtractionAgent，选择”Run”命令，则触发了该Agent程序的运行。

图3.测试Java代理程序

运行的结果是得到一个日志对话框提示Agent执行的情况。

图4.Java代理程序运行情况

代理被触发的方式主要分为两种，一种通过菜单调用，另一种则通过调度来实现。通过菜单调用的Java代理可以部署在Notes客户端或者Domino服务器；而调度的Java代理只能运行在Domino服务器上。

调试Java代理程序

可以使用DominoDesigner对新建的Java代理程序进行调试。

首先在DominoDesigner视图中选择JavaAgent，然后在下方的Properties选项卡中选择Security页面，选择“CompileJavacodewithdebugginginformation”。

图5.设置Agent程序的调试信息

然后打开Tools菜单，选择Java调试首选项，勾选”ClientAgents/Applets”，设置端口号。

图6.设置Java代理调试参数

创建一个”RemoteJavaApplication”调试配置，如图7所示。选择Host为localhost，Port为8701.

图7.设置远程Java应用调试配置

在JavaAgent的NotesMain()方法中添加断点，然后通过工具栏启动调试。

图8.启动Java代理的调试

切换到debug视图，发现远程debug的连接已经被建立。进入Notes客户端，触发Java代理的运行，进入断点，于是可以进行调试了。

Java代理的触发机制有两种，一种是事件触发，一种是定时触发。

在Notes视图中调用Javaagent

在Java代理的基本属性页，选择运行时触发方式为”Onevent”，在下方的下拉列表中选择”Agentlistselection”。

图9.设置Java代理程序的触发

在Notes视图的Action列表中新建一个Action，命名为”提取数据”，编辑该Action的属性，使之在工具菜单中显示，双击该Action，设置click事件的业务逻辑，选择在客户端运行，调用的程序为NotesFormula:

图10.编写对Java代理程序调用的公式

在Domino服务器中部署定时调用的Java代理程序

使用DominoDesigner完成Java代理的开发并部署到服务器上的Notes数据库中，设置调用机制为定时调用。进行保存时，弹出下面的对话框，指明当前的开发人员不具备足够的权限来部署服务器上的Java代理程序。

我们设置Java代理为定时执行的同时，还需要在DominoServer端进行配置，打开DominoAdministrator，选择最右方的Configuration选项卡，选择右下方工作区中的Security页。将管理员的NotesID加入到域”SignorrunrestrictedLotusScript/Javaagents”中。如果Java代理程序需要在服务器端的文件系统写文件，则需要在FullAccessadministrators域中也加上管理员的NotesID.完成修改后进行保存。

图11.配置Java代理程序在Domino服务器上运行的权限

总结

本文介绍了如何在LotusDominoDesigner8.5.1中开发Java代理程序，并在Java代理中调用第三方的类库，另外还介绍了调试Java代理的方法以及部署Java代理到Domino服务器的要点，具有一定的参考价值。