用 Java 访问 Domino 的对象.doc

用 Java 访问 Domino 的对象(一)
本文译自LDD Today的文章"Java Access to Domino Objects",原文请参考以下网址: .com/ldd/
007aacf1/843921a609a5dd4685256d4e00560b70?OpenDocument (美国)
概述
使用 Java 可以访问 Domino 中的对象,如数据库、视图、文档等。本文简述了用 Java 访问 Domino 对象的基本编程方法。本文中的内容主要是根据 Lotus Domino/Notes 6 编写的,使用 R5 时会略有不同。
Java 对 Domino 对象的访问是通过调用 包来进行的。在运行环境中, 包中的接口是通过两个包来实现的:
- 支持从Notes/Domino所在的计算机上进行的本地调用
- 支持对 Domino 服务器进行远程连接
对于本地连接,Java 程序将在Notes客户端或Domino服务器所在的计算机运行,使用JNI 对Notes/Domino的代码进行访问。
对于远程连接,Java 程序通过 CORBA 访问 Domino 所提供的服务。远程访问包括两个过程:
客户端通过 HTTP 协议获得服务器的初始对象,作为 IOR (Interoperable Object Reference)
客户端通过 IIOP 协议进一步获得服务器上的其他对象。
在 中,NotesFactory 类提供了 createSession 以及其他方法,可以用来开始 Java 应用程序或 servlet 对 Domino 对象的访问。不同的调用方式决定了访问是本地的还是远程的。
要使用 包来编译 Java 程序,类路径(classpath)中必须包含 (本地)或 (远程)。例如:
set classpath=%classpath%;c:\lotus\domino\
或者
set classpath=%classpath%;c:\lotus\domino\data\domino\java\
。 在Domino服务器或Domino Designer的数据目录下,domino\java 子目录中。
本地调用
使用 createSession 时,没有参数、第一个参数为 null、或第一个参数为空字符串都表示本地调用。以下代码是等价的:
Session s = () Session s = ((String)null) Session s = ("")
要从应用程序和 servlet 中执行本地调用,路径(path)中必须包含 Notes/Domino 的程序目录,类路径(classpath)中必须包含 。例如,当 Domino 安装在"c:\lotus\domino"中时:
set path := %path%;c:\lotus\domino
set classpath := %classpath%;c:\lotus\domino\
和 包。
本地调用要求使用 NotesThread 类来管理线程。NotesThread 类扩展了 ,包含了专门针对 Domino 的的初始化和终止代码。您可以有三种不同方式来使用它:
通过继承来执行线程
通过 Runnable 接口来执行线程
通过静态方法来执行线程
通过继承来执行线程
要通过继承来执行线程,需要扩展 NotesThread(而不是 Thread),包含 runNotes 方法(而不是 run 方法)。NotesThread 线程可以和其他线程一样通过 start 方法来启动。这种方式较为易用,也比较不容易出错。
import .*;
public class myClass extends NotesThread
{
   public sta