Struct tracker::SparqlConnection [−][src]
#[repr(transparent)]pub struct SparqlConnection { /* fields omitted */ }Expand description
The <structname>TrackerSparqlConnection</structname> object represents a
SPARQL connection.
This is an Abstract Base Class, you cannot instantiate it.
Implementations
Connects to a database owned by another process on the local machine.
service_name
The name of the D-Bus service to connect to.
object_path
The path to the object, or None to use the default.
dbus_connection
The [gio::DBusConnection][crate::gio::DBusConnection] to use, or None to use the session bus
Returns
a new SparqlConnection. Call g_object_unref() on the
object when no longer used.
pub fn new(
flags: SparqlConnectionFlags,
store: Option<&impl IsA<File>>,
ontology: Option<&impl IsA<File>>,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<SparqlConnection, Error>
pub fn new(
flags: SparqlConnectionFlags,
store: Option<&impl IsA<File>>,
ontology: Option<&impl IsA<File>>,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<SparqlConnection, Error>
Creates or opens a database.
This method should only be used for databases owned by the current process.
To connect to databases managed by other processes, use
bus_new().
If store is None, the database will be created in memory.
The ontologies parameter must point to a location containing suitable
.ontology files in Turtle format. These control the database schema that
is used. You can use the default Nepomuk ontologies by calling
tracker_sparql_get_ontology_nepomuk ().
If you open an existing database using a different ontology to the one it
was created with, Tracker will attempt to migrate the existing data to the
new schema. This may raise an error. In particular, not all migrations are
possible without causing data loss and Tracker will refuse to delete data
during a migration.
You can also pass None for ontologies to mean “use the ontologies that the
database was created with”. This will fail if the database doesn’t already
exist.
flags
values from SparqlConnectionFlags
store
the directory that contains the database as a [gio::File][crate::gio::File], or None
ontology
the directory that contains the database schemas as a [gio::File][crate::gio::File], or None
cancellable
a [gio::Cancellable][crate::gio::Cancellable], or None
Returns
a new SparqlConnection. Call
g_object_unref() on the object when no longer used.
Connects to a remote SPARQL endpoint. The connection is made using the libsoup HTTP library. The connection will normally use the http:// or https:// protocol.
uri_base
Base URI of the remote connection
Returns
a new remote SparqlConnection. Call
g_object_unref() on the object when no longer used.
Closes a SPARQL connection. No other API calls than g_object_unref()
should happen after this call.
This call is blocking. All pending updates will be flushed, and the store databases will be closed orderly. All ongoing SELECT queries will be cancelled. Notifiers will no longer emit events.
Closes a connection asynchronously. No other API calls than g_object_unref()
should happen after this call. See close() for more
information.
cancellable
a [gio::Cancellable][crate::gio::Cancellable], or None
callback
user-defined GAsyncReadyCallback to be called when
asynchronous operation is finished.
Retrieves a NamespaceManager that contains all
prefixes in the ontology of self.
Returns
a NamespaceManager for this
connection. This object is owned by self and must not be freed.
Executes a SPARQL query on. The API call is completely synchronous, so it may block.
The sparql query should be built with Resource, or
its parts correctly escaped using tracker_sparql_escape_string(),
otherwise SPARQL injection is possible.
sparql
string containing the SPARQL query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation
Returns
a SparqlCursor if results were found.
On error, None is returned and the error is set accordingly.
Call g_object_unref() on the returned cursor when no longer needed.
pub fn query_async<P: FnOnce(Result<SparqlCursor, Error>) + Send + 'static>(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>,
callback: P
)
pub fn query_async<P: FnOnce(Result<SparqlCursor, Error>) + Send + 'static>(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>,
callback: P
)
Executes asynchronously a SPARQL query.
sparql
string containing the SPARQL query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation
callback
user-defined GAsyncReadyCallback to be called when
asynchronous operation is finished.
pub fn query_future(
&self,
sparql: &str
) -> Pin<Box_<dyn Future<Output = Result<SparqlCursor, Error>> + 'static>>
pub fn query_statement(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<Option<SparqlStatement>, Error>
pub fn query_statement(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<Option<SparqlStatement>, Error>
Prepares the given sparql as a SparqlStatement.
sparql
the SPARQL query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation, or None
Returns
a prepared statement
Executes asynchronously a SPARQL update.
sparql
string containing the SPARQL update query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation
callback
user-defined GAsyncReadyCallback to be called when
asynchronous operation is finished.
pub fn update_future(
&self,
sparql: &str
) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>
pub fn update_blank(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<Variant, Error>
pub fn update_blank(
&self,
sparql: &str,
cancellable: Option<&impl IsA<Cancellable>>
) -> Result<Variant, Error>
Executes a SPARQL update and returns the URNs of the generated nodes, if any. The API call is completely synchronous, so it may block.
The sparql query should be built with Resource, or
its parts correctly escaped using tracker_sparql_escape_string(),
otherwise SPARQL injection is possible.
sparql
string containing the SPARQL update query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation
Returns
a [glib::Variant][struct@crate::glib::Variant] with the generated URNs, which should be freed with
g_variant_unref() when no longer used.
Executes asynchronously a SPARQL update.
sparql
string containing the SPARQL update query
cancellable
a [gio::Cancellable][crate::gio::Cancellable] used to cancel the operation
callback
user-defined GAsyncReadyCallback to be called when
asynchronous operation is finished.
pub fn update_blank_future(
&self,
sparql: &str
) -> Pin<Box_<dyn Future<Output = Result<Variant, Error>> + 'static>>
pub fn new_async<P: FnOnce(Result<SparqlConnection, Error>) + Send + 'static>(
flags: SparqlConnectionFlags,
store: Option<&impl IsA<File>>,
ontology: Option<&impl IsA<File>>,
cancellable: Option<&impl IsA<Cancellable>>,
callback: P
)
pub fn new_async<P: FnOnce(Result<SparqlConnection, Error>) + Send + 'static>(
flags: SparqlConnectionFlags,
store: Option<&impl IsA<File>>,
ontology: Option<&impl IsA<File>>,
cancellable: Option<&impl IsA<Cancellable>>,
callback: P
)
Asynchronous version of new().
flags
values from SparqlConnectionFlags
store
the directory that contains the database as a [gio::File][crate::gio::File], or None
ontology
the directory that contains the database schemas as a [gio::File][crate::gio::File], or None
cancellable
a [gio::Cancellable][crate::gio::Cancellable], or None
callback
the GAsyncReadyCallback called when the operation completes
pub fn new_future(
flags: SparqlConnectionFlags,
store: Option<&impl IsA<File> + Clone + 'static>,
ontology: Option<&impl IsA<File> + Clone + 'static>
) -> Pin<Box_<dyn Future<Output = Result<SparqlConnection, Error>> + 'static>>
Trait Implementations
type Parent = Object
This method returns an ordering between self and other values if one exists. Read more
This method tests less than (for self and other) and is used by the < operator. Read more
This method tests less than or equal to (for self and other) and is used by the <=
operator. Read more
This method tests greater than (for self and other) and is used by the > operator. Read more
Returns the type identifier of Self.
Auto Trait Implementations
impl RefUnwindSafe for SparqlConnection
impl !Send for SparqlConnection
impl !Sync for SparqlConnection
impl Unpin for SparqlConnection
impl UnwindSafe for SparqlConnection
Blanket Implementations
Mutably borrows from an owned value. Read more
fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,
fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,
Upcasts an object to a superclass or interface T. Read more
fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,
fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,
Upcasts an object to a reference of its superclass or interface T. Read more
Tries to downcast to a subclass or interface implementor T. Read more
fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,
fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,
Tries to downcast to a reference of its subclass or interface implementor T. Read more
fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,
fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,
Tries to cast to an object of type T. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast and upcast will do many checks at compile-time already. Read more
fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Tries to cast to reference to an object of type T. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast and upcast will do many checks at compile-time already. Read more
unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,
unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,
Casts to T unconditionally. Read more
unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,
unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,
Casts to &T unconditionally. Read more
pub fn parent_class_init<T>(class: &mut Class<U>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
pub fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
Returns true if the object is an instance of (can be cast to) T.
pub fn type_(&self) -> Type
pub fn type_(&self) -> Type
Returns the type of the object.
pub fn object_class(&self) -> &Class<Object>
pub fn object_class(&self) -> &Class<Object>
Returns the [ObjectClass] of the object. Read more
pub fn class(&self) -> &Class<T> where
T: IsClass,
pub fn class(&self) -> &Class<T> where
T: IsClass,
Returns the class of the object.
Returns the class of the object in the given type T. Read more
Returns the interface T of the object. Read more
pub fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,
pub fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,
Similar to [Self::set_property] but fails instead of panicking.
pub fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,
pub fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,
Sets the property property_name of the object to value value. Read more
pub fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>
pub fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>
Similar to [Self::set_property] but fails instead of panicking.
pub fn set_property_from_value(&self, property_name: &str, value: &Value)
pub fn set_property_from_value(&self, property_name: &str, value: &Value)
Sets the property property_name of the object to value value. Read more
Similar to [Self::set_properties] but fails instead of panicking.
Sets multiple properties of the object at once. Read more
Similar to [Self::set_properties_from_value] but fails instead of panicking.
Sets multiple properties of the object at once. Read more
pub fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,
pub fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,
Similar to [Self::property] but fails instead of panicking.
Gets the property property_name of the object and cast it to the type V. Read more
pub fn try_property_value(
&self,
property_name: &str
) -> Result<Value, BoolError>
pub fn try_property_value(
&self,
property_name: &str
) -> Result<Value, BoolError>
Similar to [Self::property_value] but fails instead of panicking.
pub fn property_value(&self, property_name: &str) -> Value
pub fn property_value(&self, property_name: &str) -> Value
Gets the property property_name of the object. Read more
pub fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool
pub fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool
Check if the object has a property property_name of the given type_. Read more
pub fn property_type(&self, property_name: &str) -> Option<Type>
pub fn property_type(&self, property_name: &str) -> Option<Type>
Get the type of the property property_name of this object. Read more
pub fn find_property(&self, property_name: &str) -> Option<ParamSpec>
pub fn find_property(&self, property_name: &str) -> Option<ParamSpec>
Get the ParamSpec of the property property_name of this object.
pub fn list_properties(&self) -> PtrSlice<ParamSpec>
pub fn list_properties(&self) -> PtrSlice<ParamSpec>
Return all ParamSpec of the properties of this object.
pub fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
pub fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
Freeze all property notifications until the return guard object is dropped. Read more
pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,
pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,
Set arbitrary data on this object with the given key. Read more
Return previously set arbitrary data of this object with the given key. Read more
pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,
pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,
Retrieve previously set arbitrary data of this object with the given key. Read more
Set arbitrary data on this object with the given key. Read more
Return previously set arbitrary data of this object with the given key. Read more
pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,
pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,
Retrieve previously set arbitrary data of this object with the given key. Read more
pub fn block_signal(&self, handler_id: &SignalHandlerId)
pub fn block_signal(&self, handler_id: &SignalHandlerId)
Block a given signal handler. Read more
pub fn unblock_signal(&self, handler_id: &SignalHandlerId)
pub fn unblock_signal(&self, handler_id: &SignalHandlerId)
Unblock a given signal handler.
pub fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
pub fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
Stop emission of the currently emitted signal.
pub fn stop_signal_emission_by_name(&self, signal_name: &str)
pub fn stop_signal_emission_by_name(&self, signal_name: &str)
Stop emission of the currently emitted signal by the (possibly detailed) signal name.
Similar to [Self::connect] but fails instead of panicking.
Connect to the signal signal_name on this object. Read more
Similar to [Self::connect_id] but fails instead of panicking.
Connect to the signal signal_id on this object. Read more
Similar to [Self::connect_local] but fails instead of panicking.
Connect to the signal signal_name on this object. Read more
Similar to [Self::connect_local_id] but fails instead of panicking.
Connect to the signal signal_id on this object. Read more
Similar to [Self::connect_unsafe] but fails instead of panicking.
Connect to the signal signal_name on this object. Read more
Similar to [Self::connect_unsafe_id] but fails instead of panicking.
pub fn try_connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
pub fn try_connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
Similar to [Self::connect_closure] but fails instead of panicking.
pub fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
pub fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
Connect a closure to the signal signal_name on this object. Read more
pub fn try_connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
pub fn try_connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
Similar to [Self::connect_closure_id] but fails instead of panicking.
pub fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
pub fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
Connect a closure to the signal signal_id on this object. Read more
pub fn watch_closure(&self, closure: &impl AsRef<Closure>)
pub fn watch_closure(&self, closure: &impl AsRef<Closure>)
Limits the lifetime of closure to the lifetime of the object. When
the object’s reference count drops to zero, the closure will be
invalidated. An invalidated closure will ignore any calls to
Closure::invoke. Read more
Connect to the signal signal_id on this object. Read more
Similar to [Self::emit] but fails instead of panicking.
Emit signal by signal id. Read more
pub fn try_emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Result<Option<Value>, BoolError>
pub fn try_emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Result<Option<Value>, BoolError>
Similar to [Self::emit_with_values] but fails instead of panicking.
pub fn emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Option<Value>
pub fn emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Option<Value>
Same as [Self::emit] but takes Value for the arguments.
pub fn try_emit_by_name<R>(
&self,
signal_name: &str,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
pub fn try_emit_by_name<R>(
&self,
signal_name: &str,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
Similar to [Self::emit_by_name] but fails instead of panicking.
pub fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> R where
R: TryFromClosureReturnValue,
pub fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> R where
R: TryFromClosureReturnValue,
Emit signal by its name. Read more
Similar to [Self::emit_by_name_with_values] but fails instead of panicking.
pub fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
pub fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
Emit signal by its name. Read more
pub fn try_emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
pub fn try_emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
Similar to [Self::emit_with_details] but fails instead of panicking.
pub fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> R where
R: TryFromClosureReturnValue,
pub fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> R where
R: TryFromClosureReturnValue,
Emit signal by signal id with details. Read more
pub fn try_emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Result<Option<Value>, BoolError>
pub fn try_emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Result<Option<Value>, BoolError>
Similar to [Self::emit_with_details_and_values] but fails instead of panicking.
pub fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
pub fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
Emit signal by signal id with details. Read more
pub fn disconnect(&self, handler_id: SignalHandlerId)
pub fn disconnect(&self, handler_id: SignalHandlerId)
Disconnect a previously connected signal handler.
Connect to the notify signal of the object. Read more
pub fn connect_notify_local<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),
pub fn connect_notify_local<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),
Connect to the notify signal of the object. Read more
pub unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
pub unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
Connect to the notify signal of the object. Read more
Notify that the given property has changed its value. Read more
pub fn notify_by_pspec(&self, pspec: &ParamSpec)
pub fn notify_by_pspec(&self, pspec: &ParamSpec)
Notify that the given property has changed its value. Read more
pub fn downgrade(&self) -> WeakRef<T>
pub fn downgrade(&self) -> WeakRef<T>
Downgrade this object to a weak reference.
pub fn bind_property<O>(
&'a self,
source_property: &'a str,
target: &'a O,
target_property: &'a str
) -> BindingBuilder<'a> where
O: ObjectType,
pub fn bind_property<O>(
&'a self,
source_property: &'a str,
target: &'a O,
target_property: &'a str
) -> BindingBuilder<'a> where
O: ObjectType,
Bind property source_property on this object to the target_property on the target object. Read more
pub fn to_closure_return_value(&self) -> Option<Value>
pub fn to_send_value(&self) -> SendValue
pub fn to_send_value(&self) -> SendValue
Returns a SendValue clone of self.