diff options
| author | Carlos Garnacho <carlosg@gnome.org> | 2022-12-09 15:27:59 +0100 |
|---|---|---|
| committer | Carlos Garnacho <carlosg@gnome.org> | 2023-01-11 18:32:02 +0000 |
| commit | b00a64a84f0f10c815a4df1d908c9fb0ddb13aac (patch) | |
| tree | 514838bec0a098f39c66503b4bd8354d1cdaef8b /src/libtracker-sparql/tracker-connection.h | |
| parent | 651f6aef7689d304d218b6ba5bb57386b53a4d0c (diff) | |
| download | tracker-b00a64a84f0f10c815a4df1d908c9fb0ddb13aac.tar.gz | |
libtracker-sparql: Deprecate tracker_sparql_connection_update_blank*()
Per the spec (https://www.w3.org/TR/sparql11-query/#BGPsparqlBNodes):
Since SPARQL treats blank node identifiers in a results format document
as scoped to the document, they cannot be understood as identifying
nodes in the active graph of the dataset.
This is precisely what tracker_sparql_connection_update_blank() (and async
variant) are doing. While that works given the interpretation of blank
nodes in a TrackerSparqlConnection with default flags, this is precisely
what TRACKER_SPARQL_CONNECTION_FLAGS_ANONYMOUS_BNODES implements, and at
best it is not great to advise this inconsistency as public API.
It is best to deprecate this set of functions, any user should devise
their own IRI generation scheme, instead of relying on blank nodes being
sort of one.
Diffstat (limited to 'src/libtracker-sparql/tracker-connection.h')
| -rw-r--r-- | src/libtracker-sparql/tracker-connection.h | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/src/libtracker-sparql/tracker-connection.h b/src/libtracker-sparql/tracker-connection.h index b55438726..d0923c9cd 100644 --- a/src/libtracker-sparql/tracker-connection.h +++ b/src/libtracker-sparql/tracker-connection.h @@ -189,18 +189,18 @@ gboolean tracker_sparql_connection_update_resource_finish (TrackerSparqlConnecti TRACKER_AVAILABLE_IN_3_1 TrackerBatch * tracker_sparql_connection_create_batch (TrackerSparqlConnection *connection); -TRACKER_AVAILABLE_IN_ALL +TRACKER_DEPRECATED_IN_3_5 GVariant * tracker_sparql_connection_update_blank (TrackerSparqlConnection *connection, const gchar *sparql, GCancellable *cancellable, GError **error); -TRACKER_AVAILABLE_IN_ALL +TRACKER_DEPRECATED_IN_3_5 void tracker_sparql_connection_update_blank_async (TrackerSparqlConnection *connection, const gchar *sparql, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); -TRACKER_AVAILABLE_IN_ALL +TRACKER_DEPRECATED_IN_3_5 GVariant * tracker_sparql_connection_update_blank_finish (TrackerSparqlConnection *connection, GAsyncResult *res, GError **error); |