query
Description:
public Feed query (AuthorizationDomain? domain, string feed_uri, Query? query, Type entry_type, Cancellable? cancellable, QueryProgressCallback? progress_callback) throws Error
Queries the service's feed_uri feed to build a Feed.
If cancellable is not null, then the operation can be cancelled by triggering the cancellable object
from another thread. If the operation was cancelled before or during network activity, the error
CANCELLED will be returned. Cancellation has no effect after network
activity has finished, however, and the query will return successfully (or return an error sent by the server) if it is first cancelled after
network activity has finished. See the overview of cancellation for more details.
A PROTOCOL_ERROR will be returned if the server indicates there is a problem with the query, but subclasses may override this and return their own errors. See their documentation for more details.
For each entry in the response feed, progress_callback will be called in the main thread. If there was an error parsing the XML
response, a ParserError will be returned.
If the query is successful and the feed supports pagination, query will be updated with the pagination URIs, and the next or
previous page can then be loaded by calling next_page or
previous_page before running the query again.
If the Query's ETag is set and it finds a match on the server, null will be
returned, but error will remain unset. Otherwise, query's ETag will be updated with the ETag from the returned feed,
if available.
Parameters:
| this |
a Service |
| domain |
the AuthorizationDomain the query falls under, or |
| feed_uri |
the feed URI to query, including the host name and protocol |
| query |
a Query with the query parameters, or |
| entry_type | |
| cancellable |
optional Cancellable object, or |
| progress_callback |
a QueryProgressCallback to call when an entry is loaded, or
|
| progress_user_data |
data to pass to the |