#include <Nepomuk/Query/QueryServiceClient>

Inheritance diagram for Nepomuk::Query::QueryServiceClient:

Public Slots
bool	blockingDesktopQuery (const QString &query)

bool	blockingQuery (const Query &query)

bool	blockingSparqlQuery (const QString &query, const Nepomuk::Query::RequestPropertyMap &requestPropertyMap=Nepomuk::Query::RequestPropertyMap())

void	close ()

bool	desktopQuery (const QString &query)

QString	errorMessage () const

bool	isListingFinished () const

bool	query (const Query &query)

bool	sparqlQuery (const QString &query, const Nepomuk::Query::RequestPropertyMap &requestPropertyMap=Nepomuk::Query::RequestPropertyMap())

Signals
void	entriesRemoved (const QList< QUrl > &entries)

void	error (const QString &errorMessage)

void	finishedListing ()

void	newEntries (const QList< Nepomuk::Query::Result > &entries)

void	resultCount (int count)

void	serviceAvailabilityChanged (bool running)

Public Member Functions
	QueryServiceClient (QObject *parent=0)

	~QueryServiceClient ()

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

virtual	~QObject ()

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Static Public Member Functions
static bool	serviceAvailable ()

static QList < Nepomuk::Query::Result >	syncDesktopQuery (const QString &query, bool *ok=0)

static QList < Nepomuk::Query::Result >	syncQuery (const Query &query, bool *ok=0)

static QList < Nepomuk::Query::Result >	syncSparqlQuery (const QString &query, const Nepomuk::Query::RequestPropertyMap &requestPropertyMap=Nepomuk::Query::RequestPropertyMap(), bool *ok=0)

Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Additional Inherited Members
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Properties inherited from QObject
	objectName

Detailed Description

Convenience frontend to the Nepomuk Query DBus Service.

The QueryServiceClient provides an easy way to access the Nepomuk Query Service without having to deal with any communication details. By default it monitors queries for changes.

Usage is simple: Create an instance of the client for each search you want to track. One instance may also be reused for subsequent queries if further updates of the persistent query are not necessary.

For quick queries which do not require any updates one of the static query methods can be used: syncQuery(), syncSparqlQuery(), or syncDesktopQuery().

Author: Sebastian Trueg trueg.nosp@m.@kde.nosp@m..org

Since: 4.4

Definition at line 58 of file queryserviceclient.h.

Constructor & Destructor Documentation

Nepomuk::Query::QueryServiceClient::QueryServiceClient ( QObject * parent = 0 )

Create a new QueryServiceClient instance.

Nepomuk::Query::QueryServiceClient::~QueryServiceClient ( )

Desctructor.

Closes the query.

Member Function Documentation

bool Nepomuk::Query::QueryServiceClient::blockingDesktopQuery ( const QString & query )

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query a desktop query string which can be parsed by QueryParser.

See also: desktopQuery(const QString&), close()

bool Nepomuk::Query::QueryServiceClient::blockingQuery ( const Query & query )

slot

Start a query using the Nepomuk query service.

Results will be reported as with query(const QString&) but a local event loop will be started to block the method call until all results have been listed.

The client will be closed after the initial listing. Thus, changes to results will not be reported as it is the case with the non-blocking methods.

Parameters

query the query to perform.

Returns: true if the query service was found and the query was started. false otherwise.

See also: query(const Query&), close()

bool Nepomuk::Query::QueryServiceClient::blockingSparqlQuery	(	const QString &	query,
		const Nepomuk::Query::RequestPropertyMap &	requestPropertyMap = `Nepomuk::Query::RequestPropertyMap()`
	)

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query	a SPARQL query which binds results to variable `'r'`.
requestPropertyMap	An optional mapping of variable binding names in `query` to their corresponding properties. For details see sparqlQuery.

See also: sparqlQuery(const Query&)

void Nepomuk::Query::QueryServiceClient::close ( )

slot

Close the client, thus stop to monitor the query for changes.

Without closing the client it will continue signalling changes to the results.

This will also make any blockingQuery return immediately.

bool Nepomuk::Query::QueryServiceClient::desktopQuery ( const QString & query )

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query a desktop query string which can be parsed by QueryParser.

void Nepomuk::Query::QueryServiceClient::entriesRemoved ( const QList< QUrl > & entries )

signal

Emitted if the search results changed when monitoring a query.

Parameters

entries A list of resource URIs identifying the resources that dropped out of the query results.

void Nepomuk::Query::QueryServiceClient::error ( const QString & errorMessage )

signal

Emitted when an error occurs.

This typically happens in case the query service is not running or does not respond. No further signals will be emitted after this one.

Since: 4.6

QString Nepomuk::Query::QueryServiceClient::errorMessage ( ) const

slot

The last error message which has been emitted via error() or an empty string if there was no error.

Since: 4.6

void Nepomuk::Query::QueryServiceClient::finishedListing ( )

signal

Emitted when the initial listing has been finished, ie.

if all results have been reported via newEntries. If no further updates are necessary the client should be closed now.

In case of an error this signal is not emitted.

See also: error()

bool Nepomuk::Query::QueryServiceClient::isListingFinished ( ) const

slot

Returns: true if all results have been listed (ie. finishedListing() has been emitted), close() has been called, or no query was started.

Since: 4.6

void Nepomuk::Query::QueryServiceClient::newEntries ( const QList< Nepomuk::Query::Result > & entries )

signal

Emitted for new search results.

This signal is emitted both for the initial listing and for changes to the search.

bool Nepomuk::Query::QueryServiceClient::query ( const Query & query )

slot

Start a query using the Nepomuk query service.

Results will be reported via newEntries. All results have been reported once finishedListing has been emitted.

Parameters

query the query to perform.

Returns: true if the query service was found and the query was started. false otherwise.

void Nepomuk::Query::QueryServiceClient::resultCount ( int count )

signal

The number of results that are reported via newEntries() before the finishedListing() signal.

Emitted once the count of the results is available. This might happen before the first result is emitted, in between the results, or in rare cases it could even happen after all results have been reported.

Also be aware that no count will be provided when using sparqlQuery()

Since: 4.6

void Nepomuk::Query::QueryServiceClient::serviceAvailabilityChanged ( bool running )

signal

Emitted when the availability of the query service changes.

Since: 4.8

static bool Nepomuk::Query::QueryServiceClient::serviceAvailable ( )

static

Check if the Nepomuk query service is running.

Returns: true if the Nepomuk query service is running and could be contacted via DBus, false otherwise

bool Nepomuk::Query::QueryServiceClient::sparqlQuery	(	const QString &	query,
		const Nepomuk::Query::RequestPropertyMap &	requestPropertyMap = `Nepomuk::Query::RequestPropertyMap()`
	)

slot

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query	a SPARQL query which binds results to variable `'r'`.
requestPropertyMap	An optional mapping of variable binding names in `query` to their corresponding properties. These bindings will then be reported via Result::requestProperties(). This map will be constructed automatically when using query(const Query&).

Examples:

Select a simple request property as can also be done via Query::Query:

QString query = "select ?r ?mtime where { "
                "?r a nfo:FileDataObject . "
                "?r nie:lastModified ?mtime . "
                "}";
QueryServiceClient::RequestPropertyMap requestPropertyMap;
requestPropertyMap.insert( "mtime", Vocabulary::NIE::lastModified() );
sparqlQuery( query, requestPropertyMap );

This will report the resources themselves and their modification time in the result's request properties:

void handleResult( const Query::Result& results ) {
    QDateTime lastModified = result.requestProperty( Vocabulary::NIE::lastModified() ).toDateTime();
    [...]

While using Query::Query restricts to request properties to diret properties of the results using a custom SPARQL query allows to use any binding as request property. The used property URI in the mapping does not even need to match anything in the query:

QString query = "select ?r ?phone where { "
                "?r a nco:PersonContact . "
                "?r nco:hasPhoneNumber ?n . "
                "?n nco:phoneNumber ?phone . "
                "}";
QueryServiceClient::RequestPropertyMap requestPropertyMap;
requestPropertyMap.insert( "phone", Vocabulary::NCO::hasPhoneNumber() );

See also: Query::requestPropertyMap()

static QList<Nepomuk::Query::Result> Nepomuk::Query::QueryServiceClient::syncDesktopQuery	(	const QString &	query,
		bool *	ok = `0`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query	a desktop query string which can be parsed by QueryParser.
ok	a valid boolean pointer, which will be set to `true` if the query service was found and the query was started, `false` otherwise. If you don't want to track errors, you can pass a null pointer instead.

See also: desktopQuery(const QString&)

Since: 4.5

static QList<Nepomuk::Query::Result> Nepomuk::Query::QueryServiceClient::syncQuery	(	const Query &	query,
		bool *	ok = `0`
	)

static

Start a query using the Nepomuk query service.

A local event loop will be started to block the method call until all results have been listed, and results will be returned. You can check if the query was successful through the ok pointer.

If updates to the query results are required an instance of QueryServiceClient should be created and one of the non-static query methods be used.

Parameters

query	the query to perform.
ok	a valid boolean pointer, which will be set to `true` if the query service was found and the query was started, `false` otherwise. If you don't want to track errors, you can pass a null pointer instead.

Returns: a list of Result for the given query.

See also: query(const Query&)

Since: 4.5

static QList<Nepomuk::Query::Result> Nepomuk::Query::QueryServiceClient::syncSparqlQuery	(	const QString &	query,
		const Nepomuk::Query::RequestPropertyMap &	requestPropertyMap = `Nepomuk::Query::RequestPropertyMap()`,
		bool *	ok = `0`
	)

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters

query	a SPARQL query which binds results to variable `'r'`.
ok	a valid boolean pointer, which will be set to `true` if the query service was found and the query was started, `false` otherwise. If you don't want to track errors, you can pass a null pointer instead.
requestPropertyMap	An optional mapping of variable binding names in `query` to their corresponding properties. For details see sparqlQuery.

See also: sparqlQuery(const Query&)

Since: 4.5

The documentation for this class was generated from the following file:

queryserviceclient.h

Nepomuk

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Examples:

Nepomuk

kdelibs API Reference

Search