Java プログラムを実行する

サーバーの要件

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

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

ServerTasks=<any other tasks>,diiop

このタスクは、load console コマンドを使用して後から実行することもできます。

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

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

サーバーは、約 30 分ごとにセキュリティオプションのキャッシュを更新します。コンソールコマンド「tell diiop refresh」を実行すると、即座に強制的に更新します。

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

Designer の要件

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

スタンドアロンのアプリケーションには、classpath に Notes プログラムディレクトリの該当する Java ライブラリのサブディレクトリにある Notes.jar と、Notes データディレクトリの domino¥java¥NCSO.jar または domino¥java¥NCSO.cab を含めます。 以下に例を示します。

set CLASSPATH=.;c:¥notes¥jvm¥lib¥ext¥Notes.jar
set CLASSPATH=.;c:¥notes¥data¥domino¥java¥NCSO.jar

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

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

• NCSO.jar は JDK JAR ユーティリティ (圧縮する) を使用します。
• NCSO.cab は Microsoft CABARC ユーティリティを使用します。
  注: 以前のリリースでは NCSO.jar (圧縮しない) と NCSOC.jar (圧縮する) を使用していました。

クラスコードでは、次の上位レベルの lotus.domino パッケージをインポートしなければなりません。

import lotus.domino.*;

ランタイムの要件

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

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

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

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

Java オブジェクトのメモリ管理

Java をオブジェクトの作成に使用すると、Java オブジェクトと Notes バックエンド (C++) オブジェクトの 2 つのオブジェクトが作成されます。Java オブジェクトが NULL に設定され、ガーベッジコレクション用にフラグが付けられても、C++ オブジェクトは影響を受けません。Java オブジェクトと C++ オブジェクトの両方にガーベッジコレクション用のマークを付けるには、recycle メソッドを使用する必要があります。

オブジェクトが Java エージェント内から作成された場合、作成されたすべてのオブジェクト (Java と C++ の両方) は、エージェントの終了時に破壊されます。ただし、長時間実行エージェントまたは多数のオブジェクトを作成するエージェントの場合は、recycle メソッドの使用を考慮してください。サーブレット、JSP、またはスタンドアロン Java アプリケーションを使用する場合、バックエンドオブジェクトを削除するには recycle メソッドを使用する必要があります。

文書などの親を再利用すると、アイテムなどのそのすべての子も再利用されます。セッションを再利用すると、それが使用してきたすべてのオブジェクトも再利用されます。

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 から継承できないため、静的なメソッドを使用する必要があります。

  「NotesThread クラス」の項の下の「マルチスレッドの問題」を参照してください。

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

  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 クライアントへの出力にも同様に動作します。詳しくは、例を参照してください。
• (AgentBase クラスの拡張によって) NotesThread クラスを使用するプログラムを終了するために System.exit を使用しないでください。エージェントでは、System.exit により SecurityException が発生します。アプリケーションでは、System.exit によって何らかの破損が生じる場合があります。

lotus.domino クラスを使用する

lotus.domino クラスにより、特定のデータベース、ビュー、文書、その他のバックエンドオブジェクトにアクセスできます。次の lotus.domino クラスは、直接でパブリックな使用を目的としています。

• 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 は、ビューのナビゲータを表します。