Java™ を使用してすべての文書とすべての未処理の文書を収集する

Database の getAllDocuments を使用して、データベース内のすべてのデータ文書を含む DocumentCollection オブジェクトを取得します。現在のエージェントの指定に依存する文書、例えば、選択された文書、エージェントの最後の実行後に変更された文書などを取得するには、AgentContext の getUnprocessedDocuments を使用します。指定した時刻以降に修正された文書を取得するには、Database の getModifiedDocuments を使用します。

DocumentCollection クラスには、文書にアクセスするための次のプロパティとメソッドがあります。

• getFirstDocument と getNextDocument は、ループで最初の文書から順番に文書を取得するために使用できます。ループは次の文書が null になるまで継続します。
• getLastDocument と getPrevDocument は、ループで最後の文書から逆の順番で文書を取得するために使用できます。ループは前の文書が null になるまで継続します。
• getCount はコレクション内の文書数を取得するために、getNthDocument はコレクション内の一連の文書のうち特定の文書を取得するために使用できます。
• getDocument は、現在の文書コレクション内の指定された文書を検索します。

ループでは、パラメータを取らない getNextDocument と getPrevDocument メソッドを使用します。この 2 つのメソッドを使用したほうが、Document パラメータを取るメソッドよりも高いパフォーマンスを実現できます。特に、パラメータを取るメソッドでは、リモート (IIOP) 操作用のキャッシュが無効になります。パフォーマンス上の理由から、ループには getCount と getNthDocument は使用しないでください。

文書コレクション内の文書は、コレクションが検索の結果生成されたものである場合にだけ順序が付けられます。それ以外の場合は、文書は特定の順序にはなっていません。

DocumentCollection オブジェクトを作成した後に調整するには、addDocument と deleteDocument を使用します。

エージェントを使用して未処理文書の処理をする場合、それらの文書には更新済みとしてマークする必要があります。これは、エージェントを後で実行する際に古い文書として認識できるようにするためです。これには、NotesDocumentCollection の updateAll か AgentContext の updateProcessedDoc を使用します。

DocumentCollection クラスには、次のプロパティが含まれています。

• getCount は、コレクション内の文書数を含む int 型の値を返します。
• isSorted は、文書コレクションがソートされている場合に true を返します。
• getParent は、コレクションを含むデータベースを表す Database オブジェクトを返します。
• getQuery は、コレクションを作成した照会のテキストを含む String 型の値を返します。
• getUntilTime は、Database の getModifiedDocuments によって作成されたコレクションのデータベース終了時刻を表す DateTime オブジェクトを返します。