用JAVA访问DOMINO邮箱数据

应用场景

我们需要远程访问 IBM Lotus Domino R6 服务器，从中获取用户邮箱的邮件信息等关键数据。我们不需要提供每一个用户密码以及 ID 文件。

技术关键词

Java ：

Java 和 Lotus Notes/Domino 是理想的开发组合。

DIIOP ：

IIOP ， 是 Internet Inter-ORB Protocol ， 一种传输层协议。它用于 CORBA 2.0 及兼容平台上。 IIOP 协议是要建立以下几个部分：一个 IIOP 到 HTTP 的网关，使用这个网关可以让 CORBA 客户访问 WWW 资源；一个 HTTP 到 IIOP 的网关，通过这个网关可以访问 CORBA 资源；一个为 IIOP 和 HTTP 提供资源的服务器，一个能够将 IIOP 作为可识别协议的浏览器。

其中 ORB 呢 ， Object Request Broker( 请求对象代理 ) ， 一个中间件 。它可以建立对象之间的 client/server 关系。通过 ORB ，一个 client 可以透明的引用同一台机器上或网络上的一个 server 对象的方法。 ORB 解释该调用并负责查找一个实现该请求的对象，找到后，把参数传给该对象，调用它的方法，最后返回结果。

那么， DIIOP 就 是 Domino IIOP 了 ， 什么意思呢 ？ 就是一个服务器端的任务 ， 通过 Domino ORB ， 来使得 Domino Server 与 Java applets 交互 ， 双方使用 IIOP 来交互和交换对象数据。

IOR ：

IOR ， Interoperable Object Reference 。

实际上，就是 Domino 服务器上的一个文件 diiop_ior.txt 的内容，类似于：

IOR:01012d032900000049444c3a6c6f………………………

，它在 c:\lotus\domino\data\domino\html 文件夹下。

客户端 java 程序向 domino 服务器发出 CORBA 请求 ， 服务器通过 HTTP 协议返回给客户端 IOR 字符串， 之后客户端通过 IIOP 协议与服务器进行通讯。

从这一点来看， IOR 实际上是一个对象的字符串编码，包含对 Domino 服务器的 CORBA 访问的识别信息。客户 端 java 程序 将字符串 IOR 解码，就可以用它来寻找到对应的主机并建立远程会话了。

Domino对象

Domino对象类的结构基于包容模型，包容模型定义了对象的范围。容器对象通常被用来访问它所包含的子对象。

关闭一个容器对象意味着其包含的全部子对象也将被关闭。例如，你建立了一个Database对象，使用它创建了一个Document对象，如果关闭了 Database对象，Document 对象也会随之关闭。如果容器对象超时，它将会被自动关闭，其包含的对象也将被自动关闭。因此你应该在容器对象超时或关闭前保存你的任何改变。

Domino Database ：

Domino 中的 Database ，指的是在一个名字下存储的，一个集合，包含了 Document 以及相应的 form 、 view 和 folder 。 Java 中有 lotus.domino.Database 。

我们通常可以通过 session 对象的 getDatabase 方法，或者 DbDirectory 对象的 getFirstDatabase/ getNextDatabase 方法，来获取 Database 对象的实例。

Domino View ：

Database 集合中有着各种 View 。 Java 中有 lotus.domino.View 。可以通过 Database 对象的 getView 方法，来获取 View 对象的实例。

Domino Document ：

Domino 中的 Document ，指的是在一个 Database 的一个条目，包含了 fileds ， text ， numbers ， graphics 等等。 Java 中有 lotus.domino.Document 。

可以通过 Database 对象的 getView 方法，来获取 View 对象的实例。

环境准备

 

客户端 java 开发：

安装 Lotus Notes Client 。

安装 Eclipse 3.1 with Eclipse-JDT-SDK 。

安装 JRE 1.3.1 。 Lotus Notes/Domino 的 R5/6 版本使用的是 Java 1.3.1 ，所以必须安装该软件以使用正确的版本来编译项目。（ Lotus Notes/Domino 7 使用 JDK 1.4 。）虽然许多 Java 代理和程序都可以编译，而且没什么问题，但可能会陷入另一些问题，比如使用一个 JDK 版本构建程序，却在另一个版本上运行。

从服务器端 Lotus 目录下复制 NCSO.jar 以及 NCSO.cab 文件。远端访问 Domino Server ，需要这个 jar 包。

Domino 提供了两个 JAR 文件，用于编程访问 Domino 对象。这两个文件是 Notes.jar 和 NCSO.jar 。Notes.jar 用来访问 本地的 Domino 服务器（此时 Lotus Domino 和 Java 程序运行在相同的服务器上）。NCSO.jar 包含了用来访问远程服务器的其他 CORBA/IIOP 代码。

在决定使用哪个 JAR 文件时，请考虑以下因素：

• 运行的 Java 程序和 Lotus Domino 的相对关系如何？如果它们运行在相同的机器上，那么使用 Notes.jar 可以获得更好的性能。
• 您关心可扩展性吗？即使现在您是在相同的机器上运行 Java 程序（单独的 Java 程序和非 J2EE 的程序）和 Lotus Domino ，将来您可能会发现需要将其扩展到专用的服务器上。在这种情况中，请使用 NCSO.jar ，这样可以获得更好的适应能力。
• Java 程序要在一个应用服务器上运行吗？在 WebSphere 的情况中，即使它与 Lotus Domino 在相同的机器上，也需要使用 NCSO.jar 。

  如果你不用超级管理员用户名密码创建连接 session ，而是采用 Domino Server ID ，那么请从 Domino 服务器上 Lotus 目录下复制一个 server.id 文件以备用。

如果你想直接使用 diiop_ior.txt ， 把这个 diiop_ior.txt 复制到本地。

Domino 服务器端配置：

必须配置的项目：

必须设置 Domino 服务器监听 IIOP 请求 ：

首先确保安装了 DIIOP ，你可以在安装过程中选择 DIIOP ，这样当安装结束，启动 Domino Server Console 时，就会看到提示“

DIIOP Server     Listen for connect requests on TCP Port:63148

DIIOP Server     Ultility task ”。

可以在 Domino Console 中执行 show task 或 load diiop 命令，可以帮助判断现在是否已经安装了 DIIOP 。如果还没有安装，请从 Domino 安装光盘上安装 DIIOP 。

 

否则，就要修改 lotus 目录下的 Notes.ini 文件了。找到以 ServerTask 开头的一行，找找看等号后面的字符串中是否有 DIIOP ，如果没有，就加上一个，然后重新启动 Domino Server 。这样， Domino 启动时就会自动加载 DIIOP 。

ServerTask 一行类似于：

ServerTasks=Update,Replica,Router,AMgr, AdminP,CalConn,Sched,DIIOP,HTTP,LDAP

 

如何获取 IOR ：

在 DIIOP 进程启动时，它在 Domino HTTP 根目录（ Windows 中 Domino 默认的安装目录为 C:\lotus\domino\data\domino\html ）中创建一个名为 diiop_ior.txt 的 IOR （ Internet Object Reference ）对象。

如何得到这个 diiop_ior.txt 内容 ( 也就是 IOR 了 ) ，有两个办法：

第一个就是，您通过 HTTP 方式向服务器请求这个文件。那么这个时候，如果您使用 Lotus Domino 作为 HTTP 服务器，就必须告诉 DIIOP 将这些文件放到您的 HTTP 服务器的根 HTML 目录中。配置方法如下所示：

 

1.        运行 Domino Admin 6 ，点击 “XXX Domain” 图标，打开 Domino Server 文档。

2.        选择 Internet Protocols 属性页 - DIIOP 子属性页。

3.        在 External HTML directory 字段中，输入非 Domino HTTP 服务器的根 HTML 目录的完整路径名。

4.        保存这个 Server 文档，并重新启动 DIIOP 。

第二个办法，是把这个 diiop_ior.txt 复制到客户端机器上，直接使用 。

 

TCP/IP 连接检查：

远程访问还需要设置 Domino Server 和客户端进行 TCP/IP 连接。 Domino Server 必须能够通过 TCP/IP 进行访问。必须能够用 Internet 名称从客户端 ping 到服务器。

DIIOP 设置：

检查 Domino Directory 中 Server 文档。转至 Ports 选项卡，然后转向 Internet Ports 选项卡。查看 Web 选项卡（用于 HTTP ）并找到 DIIOP 选项卡。这些部分有用于指定端口号以及启用 / 禁用端口的字段。通常， HTTP 的端口号是 80 ， DIIOP 的端口号是 63148 。下图显示了 Internet Ports--DIIOP 选项卡：

 

No.	Items	Descriptions
1	Name and Password	DIIOP 验证需要名称和密码
2	Anonymous	DIIOP 验证不需要名称和密码
3	Enforce server access settings	DIIOP 使用 Security 选项卡下的 Server Access 设置

 

如果访问数据库时不知道文件名称（例如，要使用 DbDirectory.getFirstDatabase ），那么必须允许通过网络浏览文件名。转至 Internet Protocols 选项卡、 HTTP 选项卡和 R5 Basics 选项卡。然后将 “Allow HTTP clients to browse databases” 设为 Yes 。


 

配置权限：

必须给你当前建立 session 的用户配置权限，否则你将会遇到下面的错误：

 

NotesException: You must have permission to sign documents for server based agents

    at lotus.domino.NotesExceptionHelper.read(Unknown Source)

    at lotus.domino.NotesExceptionHolder._read(Unknown Source)

    at lotus.priv.CORBA.iiop.RepImpl.invoke(Unknown Source)

    at lotus.priv.CORBA.portable.ObjectImpl._invoke(Unknown Source)

    at lotus.domino.corba._IDocumentStub.send(Unknown Source)

    at lotus.domino.cso.Document.send(Unknown Source)

    at SendMail.send(SendMail.java:203)

    at SendMail.main(SendMail.java:28)

转至 Security 选项卡，找到“ Programmability Restrictions ”，在“ Run unrestricted methods and operations: ”和“ Sign agents to run on behalf of someone else: ”后面输入你的用户名：

 

总之，如果你遇到了权限错误，就到这里来配置。

 

 

开始编写

Add External JARs ：

在 Eclipse 3.1 ，选中你的项目，右键菜单中“ Build Path ” à “ Add External Archives ”，在文件选择对话框中找到并选中你前面复制到本地的 NCSO.jar ，如下图所示。

 

添加了 JAR 文件之后，可以使用项目中 Notes Java API 定义的类和接口。 Domino Designer on-line help 中有关于 Notes Java API 的文档。

然后 选择 JRE System Library 采用 1.3.1 版本的。

获取 IOR ：

首先，我们去获取 IOR 。

 

还是前面说过的两种办法。

第一种，与 Domino Server 联系获取：

Code

String dominoHost = "192.168.1.223"; // 这里填写主机名或 IP 地址

String strIOR = null;

      URL url = new URL("http://" + dominoHost + "/diiop_ior.txt");

      InputStream in = url.openStream();

      BufferedReader br = new BufferedReader(new InputStreamReader(in));

      for (boolean bExit = false; !bExit; ) {

        String line = br.readLine();

        if (line == null) {

          bExit = true;

        }

        else {

          if (strIOR == null)

            strIOR = line;

          else

            strIOR = strIOR + line;

          if (strIOR.startsWith("IOR:"))

            bExit = true;

        }

      }

      br.close();

第二种，取得本地文件：

Code

FileInputStream fin = new FileInputStream("c:\\diiop_ior.txt");

InputStreamReader fisr = new InputStreamReader(fin);

BufferedReader br = new BufferedReader(fisr);

String ior = br.readLine();

fin.close();

 

创建 session ：

我们调用 NotesFactory 的 createSessionWithIOR 方法，通过前面获取的 IOR ，创建一个 session 对象。

Code

Session s = NotesFactory.createSessionWithIOR(ior,

                                 "super admin" ,"admin password");

 

打开 names.nsf ：

我们调用 session 的 getDatabase 方法，打开指定服务器上的 “ names.nsf ”数据库 。

Code

final static String DB_NAMES = "names.nsf";

Database dbCache = s.getDatabase(s.getServerName(),

                                      DB_NAMES, false);

 

得到 Users View ：

我们调用 Database 的 getView 方法，打开指定数据库上的 “ ($Users) ”视图 。

Code

View view = dbCache.getView("($Users)");

 

遍历 Users View ：

我们可以遍历指定数据库上的 “ ($Users) ”视图，得到每一个用户的 Document 。

也可以指定一个用户，专门取得他的 Mail File ，

Code

Document docKey = view.getDocumentByKey("zheng yun");

                        if (docKey == null)

                      System.out.println("docKey not found!");

                   else

                     {

                          strMailFile = docKey.getItemValueString("MailFile");

                      if (strMailFile == null)

                              System.out.println("strMailFile is null!");

                      else

                              System.out.println("strMailFile = " + strMailFile);

                }

输出结果就是： mail\zyun.nsf 或者 mail\zyun 。

这样，我们就知道了该用户的邮箱所在的数据库文件的路径了。

 

打开邮箱数据库文件 ：

知道了一名用户的邮箱文件名称，我们可以再用 session 的 getDatabase 方法打开该数据库：

Code

Database dbMail = s.getDatabase(s.getServerName(),

   "mail\\zyun.nsf", false);

if(dbMail == null)

   System.out.println("cannot open database");