diff options
author | Carlos Garnacho <carlosg@gnome.org> | 2017-07-10 23:55:57 +0200 |
---|---|---|
committer | Carlos Garnacho <carlosg@gnome.org> | 2017-07-11 19:15:07 +0200 |
commit | c36addc963768994d569623a1ddaeeff051720d5 (patch) | |
tree | d8f23b43d260b16c4d66bd7342c314117e3c1758 /src/libtracker-sparql | |
parent | 9c4874363b6818208e219ba5e67479a01c43f695 (diff) | |
download | tracker-c36addc963768994d569623a1ddaeeff051720d5.tar.gz |
libtracker-sparql: Deprecate TrackerSparqlBuilder
It has been superseded by TrackerResource, it is encouraged for new
development.
Diffstat (limited to 'src/libtracker-sparql')
-rw-r--r-- | src/libtracker-sparql/tracker-builder.vala | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/src/libtracker-sparql/tracker-builder.vala b/src/libtracker-sparql/tracker-builder.vala index 37ed03dfa..966ef93a0 100644 --- a/src/libtracker-sparql/tracker-builder.vala +++ b/src/libtracker-sparql/tracker-builder.vala @@ -25,6 +25,11 @@ * @stability: Stable * @include: tracker-sparql.h * + * <note> + * This object is deprecated since 2.0, use #TrackerResource to build + * SPARQL updates. + * </note> + * * <para> * #TrackerSparqlBuilder is an object what will gather a set of * subject/predicate/object triples, together with an optional WHERE clause, @@ -198,7 +203,9 @@ public class Tracker.Sparql.Builder : Object { * Opens an insertion statement. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void insert_open (string? graph) requires (state == State.UPDATE) { @@ -217,7 +224,9 @@ public class Tracker.Sparql.Builder : Object { * Opens a silent insertion statement. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void insert_silent_open (string? graph) requires (state == State.UPDATE) { @@ -235,7 +244,9 @@ public class Tracker.Sparql.Builder : Object { * Closes an insertion statement opened with tracker_sparql_builder_insert_open(). * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void insert_close () requires (state == State.INSERT || state == State.OBJECT) { @@ -259,7 +270,9 @@ public class Tracker.Sparql.Builder : Object { * a query to delete them. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void delete_open (string? graph) requires (state == State.UPDATE) { @@ -277,7 +290,9 @@ public class Tracker.Sparql.Builder : Object { * Closes a DELETE clause opened through tracker_sparql_builder_delete_open(). * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void delete_close () requires (state == State.DELETE || state == State.OBJECT) { @@ -298,7 +313,9 @@ public class Tracker.Sparql.Builder : Object { * Opens a GRAPH clause within INSERT, DELETE, or WHERE. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void graph_open (string graph) requires (state == State.INSERT || state == State.DELETE || state == State.OBJECT || state == State.WHERE || state == State.GRAPH) { @@ -313,7 +330,9 @@ public class Tracker.Sparql.Builder : Object { * Closes a GRAPH clause opened through tracker_sparql_builder_graph_open(). * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void graph_close () requires (state == State.GRAPH || state == State.OBJECT) { @@ -334,7 +353,9 @@ public class Tracker.Sparql.Builder : Object { * to which the update query applies. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void where_open () requires (state == State.UPDATE) { @@ -349,7 +370,9 @@ public class Tracker.Sparql.Builder : Object { * Closes a WHERE clause opened through tracker_sparql_builder_where_open(). * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void where_close () requires (state == State.WHERE || state == State.OBJECT) { @@ -369,7 +392,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a subject as a SPARQL variable, such as "?urn". * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void subject_variable (string var_name) { subject ("?%s".printf (var_name)); } @@ -382,7 +407,9 @@ public class Tracker.Sparql.Builder : Object { * Appends an object as a SparQL variable, such as "?urn". * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_variable (string var_name) { object ("?%s".printf (var_name)); } @@ -396,7 +423,9 @@ public class Tracker.Sparql.Builder : Object { * univocally identify a resource in tracker-store. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void subject_iri (string iri) { subject ("<%s>".printf (iri)); } @@ -409,7 +438,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a subject. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void subject (string s) requires (state == State.INSERT || state == State.OBJECT || state == State.EMBEDDED_INSERT || state == State.DELETE || state == State.WHERE || state == State.GRAPH) { @@ -429,7 +460,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a predicate as an IRI. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void predicate_iri (string iri) { predicate ("<%s>".printf (iri)); } @@ -442,7 +475,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a predicate for the previously appended subject. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void predicate (string s) requires (state == State.SUBJECT || state == State.OBJECT || state == State.BLANK) { @@ -463,7 +498,9 @@ public class Tracker.Sparql.Builder : Object { * Appends an object as an IRI. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_iri (string iri) { object ("<%s>".printf (iri)); } @@ -476,7 +513,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a free-form object for the previously appended subject and predicate. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object (string s) requires (state == State.PREDICATE || state == State.OBJECT) { @@ -500,7 +539,9 @@ public class Tracker.Sparql.Builder : Object { * by double quotes. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_string (string literal) requires (state == State.PREDICATE || state == State.OBJECT) { @@ -523,7 +564,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a string not validated as UTF-8 as an object. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_unvalidated (string value) { char* end; @@ -548,7 +591,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a #gboolean value as an object. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_boolean (bool literal) { object (literal ? "true" : "false"); } @@ -561,7 +606,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a #gint64 value as an object. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_int64 (int64 literal) { object (literal.to_string ()); } @@ -575,7 +622,9 @@ public class Tracker.Sparql.Builder : Object { * to a string in the date format used by tracker-store. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_date (ref time_t literal) { var tm = Time.gm (literal); @@ -590,7 +639,9 @@ public class Tracker.Sparql.Builder : Object { * Appends a #gdouble value as an object. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_double (double literal) { object (literal.to_string ()); } @@ -604,7 +655,9 @@ public class Tracker.Sparql.Builder : Object { * separate insertion. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_blank_open () requires (state == State.PREDICATE || state == State.OBJECT) { @@ -623,7 +676,9 @@ public class Tracker.Sparql.Builder : Object { * Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open() * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void object_blank_close () requires (state == State.OBJECT && states[states.length - 3] == State.BLANK) { @@ -642,7 +697,9 @@ public class Tracker.Sparql.Builder : Object { * Prepends raw, unvalidated content to @self. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void prepend (string raw) { str.prepend ("%s\n".printf (raw)); @@ -658,7 +715,9 @@ public class Tracker.Sparql.Builder : Object { * Appends raw, unvalidated content to @self. * * Since: 0.10 + * Deprecated: 2.0 */ + [Version (deprecated = true, deprecated_since = "2.0", replacement = "Tracker.Resource")] public void append (string raw) { if (state == State.OBJECT) { |