Lotus Domino/Notes Toolkits 综述(注：转)

1 概述

1.1 为什么要了解Lotus Toolkits

    在使用Domino/Notes开发企业应用的过程中，不断遇到了Domino要和其他业务系统相结合的问题。Domino是一个比较独特、比较封闭的系统，要作为整个企业的应用整合平台很困难。应当采用一种更通用、更开放的技术来构建这个平台。
    Domino/Notes作为群件系统的典型，它在处理文档信息、协同工作方面有特点，也有优势，而且公司在这个平台上有很多积累。因此，如何在一个开放的平台上，将Domino/Notes应用有机地结合进来，是需要解决的一个重要问题。
    为此，我们需要了解有哪些途径可以从外部得到Domino/Notes系统中的数据、对象，Lotus提供了什么样的接口和工具。这些工具就是Lotus Toolkits。

1.2 有哪些Toolkits

    按Lotus产品系列来分，Lotus提供下列产品的工具包：

• Notes/Domino
• Sametime
• QuickPlace
• Discovery Server
• Other

其中，Notes/Domino和Sametime的工具包比较多，C、C++、Java语言的都有，其他产品的则很少。从这个角度，也可以看出文档数据处理、协同工作是Lotus系列产品的核心价值所在。     其中，Notes/Domino的工具包有：

• Lotus C API toolkit
• Lotus C++ API toolkit
• Lotus Domino Toolkit for Java/CORBA
• Lotus and Notes Toolkit for COM
• Lotus Domino Driver for JDBC （简称LDDJ）
• NotesSQL
• Lotus XML Toolkit（简称DXL）
• Custom Tag Converion kit（简称DCT）
• LotusScript Extensions toolkit（简称LSX）

 

1.3 本文有哪些内容

    本文着重介绍Notes/Domino的部分工具包：

• 能用来完成什么样的工作，不能完成什么样的工作
• 工作机制
• 如何配置和使用
• 比较分析如何选择使用这些工具包。

 

 

3 Lotus C++ API

3.1 简介

    C++ API是建立在C API的基础上的又一个工具包，两者也比较相似：    

• 可以操纵Domino/Notes中的绝大部分数据对象：
  • 数据库：创建、拷贝、复制、删除、修改ACL
  • 文档：创建、拷贝、删除
  • 域：创建、修改、拷贝、删除，对RTF域具有强大的处理功能
  • 视图和文件夹的使用
  • 可以创建验证者，并能用验证者来注册用户和服务器
• 可以用来创建附加的Domino服务任务

主要限制：
    和C API的主要限制也很相似：

• 不能修改已有的Domino/Notes软件
• 不能直接修改数据库复制历史、用户活动记录等
• 不能修改Notes客户端的桌面信息，例如在工作台上增删数据库图标、修改标题

支持的操作系统和编译器

平台	编辑器	备注
MS Windows NT/2000	MS Visual C++ 6.0 IBM VisualAge C++ 3.5	v2.3不支持Borlad C++的编辑器，v2.1支持。
Solaris Sparc	Sun WS
Linux	g++
AIX	IBM PortaPak
AS/400

最新版本
    v2.3，发布于2003.03.10

3.2 开发和使用

    C++ API的开发和使用和C API也很相似，同样需要Notes/Domino软件的支持，同样使用Domino/Notes的安全机制。

对象结构



   除此之外，API还提供了大量公共函数来处理这些对象，并有一些内置的数据类型，例如：LNString、LNText、LNNumber、LNDatetime、LNBOOL、LNCHAR、LNINT等。

程序结构    使用C++ API时，同样需要在使用之前进行Domino/Notes运行环境的初始化和清理，如下图所示：




开发环境
    以使用MS Visual C++ 6.0为例。
    要注意的是C++ API中包含的一些头文件和VC使用的是同名的，例如：
        mq.h, neterr.h, and stats.h
    需要使用C++ API所带的头文件。因此，或者在程序中指定头文件的绝对路径，例如：
        #include "c:\notescpp\include\mq.h"
    或者在VC的环境配置中，将Notes API的include目录列在VC的include目录前面。
    总之，C++ API使用了面向对象的技术，在处理Notes数据对象时，程序的逻辑比较清晰，易于阅读和维护，能以比较高的效率来开发高性能的应用。同时，在C++ API中还可以调用C API，两者结合使用，可以达到更好的效果。

4 Toolkit for Java/CORBA

4.1 功能简介

    这是一个for Java的工具包，能实现对Notes数据库中数据对象的处理，并对数据元素具有一定的处理能力：

• 数据处理
  • 文档：新建、拷贝、修改、删除、发送（作为邮件）
  • 视图：相当于记录集，可以用于获取文档或视图显示记录
  • 域：新建、修改、删除，支持RTF域、附件的处理
  • 数据库：新建、拷贝、复制、删除
• ACL控制
• 设计元素
  • 可以获取、运行、删除代理
  • 可以获取并删除视图、表单（包括字表单）
  • 可以创建大纲，并向大纲添加多个条目

    这个工具包命名为Toolkit for Java/CORBA，是因为在处理本地Notes数据库和远程数据库两种不同情况时，使用的技术有所不同。但在程序实现的接口上，两者基本相同，使得相同的代码实现可以适应不同的环境，为开发带来了便利。

最新版本
    v2.1 for R5.0.8，发布于2001.10.02

4.2 支持的Domino对象及结构

    如下图：

4.3 访问本地Notes应用

使用环境
    既然是访问本地Notes应用，无疑是安装了Domino/Notes软件的。此时，需要将notes.jar添加到classpath中（在Domino/Notes运行环境中会自动添加）。
    程序将使用notes.ini来获取当前用户。如果用户启动并且进入Notes客户端，当前用户ID设置为允许Notes外接程序共享标识符口令，则不用再次输入密码。

工作机理
    当从Java程序中使用本地Domino类时，实际上是通过瘦Java层直接访问了Domino后端用C++实现的代码。Java使用JNI机制来访问在动态链接库中的Domino类，Domino的代码被装载入JVM 的进程中。
    从性能角度来看，这是最好的选择：这提供了在Java和C代码间的最快的连接，所有的东西都在同一个内存空间中。
    但是Domino要求对每个线程的初始化和结束做特殊处理（与C/C++ API类似）。
    本地的Domino对象库提供了一个类，lotus.domino.NotesThread来自动的完成这种初始化处理和结束处理。如果使用NotesThread而不是java.lang.Thread来创建一个线程，Domino所需要的init/term调用都自动被执行。同时，NotesThread也是从Thread派生出来的，没有减少任何功能。如果使用NotesThread来创建线程，则需要调用NotesThread类的两个静态方法：sinitThread()和stermThread()，来完成初始化和结束处理。

4.4 访问远程Domino应用

使用环境
    只需要将NCSO.jar添加到客户端的classpath中就可以了，不再需要安装Notes客户端或者Domino。
    需要目标Domino服务器启动HTTP和DIIOP服务。
    在这种情况下，Domino会根据用户所提供的用户名/密码来验证用户身份。

工作机理
    Domino使用CORBA技术来实现Java程序对远程对象的访问。
    在这种情况下，Java程序不再需要在JVM的进程空间中访问任何Domino的C/C++代码，因此不需要做线程初始化和结束处理。因此，可以实例化Session对象、Database对象，使用类似于连接池的技术来重用这些对象，提高访问效率。
    在关闭session对象时，系统将自动关闭session中打开的各种Notes对象，例如数据库、视图、文档等，自动释放内存。在不关闭Session对象的情况下，则要注意随时关闭这些对象（使用recycle方法），否则这些对象所占用的内容不能被自动释放重用，严重时会导致系统崩溃。

    总之，Lotus Toolkit for Java/CORBA使用户可以摆脱对Notes客户端的依赖，自由地访问远程Domino服务器。同时它对Notes数据以外的对象处理能力有限，系统安全性相对较弱，性能上要低于C/C++ API。建议在网络环境比较安全、对数据访问速度要求不是特别高的情况下使用。

5 Lotus Domino Driver for Java

5.1 功能简介

    LDDJ是Type 2类型的JDBC Driver，符合JDBC1.0规范，在jdk1.1.8环境下开发的。它使得开发人员可以通过Java程序像访问关系数据库一样访问Domino/Notes数据库。
    下表是Notes数据库中的对象和关系数据库中对象之间的对照关系。

SQL 对象	Domino/Notes对象
Table	Form或者Universal Relation
Column	Form Field或者View Column
Index	View
View	View

和关系数据库相比，它有如下一些限制：

• 字符串最长为15360
• 表名最长64个字符
• 列名、索引名、视图名最长32个字符
• 不支持回滚和两阶段提交
• 不支持 BIT,TINYINT,BIGINT
• 不支持 BINARY,VARBINARY，即不支持大对象的存取
• 不支持Primary Key,Foreign Key,Unique
• 不支持存储过程

同时，提供如下特殊的功能：

• 列值允许为多值(文本)，可以存取，但不能通过JDBC创建这样的列
• 对于insert语句，域的缺省值、输入转换、输入校验依然有效
• delete table时，不删除数据
• 提供一些内置域，例如NotesID、NotesForm、LastModified等
• 读者域对阅读范围的控制依然有效

和其他方式对Notes数据处理相比，又有如下不同：

• 不可以插入不在表单定义中的 field
• 文档中存在多个同名的域，只处理第一个（按创建先后次序）
• 如果视图名和表单名相同，只能访问表对象，无法访问视图对象
• 对于RTF域，只能处理文字部分内容，不能处理附件
• 单个域内容最多为15360字节

支持平台
    Windows 98，NT 4.0，2000，XP

最新版本
    v1.5，发布于2002.10.11

5.2 开发和使用

使用环境
    LDDJ v1.5支持R5以上版本，可以直接连接远程Domino服务器，需要本地安装Domino/Notes，并且当前用户对远程数据至少具有读者权限。同时还需要将LDDJ包中的JdbcDomino.jar文件加到classpath中，将包中的几个dll文件拷贝到Windows的系统目录下（例如system32）。
    LDDJ和Notes 客户端使用相同的安全机制，使用Notes ID，如果用户启动并且进入Notes客户端，当前用户ID设置为允许Notes外接程序共享标识符口令，则不用再次输入密码。

工作机理
    LDDJ是Type 2的JDBC驱动，因此，本地需要Notes应用支持。其原理图如下：




开发
    使用LDDJ开发应用主要注意两点：
    第一，数据库url的语法。需要在url中指定服务器、数据库路径，设置文本域、富文本域的最大长度等设置。详细用法请看LDDJ的文档。
    第二，为了得到比较好的数据存取效率，需要合理地创建视图。视图建立的方式不同会对会对应用的效率产生极大的影响。