Lotus Domino Designer 8.5 ヘルプ - NotesFactory クラス

JAVA/CORBA クラス

NotesFactory クラス
例

アプリケーションで Session オブジェクトを作成するには、NotesFactory クラスの createSession メソッドを呼び出します。

Lotus Domino セッションを作成する

Lotus Notes のユーザー ID に基づいてローカル呼び出しを行うアプリケーションでは、次の方法で Session オブジェクトを作成します。この場合、Lotus Domino サーバーまたは Lotus Notes クライアントがローカルにインストールされている必要があります。

createSession() -- パスワードの検査は行われません。パスワードが必要な場合は、ユーザーにプロンプトが表示されます。
createSession((String)null, (String)null, (String)null) -- 上記と同じです。
createSession((String)null, (String)null, passwordString) -- パスワードが Lotus Notes のユーザー ID のパスワードと一致すればアクセス権が与えられます。
次のように createTrustedSession メソッドを使用して信頼されたセッションが作成されます。このメソッドがエージェントから呼び出されると、エラーがスローされます。
createTrustedSession() -- パスワードの検査は行われません。パスワードが必要な場合は、ユーザーにプロンプトが表示されます。
メモこの createTrustedSession メソッドは R8.0.1 で新しく追加されました。

サーバー上では、上記のメソッドは [読者] フィールドに従ってアクセスを制限します。フルアクセスを可能にするには、以下のメソッドを使用します。これらのメソッドはクライアント上でも動作しますが、クライアントでは不要です。

createSessionWithFullAccess() -- パスワードの検査は行われません。パスワードが必要な場合は、ユーザーにプロンプトが表示されます。
createSessionWithFullAccess(passwordString) -- パスワードが Lotus Notes のユーザー ID のパスワードと一致すればアクセス権が与えられます。
メモ createSessionWithFullAccess メソッドは、Release 6 で新しく追加されました。

Domino ディレクトリに基づいてローカル呼び出しを行うアプリケーションでは、次の方法で Internet Session オブジェクトを作成します。この場合、Lotus Domino サーバーがローカルにインストールされている必要があります。

createSession((String)null, "", "") -- ローカルの Domino ディレクトリにあるサーバーのサーバー文書によって匿名アクセスが許可されている場合は、セッションに匿名インターネットアクセス権が与えられます。2 番目のパラメータは、null ではなく空の文字列でなければなりません。
createSession((String)null, userString, passwordString) -- パスワードが Domino ディレクトリにあるユーザー文書のインターネットパスワードと一致すれば、セッションにインターネットアクセス権が与えられます。

ホストサーバーの Domino ディレクトリに基づきリモート (IIOP) 呼び出しを行うアプリケーションでは、次のように Internet Session オブジェクトを作成します。この hostString は、Lotus Domino サーバーのホスト名または IP アドレスを示します (Lotus Domino サーバー名ではありません)。ホスト名または IP アドレスの指定により、リモートインターフェースの使用方が決まります。「hostname:port (ホスト名-コロン-ポート番号)」という書式でホスト名の末尾にポート番号を指定すると、HTTP または DIIOP タスクは、このポート番号によって TCP (SSL を使用しない) 接続を受信します。

メモ

ポート番号を指定する機能は、Release 6 で新しく追加されました。

createSession(hostString, "", "") -- ホストの Domino ディレクトリにあるホストのサーバー文書によって匿名アクセスが許可されている場合は、セッションに匿名インターネットアクセス権が与えられます。2 番目のパラメータは、null ではなく空の文字列でなければなりません。
createSession(hostString, userString, passwordString) -- パスワードがホストの Domino ディレクトリにあるユーザー文書のインターネットパスワードと一致すれば、セッションにインターネットアクセス権が与えられます。

Internet Session は、該当するサーバー文書の [サーバーアクセス] と [プログラミングの制限] セクション、およびターゲットデータベースの ACL の [Web ユーザーによるアクセスの上限] セクション ([詳細] タブ) に従い、さらにアクセスを制限します。

シングルサインオンを使用してサーバーにアクセスするには、Internet Session オブジェクトを次のように作成します。リモート (IIOP) 呼び出しを行う場合は、最初のパラメータに Lotus Domino サーバーのホスト名または IP アドレスを指定します。ローカル呼び出しを行う場合は、最初のパラメータは null となります。

createSession(hostString, tokenString) -- トークンに基づいてセッションにインターネットアクセス権が与えられます。シングルサインオンには、Session.getSessionToken、WebSphere の使用する LtpaToken クッキー、またはサーブレット内の HTTP クッキーリストから取得した有効なトークンを使用する必要があります。
createSession(hostString, Credentials) -- org.omg.SecurityLevel2.Credentials オブジェクトに基づいてセッションにインターネットアクセス権が与えられます。このメソッドは、loginHelper を使用して Credentials オブジェクトが作成された WebSphere 環境で動作します。
createSession(hostString, (String)null) -- WebSphere 環境内の現在の Credentials オブジェクトに基づき、セッションにインターネットアクセス権が与えられます。このメソッドは、WebSphere 内の Enterprise JavaBeans (EJB) アプリケーションから動作します。
createSession(hostString, HttpServletRequest) -- Lotus Domino HTTP サーバーによる認証に基づき、セッションにインターネットアクセス権が与えられます。

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

SSL (セキュアソケットレイヤー) を有効にするには、String args[] パラメータを使用して args 配列の要素として「-ORBEnableSSLSecurity」を指定します。リモート (IIOP) アプリケーションの場合、クライアントは、サーバーのデータディレクトリにある domino/java の TrustedCerts.class に保存された、サーバーの信頼されたルートの証明書に対するアクセス権が必要です。このファイルは、DIIOP タスクの起動時に生成され、サーバー文書に指定された SSL ポートでの待機が可能になります。この HTTP タスクが各アプレットに TrustedCerts.class を配信します。他のアプリケーションの場合は、TrustedCerts.class が classpath 上にあることを確認してください。

createSessionWithIOR というメソッドは、IOR の明示的な指定により、インターネットセッションを取得します。通常、これは不要です。ホストを指定した createSession メソッドは getIOR を呼び出します。getIOR は、「ホスト名:ポート番号」によって「diiop_ior.txt」ファイルを受信する HTTP または DIIOP タスクを検索して、IOR を取得します。IOR を別の手段で取得できる場合は、createSessionWithIOR メソッドを使用します。

IOR を送れるのが HTTPS ポートだけの場合は、String args[] パラメータを使用して getIOR を呼び出し、arg 配列の要素として「-HTTPEnableSSLSecurity」を指定します。次に、返された IOR を createSessionWithIOR 呼び出しで使用します。

TrustedCerts.class 以外のファイルに、サーバーの信頼されたルートの証明書が含まれている場合には、arg 配列の要素として「-ORBSSLCertificates=filename」を指定します。notes.ini 変数として「DIIOP_DUP_KEYRING=filename」が指定されると、DIIOP タスクは TrustedCerts.class と複製ファイルを生成します。これは、別々の信頼されたルートの証明書を持つ 2 つのサーバーにアクセスする場合に役立ちます。

getIOR 操作は、SSL でも認証されません。

アクセスされる HTTP または HTTPS ポートで匿名アクセスが許可されていない場合は、user パラメータと passwd パラメータを指定して getIOR メソッドを使用します。

メモ args[]、user、および passwd の各パラメータを取る getIOR メソッドは Release 6.5 で新しく追加されました。

org.omg.CORBA.ORB パラメータを含む createSession メソッドは、既存の ORB を使用してセッションを作成します。ORB は、createORB メソッドのいずれかを使用して最初に作成します。複数のセッションに 1 つの ORB を使用する (接続プール) と、ネットワークオーバーヘッドが保存されます。ただし、この接続が、作成したセッションをすべて処理できることを確認してください。また、セッションを終了するときに recycle を実行するようにしてください。

アプレットに対しては AppletBase.openSession を使用してください。エージェントに対しては AgentBase.getSession を使用してください。

NotesFactory の仕様

NotesFactory クラスの仕様は次のとおりです。

public class NotesFactory { /* Local session - Notes client must be installed */ static public Session createSessionWithFullAccess() throws NotesException static public Session createSessionWithFullAccess(String passwd) throws NotesException static public Session createSession() throws NotesException /* Remote (IIOP) session using host name */ static public Session createSession(String host) throws NotesException static public Session createSession(String host, String user, String passwd) throws NotesException static public Session createSession(String host, String args[], String user, String passwd) throws NotesException static public Session createSession(String host, org.omg.CORBA.ORB orb, String user, String passwd) throws NotesException /* Remote (IIOP) session using IOR */ static public Session createSessionWithIOR(String IOR) throws NotesException static public Session createSessionWithIOR(String IOR, String user, String passwd) throws NotesException static public Session createSessionWithIOR(String IOR, String args[], String user, String passwd) throws NotesException static public Session createSessionWithIOR(String IOR, org.omg.CORBA.ORB orb, String user, String passwd) throws NotesException /* Remote (IIOP) session for applet */ static public Session createSession(java.applet.Applet app, String user, String passwd) throws NotesException static public Session createSession(java.applet.Applet app, org.omg.CORBA.ORB orb, String user, String passwd) throws NotesException /* For Single Sign-on */ static public Session createSession(String host, String cookie) throws NotesException static public Session createSession(String host, org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSession(String host, HttpServletRequest request) static public Session createSession(String host, String args[], String cookie) throws NotesException static public Session createSession(String host, String args[], org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSession(String host, String args[], HttpServletRequest request) throws NotesException static public Session createSession(String host, org.omg.CORBA.Orb orb, String cookie) throws NotesException static public Session createSession(String host, org.omg.CORBA.Orb orb, org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSession(String host, org.omg.CORBA.Orb orb, HttpServletRequest request) throws NotesException static public Session createSessionWithIOR(String IOR, String cookie) throws NotesException static public Session createSessionWithIOR(String IOR, org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSessionWithIOR(String IOR, HttpServletRequest request) static public Session createSessionWithIOR(String IOR, String args[], String cookie) throws NotesException static public Session createSessionWithIOR(String IOR, String args[], org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSessionWithIOR(String IOR, String args[], HttpServletRequest request) throws NotesException static public Session createSessionWithIOR(String IOR, org.omg.CORBA.Orb orb, String cookie) throws NotesException static public Session createSessionWithIOR(String IOR, org.omg.CORBA.Orb orb, org.omg.SecurityLevel2.Credentials token) throws NotesException static public Session createSessionWithIOR(String IOR, org.omg.CORBA.Orb orb, HttpServletRequest request) throws NotesException /* Login to Websphere with session using LPTA token */ static public Object getCredentials(Session sess) throws NotesException /* Create an ORB for connection sharing */ static public org.omg.CORBA.ORB createORB() static public org.omg.CORBA.ORB createORB(String args[]) static public org.omg.CORBA.ORB createORB(Properties props) /* Get IOR from host */ static public String getIOR(String host) throws NotesException; static public String getIOR(String host, String user, String passwd) throws NotesException; static public String getIOR(String host, String args[]) throws NotesException; static public String getIOR(String host, String args[], String user, String passwd) throws NotesException; }

例
関連項目

サポートコンポーネント

Java プログラムを実行する

用語集

フィードバック ヘルプ または プロダクトユーザビリティ

ヘルプの使い方

すべてのヘルプ項目

用語集