Class
TsparqlResource
Description [src]
final class Tsparql.Resource : GObject.Object
{
/* No available fields */
}
TrackerResource
is an in-memory representation of RDF data about a given resource.
This object keeps track of a set of properties for a given resource, and can
also link to other TrackerResource
objects to form trees or graphs of RDF
data. See tracker_resource_set_relation()
and tracker_resource_set_uri()
on how to link a TrackerResource
to other RDF data.
TrackerResource
may also hold data about literal values, added through
the specialized tracker_resource_set_int64()
, tracker_resource_set_string()
,
etc family of functions, or the generic tracker_resource_set_gvalue()
method.
Since RDF properties may be multi-valued, for every set
call there exists
another add
call (e.g. tracker_resource_add_int64()
, tracker_resource_add_string()
and so on). The set
methods do also reset any previously value the
property might hold for the given resource.
Resources may have an IRI set at creation through tracker_resource_new()
,
or set afterwards through tracker_resource_set_identifier()
. Resources
without a name will represent a blank node, and will be dealt with as such
during database insertions.
TrackerResource
performs no validation on the data being coherent as per
any ontology. Errors will be found out at the time of using the TrackerResource
for e.g. database updates.
Once the RDF data is built in memory, the (tree of) TrackerResource
may be
converted to a RDF format through tracker_resource_print_rdf()
, or
directly inserted into a database through tracker_batch_add_resource()
or tracker_sparql_connection_update_resource()
.
Functions
tracker_resource_deserialize
Deserializes a TrackerResource
previously serialized with
tracker_resource_serialize()
. It is implied that both ends
use a common TrackerNamespaceManager
.
Instance methods
tracker_resource_add_boolean
Adds a boolean property. Previous values for the same property are kept.
tracker_resource_add_datetime
Adds a date property as a GDateTime
. Previous values for the
same property are kept.
since: 3.2
tracker_resource_add_double
Adds a numeric property with double precision. Previous values for the same property are kept.
tracker_resource_add_int
Adds a numeric property with integer precision. Previous values for the same property are kept.
tracker_resource_add_int64
Adds a numeric property with 64-bit integer precision. Previous values for the same property are kept.
tracker_resource_add_relation
Adds a resource property as a TrackerResource
. Previous values for the same property are kept.
tracker_resource_add_take_relation
Adds a resource property as a TrackerResource
. Previous values for the same property are kept.
Takes ownership on the given resource
.
tracker_resource_add_uri
Adds a resource property as an URI string. Previous values for the same property are kept.
tracker_resource_get_first_boolean
Returns the first boolean object previously assigned to a property.
tracker_resource_get_first_datetime
Returns the first GDateTime
previously assigned to a property.
since: 3.2
tracker_resource_get_first_double
Returns the first double object previously assigned to a property.
tracker_resource_get_first_int64
Returns the first integer object previously assigned to a property.
tracker_resource_get_first_relation
Returns the first resource object previously assigned to a property.
tracker_resource_get_first_string
Returns the first string object previously assigned to a property.
tracker_resource_get_property_overwrite
Returns whether the prior values for this property would be deleted
in the SPARQL issued by resource
.
since: 3.1
tracker_resource_identifier_compare_func
A helper function that compares a TrackerResource
by its identifier string.
tracker_resource_print_jsonld
Serialize all the information in resource
as a JSON-LD document.
deprecated: 3.5
tracker_resource_print_rdf
Serialize all the information in resource
into the selected RDF format.
since: 3.4
tracker_resource_print_sparql_update
Generates a SPARQL command to update a database with the information
stored in resource
.
tracker_resource_print_turtle
Serialize all the information in resource
as a Turtle document.
deprecated: 3.4
tracker_resource_serialize
Serializes a TrackerResource
to a GVariant
in a lossless way.
All child resources are subsequently serialized. It is implied
that both ends use a common TrackerNamespaceManager
.
tracker_resource_set_datetime
Sets a date property as a GDateTime
. Replaces any previous value.
since: 3.2
tracker_resource_set_double
Sets a numeric property with double precision. Replaces any previous value.
tracker_resource_set_identifier
Changes the identifier of a TrackerResource
. The identifier should be a
URI or compact URI, but this is not necessarily enforced. Invalid
identifiers may cause errors when serializing the resource or trying to
insert the results in a database.
tracker_resource_set_int
Sets a numeric property with integer precision. Replaces any previous value.
tracker_resource_set_int64
Sets a numeric property with 64-bit integer precision. Replaces any previous value.
tracker_resource_set_relation
Sets a resource property as a TrackerResource
. Replaces any previous value.
tracker_resource_set_take_relation
Sets a resource property as a TrackerResource
. Replaces any previous value.
Takes ownership on the given resource
.
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.