摘要:本文把AspectJ应用于Domino服务器上Notes数据库的开发,
从而实现让Domino具备一些面向方面特征的目的。
关键字:Lotus Domino/Notes、Lotus Domino DIIOP for Java、AspectJ。
如何把AspectJ应用于Domino的开发,从而让Domino具备一些面向的特征,是本文写作的目的。文中作者根据实际在Domino项目中对AspectJ的应用加以整理、简化——为初学者提供一个简要的入门。本文的结尾处提供了实例的源代码。
下面分步骤进行讲解:
第一步:AspectJ开发环境配置
在实际项目开发中由于现在的AspectJ集成开发环境很少,因此笔者选用了最简单也是目前比较有效的开发工具:EditPlus。在使用EditPlus前,先作CLASSPATH设置如下:
d:\j2sdk1.4.2_02\jre\lib\rt.jar;d:\j2sdk1.4.2_02\lib\tools.jar;d:\aspectj\lib\aspectjrt.jar;d:\aspectj\lib\aspectjtools.jar;d:\lotus\domino\Notes.jar;d:\lotus\domino\data\domino\java\NCSO.jar
笔者的Domino服务器安装在D:盘,Java SDK也在D:盘,同样AspectJ v1.2也解压安装在D:盘。
接下来,设置EditPlus以方便开发,进入【工具】菜单,【选配置用户工具】出现:
Group 1:
Javac
(
命令:D:\j2sdk1.4.2_02\bin\javac.exe
参数:-d “.” $(FileName)
)
接下来完成”AspectJ”条目设置:
AspectJ
(
命令:D:\aspectj\bin\ajc.bat
参数:-d “.” –argfile files.lst
)
第二步:用EditPlus在Domino代理中开发方面
Notes数据库AspectJTest代理如下:
import lotus.domino.*;
public class JavaAgent extends AgentBase
{
public void NotesMain()
{
try
{
Session session = getSession();
AgentContext agentContext = session.getAgentContext();
// (Your code goes here)
OutPrinter();
}
catch(Exception e)
{
e.printStackTrace();
}
}
public void OutPrinter()
{
System.out.println("OutPrinter() work!"); // 向Domino控制台输出
}
}
和该代理配套的方面如下:
aspect AspectJTest
{
// 定义切点myCut()捕捉代理中的OutPrinter()方法
pointcut myCut() :
call(public void OutPrinter());
// 在切点到达时完成前通知
before() :
myCut()
{
// 向Domino控制台输出
System.out.println("... before ...");
}
}
分析这两段程序代码可知:如果AspectJTest代理正常运行,那么在Domino控制台输出
"OutPrinter() work!"前将输出"... before ...",而这可能就是我们的目的。
第三步:制作files.lst文件并完成编译
该文件是一个文本文件,它些组AspectJ编译器完成make-file功能。这里要注意的是:笔者在EditPlus中生成files.lst文件时,和JavaAgent.java、AspectJTest.java文件一齐都放在
D:\aspectjpro目录。
接下来你可以选中按【工具】菜单的【AspectJ】条目,对这个具有面向方面特征的代理进行编译。生成JavaAgent.class和AspectJTest.class文件。当然你也可以手工用下面的命令行编译它们:ajc -d "." -argfile files.lst
这要求你作相应的PATH设置:ajc.bat在D:\aspectj\bin目录内。
第四步:创建数据库test.nsf和test表单以及AspectJTest代理
在服务器上创建test.nsf数据库并在test.nsf数据库中建立test表单,在test表单中放上一个按钮。以“AspectJ Test”为名称,而按钮的公式为@Command([ToolsRunMacro]; "AspectJTest")
第五步:建立AspectJTest代理
注意在建立AspectJTest代理时,你一定要在代理属性中作如下的选择:
代理名:AspectJTest
运行时选择:Agent list selection。
Taget::None
接下来选择 【Imported Java】和【Reimport class files】引入类文件:aspectjrt.jar、AspectJTest.class、JavaAgent.class。
注意这里把D:\aspectj\lib\aspectjrt.jar拷贝到了D:\aspectjpro目录。
在浏览器中浏览表单test并按下按钮“AspectJ Test”,你将会在Domino控制台中看见输出:
“… before …”
“OutPrinter() work!”
我们看到“… before …”输出代了“OutPrinter() work!”前,这也是我们的目的。
本文程序实例在Lotus Domino R6.5下运行正常且非常稳定。
结论:本文完整地在Domino中成功引入了AspectJ这一面向方面的语言,虽然简单但说明了Domino可以具备一些面向方面的特征。