Projects/Nepomuk/QuickStart

From KDE TechBase
Revision as of 23:05, 18 March 2008 by Edulix (talk | contribs)
Nepmuk Quickstart
Tutorial Series   Nepomuk
Previous   None
What's Next   Handle Resource Metadata with Nepomuk
Further Reading   n/a

Nepomuk Quickstart

Reading or setting simple metadata in your own application can be very easy. But keep in mind that the process described here does not make much sense in terms of performance when changing a lot of metadata. We will now take a look at a simple way to access a resource's metadata.


Retrieve Metadata

Let's get the metadata for a file. Imagine the URL or the file is stored in uri.

Nepomuk::Resource res( uri ); QHash<QString, Variant> properties = res.allProperties();

That gives us all properties assigned to the file.

We can now use Nepomuk to get human readable labels for the properties and display the properties in a generic way:

for( QHash<QString, Variant>::const_iterator it = properties.constBegin();

    it != properties.constEnd(); ++it ) {
  QUrl propertyUri = it.key();
  Variant value = it.value();
  Nepomuk::Types::Class propertyType( propertyUri );
  someList->appendItem( propertyType.label() + ": " + value.toString() );

}


Set Metadata

Again uri is the URL of the file we want to set some metadata for. This time we want to set a tag and a comment and will do this in two slightly different ways:

Let's start with the tag and use the easy Nepomukish way:

Nepomuk::Tag tag( "This is my nice tag name" ); Nepomuk::Resource res( uri ); res.addTag( tag );

Simple! Actually if the tag already exists it will be reused.

Now let's set a comment for the file without the use of the convenience methods in Nepomuk:

Nepomuk::Resource res( uri ); QString comment = getFancyFileComment(); res.setProperty( Soprano::Vocabulary::NAO::description(), comment );

That's all. The comment is saved and will now be searchable via Nepomuk.