Lotus Domino/Notes Toolkits 综述(注：转)
http://wind-bell.iteye.com/blog/64606 别人的博客。。我是黏过来的
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的文档。
第二，为了得到比较好的数据存取效率，需要合理地创建视图。视图建立的方式不同会对会对应用的效率产生极大的影响。
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的文档。
第二，为了得到比较好的数据存取效率，需要合理地创建视图。视图建立的方式不同会对会对应用的效率产生极大的影响。