resource.h

/*
    This file is part of libkresources

    Copyright (c) 2001-2003 Cornelius Schumacher <schumacher@kde.org>
    Copyright (c) 2002 Jan-Pascal van Best <janpascal@vanbest.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 KRESOURCES_RESOURCE_H
#define KRESOURCES_RESOURCE_H

#include "kresources_export.h"

#include <kpluginfactory.h>

#include <QtCore/QMutex>
#include <QWidget>

class KConfig;
class KConfigGroup;

namespace KRES {

class ConfigWidget;

class KRESOURCES_DEPRECATED_EXPORT Resource : public QObject
{
    friend class Factory;
    friend class ManagerImpl;

    Q_OBJECT
  public:
    typedef QList<Resource *> List;

    Resource();

    explicit Resource( const KConfigGroup &group );

    virtual ~Resource();

    virtual void writeConfig( KConfigGroup &group );

    bool open();

    void close();

    bool isOpen() const;

    void setIdentifier( const QString &identifier );

    QString identifier() const;

    void setType( const QString &type );

    QString type() const;

    virtual void setReadOnly( bool value );

    virtual bool readOnly() const;

    virtual void setResourceName( const QString &name );

    virtual QString resourceName() const;

    void setActive( bool active );

    bool isActive() const;

    virtual void dump() const;

  protected:
    virtual bool doOpen();

    virtual void doClose();

  private:
    class ResourcePrivate;
    ResourcePrivate *const d;
};

class KRESOURCES_DEPRECATED_EXPORT PluginFactoryBase : public KPluginFactory
{
  public:
    explicit PluginFactoryBase( const char *componentName=0,
                                const char *catalogName=0, QObject *parent=0 )
      : KPluginFactory( componentName, catalogName, parent ) {}
    explicit PluginFactoryBase( const KAboutData &aboutData, QObject *parent = 0 )
      : KPluginFactory( aboutData, parent ) {}

    virtual Resource *resource( const KConfigGroup &group ) = 0;
    virtual Resource *resource() = 0;

    virtual ConfigWidget *configWidget( QWidget *parent ) = 0;

  protected:
    virtual QObject *createObject( QObject *parent, const char *className,
                                   const QStringList &args );
};

template<class TR,class TC>
class PluginFactory : public PluginFactoryBase
{
  public:
    explicit PluginFactory( const char *componentName=0,
                            const char *catalogName=0, QObject *parent=0 )
      : PluginFactoryBase( componentName, catalogName, parent ) {}
    explicit PluginFactory( const KAboutData &aboutData, QObject *parent = 0 )
      : PluginFactoryBase( aboutData, parent ) {}

    virtual Resource *resource( const KConfigGroup &group )
    {
      return new TR( group );
    }
    virtual Resource *resource()
    {
      return new TR();
    }

    ConfigWidget *configWidget( QWidget *parent )
    {
      return new TC( parent );
    }
};

}

#endif