lotus.domino パッケージをインポートすることにより、Java プログラムから Domino オブジェクトを呼び出せます。プログラムは、アプリケーション、Domino エージェント、アプレット、またはサーブレットとしてコーディングできます。ローカル呼び出しはローカルコンピュータ上のランタイムコードにアクセスしますが、このコンピュータには Domino がインストールされている必要があります。CORBA に準拠したリモート (IIOP) 呼び出しはリモート Domino Server からランタイムコードにアクセスしますが、この場合はローカルコンピュータに Domino がインストールされている必要はありません。コンパイルは、Domino Designer がインストールされているコンピュータで行う必要があります。

メモ Notes/Domino 7 では、Sun Java(TM) 2 Platform、Technology Edition、v 1.4.2 がサポートされます。非互換を避けるため、以前の Domino Server または Notes Client において 7 でコンパイルした Java エージェントを実行しないでください。v. 1.4.2 以下の Java Platform において、7 Java アーカイブ (Notes.jar、NCSO.jar、domtags.jar) を使用しないでください。

メモ lotus.domino パッケージの内容は、R4.6 lotus.notes のパッケージと同様の内容に新しいクラス、メソッド、その他の拡張を加えたものです。R4.6 lotus.notes パッケージは、従来のものとの互換性のためだけにサポートを続けられます。新しいクラス、メソッド、その他の拡張は含まれません。

要件
サーバーの要件
CORBA に準拠したリモート (IIOP) 呼び出しには、Domino Server へのアクセスが必要です。

サーバータスクの HTTP と DIIOP を実行する必要があります。サーバーの notes.ini ファイルに次の行が含まれていることを確認してください。

ServerTasks=<any other tasks>,http,diiop

これらのタスクは、load console コマンドを使って後で開始することもできます。

メモ JavaMaxHeapsize の値を 64M 以下に下げないでください。64M 以下に下げると、nhttp.exe を実行しようとしたときに実行時エラーが発生します。JavaMaxHeapsize の値をサーバーの notes.ini ファイルで設定しない場合は、64M が使用されます。

Domino ディレクトリ ([サーバー] - [サーバー] の下) のサーバー文書で、必要に応じて CORBA に準拠したリモート呼び出しの許可と制限を指定します。詳しい説明を表示するには、フィールドの説明を右クリックします。

• セキュリティ:
  • [サーバーアクセス] セクションで、必要に応じて [サーバーへアクセス可]、[サーバーへアクセス不可]、[新規データベースの作成]、[複製データベースの作成] を指定します。
  • [プログラミングの制限] セクションで、必要に応じて [制限なしメソッドと操作の実行]、[制限付き LotusScript/Java エージェントの実行] を指定します。これらのフィールドは、プログラミング可能なすべてのインターフェースに適用されるので、リモートアクセス用に必ず指定してください。
  メモ これらの設定は、Release 6 で新しく追加されました。
  • [インターネットアクセス] - [インターネット認証] セクションで、ユーザー名を検証するための包括的なビューを適宜指定します。
  メモ この検証は、R5.0.1 で新しく追加されました。
• ポート:
  • [インターネットポート] - [IIOP] タブで、名前とパスワードによるアクセスが許可されるかどうか、また匿名アクセスが許可されるかどうかを指定します。
• インターネットプロトコル:
  • [HTTP R5] タブの [基本情報] セクションで、HTTP クライアントからのデータベース参照を許可するかどうかを指定します。[いいえ] を選択すると、DbDirectory.getFirstDatabase がデータベースを参照できなくなります。
  メモ この検証は、R5.0.1 で新しく追加されました。
  • [IIOP] タブで、CORBA に準拠したリモート呼び出しの処理用に割り当てるスレッドの数を指定します。
  メモ この制限は、Release 6 には適用されません。

CORBA に準拠した Domino オブジェクトアプリケーションまたはアプレットの SSL セキュリティは、Web サーバーの SSL セキュリティの上に築かれます。最初に、「Domino R5 認証機関」アプリケーションを使って Web サーバーのセキュリティをセットアップする必要があります。

Designer の要件
lotus.domino パッケージを使って Java プログラムをコンパイルするには、Domino Designer R5 以上をインストールする必要があります。

スタンドアロンのアプリケーションには、classpath に Notes プログラムディレクトリの Notes.jar および Notes データディレクトリの domino\java\NCSO.jar、または domino\java\NCSO.cab を含めます。次に例を示します。

set CLASSPATH=.;c:\notes\data\domino\java\NCSO.jar;c:\notes\Notes.jar

Notes.jar には、上位レベルの lotus.domino パッケージ、ローカル呼び出し用の lotus.domino.local パッケージ、古い lotus.notes パッケージが含まれています。NCSO アーカイブには、上位レベルの lotus.domino パッケージと、リモート呼び出し用の lotus.domino.cso パッケージが含まれています。厳密には、CORBA に準拠したリモート呼び出しをコンパイルしない場合は NCSO アーカイブは必要なく、ローカル呼び出しや古い呼び出しをコンパイルしない場合は Notes.jar は必要ありません。

これらの 3 つの NCSO アーカイブは、内容は同じですが、アーカイブ方法は異なります。

• NCSO.jar は JDK JAR ユーティリティ (圧縮する) を使用します。
• NCSO.cab は Microsoft CABARC ユーティリティを使用します。

  メモ 以前のリリースでは NCSO.jar (圧縮しない) および NCSOC.jar (圧縮する) を使用していました。

import lotus.domino.*;

ランタイムの要件
ローカルな Domino 呼び出しを行う Java アプリケーションを実行するコンピュータには、Domino Server、Domino Designer、または Notes Client がインストールされている必要があり、classpath に Notes.jar が含まれている必要があります。

リモートな Domino 呼び出しを行う Java アプリケーションを実行するコンピュータには、Domino または Notes がインストールされている必要はありませんが、NCSO アーカイブのいずれか 1 つが含まれていて、それが classpath に含まれている必要があります。

Domino 呼び出しを行う Domino エージェントを実行するコンピュータでは、classpath に Notes.jar が含まれている必要があります。

Domino 呼び出しを行うアプレットを実行するコンピュータでは、Domino ソフトウェアや classpath の割り当ては不要です。このアプレットは、Domino Server がインストールされているコンピュータからロードされなければなりません。

メモ WebSphere(R) 環境でリモート (IIOP) 呼び出しを実行する場合は、classpath に NCSOW.jar を使用しないでください。NCSOW.jar は R5.0.4 から提供を開始されたもので、現在ではキットに含まれていません。R5 サーバーでは NCSOW.jar を使用するプログラムを実行できますが、R6 サーバーでは実行できません。NCSO アーカイブは、R5 サーバーおよび Release 6 サーバーの両方で使用できます。

lotus.domino パッケージを呼び出す
次のガイドラインは、lotus.domino パッケージへの呼び出しを行う Java プログラムに適用されます。

• ローカル呼び出しを行うアプリケーションまたはサーブレットは NotesThread クラスを使います。これは java.lang.Thread から派生しています。NotesThread の拡張 (extends)、Runnable インターフェースの実装 (implements)、static な NotesThread メソッドである sinitThread() と stermThread() の使用が可能です。NotesThread を拡張する場合、関数コードのエントリポイントは、public void runNotes() でなければなりません。Runnable を実装する場合、エントリポイントは public void run() でなければなりません。静的な NotesThread メソッドを使う場合は、sinitThread への呼び出しそれぞれについて stermThread を一度だけ呼び出すようにしてください。CORBA に準拠したリモート呼び出しを行うアプリケーションは NotesThread クラスを使いません。詳しくは、例を参照してください。

  ローカル呼び出しを行うアプリケーションの各スレッドは、NotesThread オブジェクトを初期化しなければなりません。これには、Domino オブジェクトにアクセスする AWT スレッドが含まれます。リスナースレッドは NotesThread から継承できないので、静的なメソッドを使う必要があります。

  長時間実行されるプログラムや、大量のオブジェクトを作るプログラムに関しては、メモリ管理を考慮しなければなりません。recycle メソッドと、「マルチスレッドの問題」を「NotesThread クラス」の項で参照してください。

• エージェントは、AgentBase クラスから派生しています。これは NotesThread クラスの拡張です。エージェントのコードを含むクラスは、パブリックなクラスでなければなりません。関数コードのエントリポイントは public void NotesMain() でなければなりません。詳しくは、例を参照してください。
• アプレットは、AppletBase から派生し、その関数コードはメソッド notesAppletInit()、notesAppletStart()、notesAppletStop() に置かれます。ローカルなアクセスとリモートなアクセスを main コード内で区別する必要はありません。AppletBase は、アプレットが Notes Client 経由で実行されている場合はローカル呼び出しを行い、ブラウザ経由で実行されている場合は CORBA に準拠したリモート呼び出しを行います。リモート呼び出しは、アプレットをロードしたコンピュータ上の Domino Server に向かいます。

  Domino 呼び出しを含むスレッドをアプレットで作成する場合は、スレッドコードではローカルな Domino 呼び出しに NotesThread を使う必要があります。リモート (IIOP) 呼び出しには使う必要はありません。環境を判断するには AppletBase.isLocal() を使います。初期化には NotesThread.sinitThread を使い、終了には NotesThread.stermThread を使います。スレッドの作成には AWT イベントの処理が含まれます。

  詳しくは、例を参照してください。

  Domino データベースに保存されるアプレットについては [Java アプレット] - [Java アプレットプロパティ] の [Notes CORBA クラスを使用] を選択してください。

• Session クラスは、Domino のバックエンドオブジェクトの包含関係階層でルートに位置します。ローカル呼び出しを行うアプリケーションには、NotesFactory クラスのメソッド createSession()、createSessionWithFullAccess()、createSession(null, null, String pwd)、createSessionWithFullAccess(String pwd)、createSession(null, String user, String pwd)、createSession(null, "", "") のいずれかを使って、Session オブジェクトを作成します。リモート呼び出しを行うアプリケーションには、メソッド createSession(String host, "", "") または createSession(String host, String user, String pwd) を使います。エージェントには、メソッド AgentBase.getSession() を使います。アプレットには、メソッド AppletBase.openSession() または AppletBase.openSession(String user, String pwd) および AppletBase.closeSession(Session session) を使います。詳しくは、例を参照してください。

  NotesFactory.createSession と AppletBase.openSession の user と pwd パラメータは、アクセス先のサーバーの Domino ディレクトリ内のユーザー名とインターネットパスワードとする必要があります。名前とパスワードが指定されない場合は、サーバーによって匿名アクセスが許可されます。

  Domino または WebSphere サーバーに対してシングルサインオンを行うには、createSession(String host, String token)、createSession(String host, org.omg.SecurityLevel2.Credentials token)、createSession(String host, null)、createSession(String host, HttpServletRequest request) のいずれかを使います。

  メモ シングルサインオンは、R5.0.5 で新しく追加されました。

  SSL (Secure Sockets Layer) を有効にするには、NotesFactory.createSession(String host, String args[], String user, String pwd) を使用して、args(0) に「-ORBEnableSSLSecurity」と指定します。

• フォアグラウンドのエージェントの場合、System.out と System.err は Java のデバッグコンソールに出力されます。ローカルにスケジュールされたエージェントの場合は、System.out および System.err は Domino ログに出力されます。
• (アプレット以外の) エージェントから Web ブラウザに出力するには、AgentBase クラスの getAgentOutput() メソッドを使って java.io.PrintWriter オブジェクトを割り当て、PrintWriter オブジェクトの println メソッドを使って書き込む必要があります。このメソッドは、Notes Client への出力にも同様に動作します。詳しくは、例を参照してください。
• (AgentBase クラスの拡張によって) NotesThread クラスを使用するプログラムを終了するために System.exit を使ってはなりません。エージェントでは、System.exit により SecurityException が発生します。アプリケーションでは、System.exit によって何らかの破損が生じる場合があります。

• ACL は、データベースのアクセス制御リストの全エントリのコレクションを表します。
• ACLEntry は、アクセス制御リストの 1 つのエントリを表します。
• AdministrationProcess は、管理プロセスを表します。
• Agent は、エージェントの属性を表します。
• AgentContext は、プログラムがエージェントとして実行されている場合の現在のエージェントのコンテキストを表します。
• ColorObject は、色を表します。
• Database は、Domino データベースを表します。
• DateRange は、日付と時間の範囲を表します。
• DateTime は、Domino の日付/時刻を表します。
• DbDirectory は、サーバーまたはローカルコンピュータ上のデータベースファイルを表します。
• Document は、データベースにある文書を表します。
• DocumentCollection は、文書コレクションを表します。
• DXLExporter は、 Domino データから DXL (Domino XML) への変換を表します。
• DXLImporter は、DXL (Domino XML) から Domino データへの変換を表します。
• EmbeddedObject は、埋め込みオブジェクト、リンク、添付ファイルを表します。
• Form は、データベースにあるフォームを表します。
• International は、オペレーティングシステムの国別設定値を表します。
• Item は、文書内のデータのアイテムを表します。
• Log は、スクリプトの実行中に発生したエラーとアクションを表します。
• MIMEEntity は、MIME (Multipurpose Internet Mail Extensions: 多目的インターネットメール拡張) タイプのアイテムを表します。
• MIMEHeader は、MIME ヘッダーを表します。
• Name は、ユーザー名またはサーバー名を表します。
• NewsLetter は、ほかの文書からの情報やほかの文書へのリンクを含む概要文書を表します。
• NoteCollection は、データベース内の Domino の設計とデータ要素のコレクションを表します。
• Outline は、アウトラインを表します。
• OutlineEntry は、アウトラインのエントリを表します。
• Registration は、ID ファイルの作成または管理を表します。
• Replication は、Domino データベースの複製の属性を表します。
• ReplicationEntry は、データベースにある一対のサーバーの複製に関する属性を表します。
• RichTextDoclink は、リッチテキストアイテム内の doclink を表します。
• RichTextItem は、リッチテキストを含むアイテムを表します。
• RichTextNavigator は、リッチテキストアイテム内のナビゲーション手段を表します。
• RichTextParagraphStyle は、リッチテキストの段落スタイル属性を表します。
• RichTextRange は、リッチテキストアイテム内の要素範囲を表します。
• RichTextSection は、リッチテキストアイテム内の省略可能なセクションを表します。
• RichTextStyle は、リッチテキストのスタイル属性を表します。
• RichTextTab は、リッチテキストのタブ属性を表します。
• RichTextTable は、リッチテキストアイテム内の表を表します。
• Session は、現在のプログラムのコンテキストを表します。このクラスは、Domino データベースのオブジェクトのルートです。
• Stream は、バイナリストリームまたは文字データを表します。
• View は、データベース内のビューまたはフォルダを表します。
• ViewColumn は、ビューの列を表します。
• ViewEntry は、ビューのエントリを表します。
• ViewEntryCollection は、ビューエントリのコレクションを表します。
• ViewNavigator は、ビューのナビゲータを表します。

Java クラスのコーディングのガイドライン