Java访问Domino(Java,Domino,diiop,远程访问 )

http://hi.baidu.com/wangyan_0507/blog/item/502042073155bc7d02088194.html

一、概述

Java Domino Objects 的访问是通过高级包 lotus.domino 进行的。根据运行时环境,这个包中的接口是在其他两个包中的一个包中实现的:

lotus.domino.local 提供了从同一计算机上的 Notes/Domino 软件进行调用。
lotus.domino.cso
提供了从通过远程连接访问的 Domino 服务器进行调用。

对于本地访问,Java 程序运行在安装有 Notes 客户机或者 Domino 服务器的计算机上。本地类由 JNIJava Native Interface)构建来,用于访问与 JVMJava Virtual Machine)相同的进程中的 Notes/Domino 二进制文件。

对于远程访问,Java 程序使用 CORBACommon Object Request Broker Architecture)请求 Domino 服务器所提供的服务。远程类使用 CORBA 通过 TCP/IP 网络访问服务器。远程访问由以下两个部分组成:

1、客户机通过 HTTP 协议获得服务器的初始对象,作为 IOR Interoperable Object Reference)。
2
、客户机通过 IIOP 连接进一步获得其他对象。

 


Java 通过 HTTP IIOP 的远程访问

要编译使用 lotus.domino 包的 Java 程序,类路径必须包含 Notes.jar(本地)或者 NCSO.jar(远程)。例如:
set classpath=%classpath%;c:/lotus/domino/Notes.jar
或者
set classpath=%classpath%;c:/lotus/domino/data/domino/java/NCSO.jar
其中 Notes.jar 可以在任何 Notes/Domino 安装的程序目录中找到。NCSO.jar 可以在 Domino Designer Domino 服务器数据目录下的 domino/java 目录中找到。

这里只介绍远程调用。

二、远程调用

1Domino服务器设置:

首先进行domino服务器的设置,这是成功的关键步骤。
首先在服务器 Domino Directorynames.nsf)的 Server 文档的配置页面做如下配置
1)打开Internet协议页签的Http页签,设置"允许HTTP客户浏览数据库:是"
2)打开安全性页签,设置Java/Com限制。

  
运行有限制的java/javascript/com:*
  
运行无限制的
java/javascript/com:*
3)打开端口页签的Internet页签的IIOP页签,设置HTTP的端口号是63148,状态为启用设置验

证选 项的名称和口令:否,匿名:是

4)打开端口页签的Internet页签的web页签,设置HTTP的端口号是80,状态为启用,设置验证
选项的名称和口令:否,匿名:是

5)要在服务器上启动 HTTP DIIOP 任务,需要确保这些任务在 Notes.ini 文件
ServerTasks
变量的任务列表中,如果正确配置了 Server 文档该文件,那么这些任务应该包

含在任务列表中。Notes.ini 文件应该包含类似于下面的行:

ServerTasks=Update,Replica,Router,AMgr, AdminP,CalConn,Sched,DIIOP,HTTP,LDAP
从运行的服务器,可以在控制台中输入下列命令来加载任务:
> load http > load diiop
可以在控制台用 tell 命令停止任务:
> tell http quit > tell diiop quit
可以刷新 DIIOP 任务:
> tell diiop refresh
可以重新启动 HTTP 任务:
> tell http restart
6)获取 IOR。如果使用createSessionWithIOR创建连接。需要将diiop_ior.txt文件从服务
器计算机复制到客户机计算机上。该文件在服务器的安装目录的/Domino/Data/domino/html下。

2、连接domino服务器
在进行远程调用时,createSession 签名的第一个参数是非空字符串。第一个参数通常用来标识 Domino 服务器所在的计算机。例如:

Session s = NotesFactory.createSession("192.168.128.2")
或者

Session s = NotesFactory.createSession("192.168.128.2:63148")
第二个示例指定了端口号,这样就无需在 192.168.128.2上运行 Domino Web 服务器。

要从应用程序或者 servlet 执行远程调用,客户机计算机的类路径中必须包含 NCSO.jarNCSO.jar 包含 lotus.domino 包、lotus.domino.cso 包、lotus.domino.corba 包以及 ORB 类,ORB 类包含用于远程类的实现代码。对于已安装的 Domino Designer Domino 服务器软件,NCSO.jar 位于 Domino 数据目录下的 domino/java 子目录中。对于没有安装 Domino 软件的计算机,必须从安装该软件的计算机上复制jar文件,并放到classpath

编码比较简单。远程调用不使用 NotesThread。只需使用主机名称和(可选)端口号进行 createSession 调用即可。

import lotus.domino.*;
public class myClass
{
    public static void main(String argv[])   
    {   
        try   
            {       
                String host = "192.168.128.2";//
注意:有时候需要端口号
           
                Session s = NotesFactory.createSession(host);           
                // Operational code goes here
            }       
                catch(Exception e)
            {       
                e.printStackTrace();
            }
        }   
    }

以下是通过iiop访问domino的过程。
Domino 服务器上,IOR 是一个名为 diiop_ior.txt 的文件,位于 Domino 数据目录下的 domino/html 子目录中。IOR 是对象的字符串编码,包含对服务器的 CORBA 访问的识别信息。客户机会将字符串 IOR 解码,并用它来建立远程会话。

默认情况下,远程客户机通过 Web 服务器端口(其通常支持 HTTP 请求)来请求服务器 IOR,然后通过 DIIOP 端口进行会话请求。可以分别执行这两个请求。例如:

String ior = NotesFactory.getIOR("192.168.128.2");
// Get IOR using Web server port
Session s = NotesFactory.createSessionWithIOR(ior);
// Create session using DIIOP port
等价于:

Session s = NotesFactory.createSession("192.168.128.2");
NotesFactory 调用中,可以在主机名称或 IP 地址后面添加冒号和端口号,来指定用于获取 IOR 的主机端口。如果 Web 服务器没有运行,可以使用这种机制,通过 DIIOP 端口支持 IOR HTTP 请求,例如:
String ior = NotesFactory.getIOR("192.168.128.2:63148");
// Get IOR using DIIOP port
Session s = NotesFactory.createSessionWithIOR(ior);
// Create session using DIIOP port
然而,两步式编码顺序并不是必需的。可以将其简化为:
Session s = NotesFactory.createSession("192.168.128.2:63148");

注意:指定 DIIOP 端口来获取 IOR 的能力是 Notes/Domino 6 的新功能。现在就可以使用远程调用,无需允许对 Web 服务器的匿名访问,甚至无需启动 Web 服务器。

也可以通过其他方法获取 IOR,然后使用 createSessionWithIOR。例如,可以将 diiop_ior.txt 文件从服务器计算机复制到客户机计算机上。如果客户机上包含对将使用的服务器有效的 diiop_ior.txt 文件。

以下程序演示了如何访问domino库,如何查找文档,如何取得数据,如何下载附件,如何插入数据,如何上传附件。
-----------------------------------------------------------------------------------
测试环境:domino5.0.7
Domino
库名:
javatest.nsf
Form
名:
form1
域:

文本域:name1
时间域:
name2
整型域:
name3
Rtf
域:
name4
列表域:
name5
多值域:
name6
-----------------------------------------------------------------------------
package demo;
import lotus.domino.*;
import java.io.*;
import java.util.*;

public class JavaAccessDomino {
    public static void main(String argv[]) {
        try {
            FileInputStream fin = new FileInputStream(
                    "E:/JBWork/DominoApp/lib/diiop_ior.txt");
            InputStreamReader fisr = new InputStreamReader(fin);
            BufferedReader br = new BufferedReader(fisr);
            String ior = br.readLine();
            fin.close();
            //
通过diiop_ior取得session,需要把diiop_ior.txt放到本地

            Session s = NotesFactory.createSessionWithIOR(ior);
            //
也可以通过如下方法取得session,不需要把diiop_ior.txt放到本地,但必须启用domino Web server
            //ior = NotesFactory.getIOR("192.168.9.32"); // Get IOR using Web server port
            //s = NotesFactory.createSessionWithIOR(ior); // Create session using DIIOP port
            //
取得库对象

            Database db = s.getDatabase(s.getServerName(), "javatest.nsf");
            JavaAccessDomino obj = new JavaAccessDomino();
            obj.selectDoc(db);
            obj.insertDoc(db);
            db.recycle();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    /**
     *
遍历文档
     * @param db Database
     */
    public void selectDoc(Database db) {
        DocumentCollection docList = null;
        try {
            docList = db.getAllDocuments();
            if (docList != null) {
                System.out.println("database : " + db.getTitle() + " is " +
                                   ((int) (db.getSize() / 1024)) +
                                   "KB long and has " + docList.getCount() +
                                   " documents");
                Document doc = docList.getFirstDocument();
                while (doc != null) {
//                     System.out.println("=============name1="+doc.getItemValueString("name1"));
                    Vector items = doc.getItems();
                    for (int j = 0; j < items.size(); j++) {
                        Item item = (Item) items.elementAt(j);

                        if (item != null && item.getType() == 1280) { //表示是文本
                            System.out.println("/t" + item.getName() +
                                               "   =   /"" +
                                               item.getValueString() + "/"");
                        } else if (item != null && item.getType() == 1024) { //
表示是时间
                            System.out.println("/t" + item.getName() +
                                               "   =   /"" +
                                               item.getDateTimeValue() + "/"");
                        } else if (item != null && item.getType() == 768) { //
表示是整型
                            System.out.println("/t" + item.getName() +
                                               "   =   /"" +
                                               item.getValueInteger() + "/"");
                        } else if (item != null && item.getType() == 1) { //
表示是rtf
                            Item itmWjbt = doc.getFirstItem("$FILE");
                            if (itmWjbt != null) {
                                EmbeddedObject eo = doc.getAttachment(itmWjbt.
                                        getValueString());
                                FileOutputStream out = new FileOutputStream(
                                        "C:/" +
                                        itmWjbt.
                                        getValueString());

                                InputStream in = eo.getInputStream();
                                BufferedInputStream bufferedInputStream = new
                                        BufferedInputStream(in);
                                BufferedOutputStream bufferedOutputStream = new
                                        BufferedOutputStream(out);

                                byte[] data = new byte[1];
                                while (bufferedInputStream.read(data) != -1) {
                                    bufferedOutputStream.write(data);
                                }
                                //
将缓冲区中的数据全部写出

                                bufferedOutputStream.flush();
                                //
关闭流
                                bufferedInputStream.close();
                                bufferedOutputStream.close();
                            }
                        }
                    }
                    System.out.println("---------------------");
                    doc.recycle();
                    doc = docList.getNextDocument();
                }
            }

        } catch (NotesException ex) {
            ex.printStackTrace();
        } catch (Exception ex1) {ex1.printStackTrace();}
    }

    /**
     *
插入一个文档

     * @param db Database
     */
    public void insertDoc(Database db) {
        //
插入一条Document//
        Document newDoc = null;
        try {
            newDoc = db.createDocument();
            newDoc.appendItemValue("Form", "form1"); //
指定表单

            newDoc.appendItemValue("name1", "hello");
            newDoc.appendItemValue("name2", "2008-04-11");
            newDoc.appendItemValue("name3", "100");
            RichTextItem rti = (RichTextItem) newDoc.createRichTextItem(
                    "name4");
            String attachFilePath = "D:/
测试.doc";
            rti.embedObject(EmbeddedObject.EMBED_ATTACHMENT, null,
                            attachFilePath, attachFilePath); //
添加附件

            if (newDoc.save()) {
                System.out.println("
文档创建并保存成功");
            } else {
                System.out.println("
文档创建并保存失败
");
            }
        } catch (NotesException ex) {
            ex.printStackTrace();
        }
        ///
    }
}

以上程序在domino5.0.7下测试通过,如果domino的版本不一样,可能会有小的问题,关键是看能不能取得session. 如果运行通过不了,请仔细查看domino服务器的设置。

三、名词解析:

1DIIOP
IIOP
,是Internet Inter-ORB Protocol,一种传输层协议。它用于CORBA 2.0及兼容平台上。IIOP协议是要建立以下几个部分:一个IIOPHTTP的网关,使用这个网关可以让CORBA客户访问WWW资源;一个HTTPIIOP的网关,通过这个网关可以访问CORBA资源;一个为IIOPHTTP提供资源的服务器,一个能够将IIOP作为可识别协议的浏览器。
其中ORB呢,Object Request Broker(请求对象代理),一个中间件。它可以建立对象之间的client/server关系。通过ORB,一个client可以透明的引用同一台机器上或网络上的一个server对象的方法。ORB解释该调用并负责查找一个实现该请求的对象,找到后,把参数传给该对象,调用它的方法,最后返回结果。
那么,DIIOP就是Domino IIOP了,什么意思呢?就是一个服务器端的任务,通过Domino ORB,来使得Domino ServerJava applets交互,双方使用IIOP来交互和交换对象数据。

2IOR
IOR
Interoperable Object Reference

实际上,就是Domino服务器上的一个文件diiop_ior.txt,它在c:/lotus/domino/data/domino/html文件夹下。

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

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

3Domino对象
Domino
对象类的结构基于包容模型,包容模型定义了对象的范围。容器对象通常被用来访问它所包含的子对象。
关闭一个容器对象意味着其包含的全部子对象也将被关闭。例如,你建立了一个Database对象,使用它创建了一个Document对象,如果关闭了 Database对象,Document 对象也会随之关闭。如果容器对象超时,它将会被自动关闭,其包含的对象也将被自动关闭。因此你应该在容器对象超时或关闭前保存你的任何改变。
4
Domino Database
Domino
中的Database,指的是在一个名字下存储的,一个集合,包含了Document以及相应的formviewfolderJava中有lotus.domino.Database

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

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

6Domino Document
Domino
中的Document,指的是在一个Database的一个条目,包含了filedstextnumbersgraphics等等。Java中有lotus.domino.Document

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

参考:http://www.ibm.com/developerworks/cn/lotus/ls-java_access_pt1/
http://www.ibm.com/developerworks/cn/lotus/ls-java_access_2/

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值