InfoDirectory使用手引書

5.1.5.2 検索結果のソート処理

　検索結果のソート処理におけるコントロールリクエストの形式は、以下のインターネットドラフトに記述されています。

“LDAP Control Extension for Server Side Sorting of Search Results”

処理の概要

　以下にソート処理の例を示します。

図: ソート処理の例

 

ソート処理の流れ

1. 検索要求の送信

   　クライアントは、検索要求にserverSortControlを付加してInfoDirectoryサーバに送信します。この時、ソートキー・リストもInfoDirectoryサーバに送信されます。

2. エントリの検索／ソート

   　InfoDirectoryサーバは、クライアントが指定した条件にしたがってエントリを検索します。
   検索が完了したら、serverSortControlで指定されたソートキーにしたがって、ヒットしたエントリをソートした後、クライアントに送信します。

3. エントリの受信

   　クライアント側では、クライアントが指定した順番でソートされたエントリを受信します。このため、クライアントにおけるエントリの並び替えは不要です。

4. result情報受信

   　InfoDirectoryサーバは、検索結果をクライアントに通知します。この時、result情報に付加されているserverSortResultには、ソート処理の結果が設定されています。

    

リクエスト

　検索結果のソート処理を使用する場合、InfoDirectoryサーバへの要求を発行する際に、サーバコントロールに以下のデータを指定します。

• コントロールタイプ ： “1.2.840.113556.1.4.473”
  　
• クリティカルフラグ ： TRUE または FALSE
  　
• コントロールリクエスト ： 以下のデータを指定します。
  　

  　SortKeyList ::= SEQUENCE OF SEQUENCE {
  　　　　　AttributeType AttributeDescription,
  　　　　　OrderingRule [0] MatchingRuleId OPTIONAL,
  　　　　　ReverseOrder [1] BOOLEAN DEFAULT FALSE
  　}

  • AttributeType ： ソートのキーとなる属性
  • OrderingRule ： 比較のルール
  • ReverseOrder ： ソートの順番
  • FALSE ： 昇順（未サポート）
  • TRUE ： 降順

  　コントロールリクエストに指定するデータは、BERエンコードしたものを指定します。

   

レスポンス

　検索結果のソートを要求した場合、処理結果として以下のコントロールレスポンスが通知されます。

• コントロールタイプ ： “1.2.840.113556.1.4.474”
• クリティカルフラグ ： FALSE
• コントロールレスポンス ： 以下の形式のデータが通知されます。
  　

  　SortResult ::= SEQUENCE {
  　　　　　sortResult ENUMERATED {
  　　　　　　　　　success (0), -- results are sorted
  　　　　　　　　　operationsError (1), -- server internal failure
  　　　　　　　　　timeLimitExceeded (3), -- timelimit reached before sorting was completed
  　　　　　　　　　strongAuthRequired (8), __ refused to return sorted results via insecure

  protocol
  　　　　　　　　　adminLimitExceeded (11), -- too many matching entries for the server to

  sort
  　　　　　　　　　noSuchAttribute (16), -- unrecognized attribute type in sort key
  　　　　　　　　　inappropriateMatching (18), -- unrecognized or inappropriate matching

  rule in sort key
  　　　　　　　　　insufficientAccessRights (50), -- refused to return sorted results to

  this client
  　　　　　　　　　busy (51), -- too busy to process
  　　　　　　　　　unwillingToPerform (53), -- unable to sort
  　　　　　　　　　other (80)
  　　　　　},
  　　　　　attributeType [0] AttributeType OPTIONAL
  　}

  • sortResult ： ソートの結果
  • attributeType ： 属性
    エラー発生時に、ソートキーとして指定された属性が通知されます（未サポート）。

  　コントロールレスポンスのデータは、BERエンコードされたものが設定されています。