resource.h

Go to the documentation of this file.

/*
 * This file is part of the Nepomuk KDE project.
 * Copyright (C) 2006-2011 Sebastian Trueg <trueg@kde.org>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 */

#ifndef _NEPOMUK2_RESOURCE_H_
#define _NEPOMUK2_RESOURCE_H_

#include <QtCore/QHash>
#include <QtCore/QStringList>

#include <kurl.h>

#include "class.h"

#include "nepomuk_export.h"

namespace Nepomuk2 {

    class ResourceData;
    class ResourceManager;
    class Variant;
    class Tag;
    class File;
    namespace Types {
        class Property;
    }

    enum ErrorCode {
        NoError = 0,
        CommunicationError, 
        InvalidType,
        UnknownError
    };

    // FIXME: add the uri of the resource as parameter
    NEPOMUK_EXPORT QString errorString( ErrorCode code );

    class NEPOMUK_EXPORT Resource
    {
    public:
        Resource();

        Resource( const Resource& );

        Resource( const QString& pathOrIdentifier, const QUrl& type = QUrl() );

        Resource( const QUrl& uri, const QUrl& type = QUrl() );

        Resource( ResourceData* );

        virtual ~Resource();

        Resource& operator=( const Resource& other );

        Resource& operator=( const QUrl& uri );

        QUrl uri() const;

        QUrl type() const;

        QList<QUrl> types() const;

        void setTypes( const QList<QUrl>& types );

        void addType( const QUrl& type );

        bool hasType( const QUrl& typeUri ) const;

        QHash<QUrl, Variant> properties() const;

        bool hasProperty( const QUrl& uri ) const;

        bool hasProperty( const Types::Property& p, const Variant& v ) const;

        Variant property( const QUrl& uri ) const;

        void setProperty( const QUrl& uri, const Variant& value );

        void addProperty( const QUrl& uri, const Variant& value );

        void removeProperty( const QUrl& uri );

        void removeProperty( const QUrl& uri, const Variant& value );

        void remove();

        bool exists() const;

        bool isValid() const;

        QString genericLabel() const;

        QString genericDescription() const;

        QString genericIcon() const;

        bool operator==( const Resource& ) const;

        bool operator!=( const Resource& ) const;

        QString description() const;

        void setDescription( const QString& value );

        QStringList identifiers() const;

        void setIdentifiers( const QStringList& value );

        void addIdentifier( const QString& value );

        QList<Tag> tags() const;

        void setTags( const QList<Tag>& value );

        void addTag( const Tag& value );

        QList<Resource> isRelateds() const;

        void setIsRelateds( const QList<Resource>& value );

        void addIsRelated( const Resource& value );

        QString label() const;

        void setLabel( const QString& value );

        quint32 rating() const;

        void setRating( const quint32& value );

        QStringList symbols() const;

        void setSymbols( const QStringList& value );

        void addSymbol( const QString& value );

        QList<Resource> isRelatedOf() const;

        int usageCount() const;

        void increaseUsageCount();

        bool isFile() const;

        File toFile() const;

        static Resource fromResourceUri( const KUrl& uri, const Nepomuk2::Types::Class& type = Nepomuk2::Types::Class() );

        void setWatchEnabled( bool status );

        bool watchEnabled();

    private:
        void determineFinalResourceData() const;

        ResourceData* m_data;

        class Private;
        Private* d; // unused

        friend class ResourceData;
        friend class ResourceManager;
    };

    NEPOMUK_EXPORT uint qHash( const Resource& res );
}

#endif