KRES::Resource Class Reference
#include <resource.h>
Inheritance diagram for KRES::Resource:

Detailed Description
This class provides a resource which is managed in a general way.A Resource represents the concept of an object with the following attributes:
- Applications operate on sets of one or more Resource objects.
- Creation and deletetion of Resource objects is done in a general way, independent of concrete functionality of the Resource.
- The end user has control over creation, deletion and configuration of Resource object.
- Properties, behaviour and configuration of different Resource objects can widely differ.
- Resources can be active or inactive.
- There is one special Resource which is the standard Resource. This can for example be used as default destination for newly created object managed by a certain Resource family.
- Activation of Resources can be covered by a two step process of being opened and then loaded. Deactivation corresponds to saving and closing.
- Different application ususally share the same set of Resources.
The Resource base class provides the management functionality. Classes inheriting from Resource automatically appear in the general kresources kcontrol module.
Concrete functionality of Resources is specified per family by a subclass of Resource. This classes in turn have subclasses which implement the different flavours of the functionality represented by the family.
A subclass should reimplement at least the constructor and the writeConfig method.
An example for a Resource subclass hierarchy would be the "calendar" family. The ResourceCalendar subclass would specify an API for accessing calendar data. Subclasses of ResourceCalendar would implement this API for local files, remote files, specific calendar servers etc.
Definition at line 255 of file resource.h.
Public Types | |
typedef QValueList< Resource * > | List |
Public Member Functions | |
Resource (const KConfig *config) | |
virtual | ~Resource () |
virtual void | writeConfig (KConfig *config) |
bool | open () |
void | close () |
bool | isOpen () const |
QString | identifier () const |
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 Member Functions | |
virtual bool | doOpen () |
virtual void | doClose () |
void | setIdentifier (const QString &identifier) |
void | setType (const QString &type) |
Friends | |
class | Factory |
class | ManagerImpl |
Constructor & Destructor Documentation
Resource::Resource | ( | const KConfig * | config | ) |
Constructor.
Construct resource from config.
- Parameters:
-
config Configuration to read persistence information from. If config is 0, create object using default settings.
Definition at line 47 of file resource.cpp.
Resource::~Resource | ( | ) | [virtual] |
Member Function Documentation
void Resource::writeConfig | ( | KConfig * | config | ) | [virtual] |
Write configuration information for this resource to a configuration file.
If you override this method, remember to call Resource::writeConfig or Terrible Things(TM) will happen.
- Parameters:
-
config Configuration to write persistence information to.
Definition at line 74 of file resource.cpp.
bool Resource::open | ( | ) |
Open this resource, if it not already open.
Increase the open count of this object, and open the resource by calling doOpen(). This method may block while another thread is concurrently opening or closing the resource.
Returns true if the resource was already opened or if it was opened successfully; returns false if the resource was not opened successfully.
Definition at line 85 of file resource.cpp.
void Resource::close | ( | ) |
Decrease the open count of this object, and if the count reaches zero, close this resource by calling doClose().
This method may block while another thread is concurrently closing or opening the resource.
Definition at line 99 of file resource.cpp.
bool Resource::isOpen | ( | ) | const |
QString Resource::identifier | ( | ) | const |
Returns a unique identifier.
The identifier is unique for this resource. It is created when the resource is first created, and it is retained in the resource family configuration file for this resource.
- Returns:
- This resource's identifier
Definition at line 128 of file resource.cpp.
QString Resource::type | ( | ) | const |
void Resource::setReadOnly | ( | bool | value | ) | [virtual] |
Mark the resource as read-only.
You can override this method, but also remember to call Resource::setReadOnly().
Definition at line 143 of file resource.cpp.
bool Resource::readOnly | ( | ) | const [virtual] |
void Resource::setResourceName | ( | const QString & | name | ) | [virtual] |
Set the name of resource.
You can override this method, but also remember to call Resource::setResourceName().
Definition at line 153 of file resource.cpp.
QString Resource::resourceName | ( | ) | const [virtual] |
void Resource::setActive | ( | bool | active | ) |
bool Resource::isActive | ( | ) | const |
void Resource::dump | ( | ) | const [virtual] |
virtual bool KRES::Resource::doOpen | ( | ) | [inline, protected, virtual] |
Open this resource.
When called, the resource must be in a closed state.
Returns true if the resource was opened successfully; returns false if the resource was not opened successfully.
The result of this call can be accessed later by isOpen()
Definition at line 368 of file resource.h.
virtual void KRES::Resource::doClose | ( | ) | [inline, protected, virtual] |
Close this resource.
Pre-condition: resource is open. Post-condition: resource is closed.
Definition at line 374 of file resource.h.
The documentation for this class was generated from the following files: