Class
TrackerResource
Description [src]
final class Tracker.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.