Lotus Domino和关系型数据库(LEI,DESC,JDBC连接)

Domino和关系数据库进行交互是日常项目开发中经常涉及到的一个方面，每个domino开发人员都写过这样的程序，本文就这个方面做一下简单的总结。
一、工具篇
1、使用LEI（Lotus Enterprise Integrator）
LEI的英文全称是Lotus Enterprise Integrator ，它是以前大家熟知的NotesPump的升级产品，是基于服务器的数据分布产品，提供了定义和管理以下事物的环境：
＊大量的数据交换
＊数据同步
:事件驱动和实时的数据传输
LEI服务器处理指令，建立到外部数据源的连接，按照定义好的活动的条件来传输数据．它要求Domino 4.6x 或 5.x以上版本的服务器，可以单独运行，也可以作为一个内部的服务器任务运行．
Lotus Enterprise Integrator (LEI) 6.x 可以将附件从 Domino 数据库移到 RDBMS 表中，从而可以从 RDBMS 内读取这些附件。更重要的是，此项操作可以快速进行，而不需要编写任何脚本代码。关于此方面，IBM官方网站上有对此操作的详细步骤说明，有兴趣的同行可以阅读一下，链接：http://www.ibm.com/developerwork ... achments/index.html
2、DESC（Domino Enterprise Connection Services ）
DECS的英文全称是Domino Enterprise Connection Services ，是LEI的子集，它仅仅是实时的Notes活动．DECS是一个基于向导器的服务器任务，包含于Domino 4.6.3及其以后的版本．它修改NOTES.INI文件以包括实时的扩展：extmgr_addins=ndecsext.dll (for NT)
下面，介绍一下DECS的用法，本文将以一个非常简单的例子为大家说明一下使用过程，更复杂的使用，大家可以据此做更深入的研究。我们以用notes导入一个Access数据库为例（该数据库已注册到ODBC中）  
预备工作：  
保证有你要导入的Notes数据库。  
保证有Access数据库  
保证ODBC已经加入该Access数据库数据源。  
第一步：  
如果你是第一次使用DECS,请查看你的服务器的DATA目录下是否有decsadm.nsf的数据库，如果没有这个数据库，要以Domino自带的名为decsadm.ntf的模板建立本数据库，关于DECS的相关设置都会在本数据库中进行。
第二步：  
在服务器的控制台上输入Load DECS,
第三步：
任务启动后，打开服务器上的Decsadm.nsf数据库。  
第四步：  
单击"Create Connection",创建一个连接。选择你要创建的数据库类型（DB2,Or I
acle,ODBC）。本例选择ODBC.
第五步：  
打开连接表单后：  
表单中有以下几项：  
Data Source:输入数据源。  
本例中输入ODBC中你要连接的数据源的名字。  
Username:输入能访问该数据源的用户名。
Password: 输入能访问该数据源的用户密码  Password encryption key:单击后对你填入的用户密码，在Notes中加密。  
Selection Type:你选择的类型是Table ,还是View  
:选择Table的拥有者。
Name: 选择你要连接哪一个Table.  
填完后保存退出。
第六步：  
单击"Create Activity",创建一个"动作"。系统提供了一个动作向导，单击"Create Activity",系统打开表单后弹出一个动作向导，如果你确定使用的话，单击"确定"。
选择你要导入到哪个Notes数据库。  
选择你要导入到该数据库的哪个表单。  
选择你使用哪个"连接"（第四步创建的）  
选择你到导入外部数据库的哪个Table和View.  
这时会出来Key和数据域的映射。
Key:是你的主索引。  
Field:是你要分别对应的字段。  
在左边选择Notes的域，右边选择外部数据库的字段。
选择你对外部数据库的动作Open,create,update,delete  
输入你为该导入动作取的名字。然后保存关闭当前文档。
第七步：
1．查看"Activities"导航，选定你要激活哪个"动作"  
单击"Start",启动该动作。  
如果不成功，你单击"log"，如果你想停止该动作请单击"Stop"  
图标说明：第一个图标表示该动作没激活，第二个图标表示动作正在激活，第三 个图标表示动作已激活。  
第八步：
1．打开你要导入的Notes数据库，用你刚才第六步第2点的表单创建文档。  
在你对应KEY的域中输入输入外部数据库的某一个数据。如：如果我把Access 数据库中table的ID字段作为key,而对应notes中的test域，那么我们就应该在test域中输入:如："10203"  
保存当前该文档。  
第九步：  
在视图中打开刚才创建保存的Notes文档。我们就会发现在其他映射的域都会出现 对应在外部数据库中的数据。这样外部数据库中的数据就引入到了Notes中了。
DECS与LEI存在一定的区别，大致可以概括为：
１ LEI提供了一个多功能的数据访问工具集，可以对其编程；DECS仅限于事先定义好的功能；２ LEI能处理大规模的数据传输，DECS仅工作在文档级；３ LEI 能适用于两个非Notes的数据源，DECS要求Notes作为一个数据源。
3、和DB2的数据交互
Domino在发布版本7的时候，就提供了Domino和DB2的数据集成功能，只是在这个版本上，IBM也只是做一下尝试，并不对此项功能进行技术支持以及其它的相关服务，随着Domino8的发布，IBM官方声明Domino8已经支持这个功能了，个人感觉，这里与其说是和DB2的数据交互，不如叫和DB2的数据共享。按照IBM提供的相关帮助文档，进行正确的配置以后，就可以达到将所有Domino的数据移植到DB2中，使Domino中的数据库只剩一个躯壳，所有真正的数据都存在DB2中，我查看了一下，这样配置之后，Domino中的数据库仅剩10几个字节，但是对用户来说，没有任何变化，这个功能非常强大，只可惜目前只支持DB2关系数据库，毕竟数据库也是人家自己的东西，也许在不久的将来会支持其它流行关系数据库吧，期待ing！对于这方面的使用，大家仔细参考帮助照做即可，这里就不多说了。
二、程序篇
1、使用ODBC
使用这个解决方案的前提条件，下面两个条件必具其一：
a、程序是运行在客户端，即：CS模式，且客户端所在操作系统是window系列；
b、程序运行在服务器，且服务器所在操作系统是windows系列；
本解决思路主要是使用Domino提供的三个类：ODBCConnection、ODBCQuery、ODBCResultSet，暂时手头上还没有这方面的例子，所以就不提供了，如果有的兄弟，请发上来，我编辑到本文章中，提前谢了。大家同样可以参考Designer的帮助，找到一些启示。
2、使用JDBC
一般情况下，不建议在Domino编程中使用java，这个众所周知，Lotus对Java的支持实在不敢恭维，但是如果受客观条件的限制，只能用JDBC，那就没办法了，比如我们公司，bs结构，服务器所在操作系统是Solaris，使用工具肯定不会去考虑，也不具备使用ODBC的条件，只能赶鸭子上架了，不过一般情况下，如果程序比较健壮，对于一些java对象做了合理的释放，短期内应该不会出现什么问题。言归正传，使用步骤：
a、找到oracle的jdbc驱动包：class12.jar；
b、或可在建立代理后，直接在设计端引入该jar包；或将该jar包上传到服务器，修改Notes.ini文件，增加JavaClasses参数进行引入；
c、下面给出一小段代码，这个相信大家也都很熟悉了，就不多说了，不过多一嘴，如果确认你所有的步骤都操作正确，java代理还是不能正确运行的话，可以尝试将代理的安全限制设置为：允许受限操作。
import lotus.domino.*;
import java.sql.*;
public class JavaAgent extends AgentBase {
public void NotesMain() {
Connection conn = null;
Statement stmt = null;
ResultSet rs = null
try {
Session session = getSession();
   AgentContext agentContext = session.getAgentContext();
   Class.forName("oracle.jdbc.driver.OracleDriver");
   String url = "jdbc racle:thinIP地址:1521 ROD";
   String user = "***";
   String password = "***";
   conn = java.sql.DriverManager.getConnection(url,user,password);
   stmt = conn.createStatement();
String sql = "select * from ra_salesreps_all";
rs = stmt.executeQuery(sql);
   while(rs.next()){
System.out.println(rs.getString("name"));   }
} catch(Exception e) {
{ e.printStackTrace();
  }finally{
  try{
    rs.close();
    stmt.close();
conn.close();
   }catch(SQLException sqle){
System.out.println(sqle);
}
}
}
}