Projects/Nepomuk/QuickStart: Difference between revisions

    From KDE TechBase
    No edit summary
    mNo edit summary
    Line 1: Line 1:
    {{TutorialBrowser|
    series=Nepomuk|
    name=Nepmuk Quickstart|
    next=[[../Resources|Handle Resource Metadata with Nepomuk]]|
    }}
    ==Nepomuk Quickstart==
    ==Nepomuk Quickstart==



    Revision as of 11:44, 15 February 2008

    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 it saved and will now be searchable via Nepomuk.