Simple search API proposal, take 2

Mikkel Kamstrup Erlandsen mikkel.kamstrup at
Thu Jan 11 02:48:26 PST 2007

One drawback of the current api proposal as found on is that you
request the hit properties you want when you retrieve them - not when
you start the query. If you specified what properties you want already
in the Query method the search engine could start retrieving these
properties before you call GetHitProperties.

Unfortunately this doesn't work well with requesting snippets in a
separate GetHitProperties call.

The only solution I see to this is to add a separate GetSnippets
method and move requested properties into the Query method. This would
give an api like:


Query (in s query_string, in as requested_properties, out s query_handle)

CountHits (in s query_handle, out i count)

GetHitProperties (in s query_handle, in i offset, in i limit, out
a{sa{sas}} response )

GetSnippets (in s query_handle, in as hit_handles)

here hit_handles (in GetSnippets) is a list of keys from the a{sa{sas}} map.

What do you think? Cheers,

More information about the xdg mailing list