Add comments for _build_paginate_query

Add comments for _build_paginate_query which will called
_recurse_sort_keys. It will generate the query criteria
recursively if multiple sort keys passed in.

Change-Id: I102308fc1a57f1ba8bd96e64badedbcf60840c28
This commit is contained in:
Fengqian Gao 2014-02-19 15:45:10 +08:00
parent b8dfacf7d8
commit 58bd49ee95

View File

@ -547,6 +547,14 @@ class Connection(base.Connection):
sort_criteria_list = []
for i in range(len(sort_keys)):
#NOTE(fengqian): Generate the query criteria recursively.
#sort_keys=[k1, k2, k3], maker_value=[v1, v2, v3]
#sort_flags = ['$lt', '$gt', 'lt'].
#The query criteria should be
#{'k3': {'$lt': 'v3'}, 'k2': {'eq': 'v2'}, 'k1': {'eq': 'v1'}},
#{'k2': {'$gt': 'v2'}, 'k1': {'eq': 'v1'}},
#{'k1': {'$lt': 'v1'}} with 'OR' operation.
#Each recurse will generate one items of three.
sort_criteria_list.append(cls._recurse_sort_keys(
sort_keys[:(len(sort_keys) - i)],
marker, _op))