/usr/include/nepomuk/thing.h is in kdelibs5-dev 4:4.8.4-4+deb7u1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | /*
* This file is part of the Nepomuk KDE project.
* Copyright (C) 2008-2009 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 _NEPOMUK_THING_H_
#define _NEPOMUK_THING_H_
#include "resource.h"
#include "nepomuk_export.h"
// FIXME: (Would it even make sense to check in Nepomuk::Resource if a resource is a pimo:Thing and if so,
// use the PIMO context? Or should we handle that through the Nepomuk::PimoThing class?)
namespace Nepomuk {
/**
* \class Thing thing.h Nepomuk/Thing
*
* \brief A Nepomuk PIMO Thing resource.
*
* A Thing represents a unique abstract concept/idea or real-world
* entity which can have multiple representations or occurrences.
*
* A typical example for a Thing is a unique person resource
* which identifies the person itself, not any representation
* such as an addressbook entry.
*
* Things are typically grounded via application resources,
* i.e. those resources that are created or handled by applications.
* Again the typical example is the addressbook entry.
*
* In general it is recommended to alway use the Thing instead of the
* grounding resource to annotate, i.e. to add tags, or relate to other
* resources. The advantage is its uniqueness. While there can be many
* occurrences of one concept there is only one Thing, identifying
* uniquely.
*
* \author Sebastian Trueg <trueg@kde.org>
*
* \since 4.2
*/
class NEPOMUK_EXPORT Thing : public Resource
{
public:
/**
* Create a Thing object with URI \p uri. If the Thing does not
* exist in the Nepomuk storage yet, it will be created once
* a writing method is called (such as Resource::setProperty).
*
* \param uri The URI of the Thing. If empty, a new random one
* will be created.
* \param pimoType The type of this Thing. Needs to be a subtype
* of pimo:Thing. If empty defaults to pimo:Thing.
*/
Thing( const QUrl& uri = QUrl(), const QUrl& pimoType = QUrl() );
/**
* \overload
*
* \param manager The resource manager to use. This allows to mix resources from different
* managers and, thus, different models.
*
* \since 4.3
*/
Thing( const QUrl& uri, const QUrl& pimoType, ResourceManager* manager );
/**
* Create a new Thing with label or URI \p uriOrName
*
* \param uriOrName The URI or the label of the Thing. The constructor
* tries hard to find the Thing associated. If it is not found, a new
* Thing will be created.
* \param pimoType The type of this Thing. Needs to be a subtype
* of pimo:Thing. If empty defaults to pimo:Thing.
*
* Be aware that using the other constructor is always faster in case
* the URI of the Thing is known.
*/
Thing( const QString& uriOrName, const QUrl& pimoType = QUrl() );
/**
* \overload
*
* \param manager The resource manager to use. This allows to mix resources from different
* managers and, thus, different models.
*
* \since 4.3
*/
Thing( const QString& uriOrName, const QUrl& pimoType, ResourceManager* manager );
/**
* Copy constructor.
*/
Thing( const Thing& other );
/**
* Copy constructor.
*
* \param other the resoruce to construct the Thing from.
*/
Thing( const Resource& other );
/**
* Constructor used internally.
*/
Thing( ResourceData* );
/**
* Desctructor
*/
~Thing();
/**
* Assignment operator.
*/
Thing& operator=( const Thing& res );
/**
* Assignment operator.
*/
Thing& operator=( const Resource& res );
/**
* Assignment operator.
*/
Thing& operator=( const QUrl& res );
/**
* Get the grounding occurrences for this Thing.
* Grounding resources are physical representations
* of the Thing.
*
* An example is an mp3 file which represents an audio track
* or a website which represents a company or a person. Or the
* addressbook entry for an abstract person thing.
*
* \sa pimo:groundingResource
*/
QList<Resource> groundingOccurrences() const;
QList<Resource> referencingOccurrences() const;
QList<Resource> occurrences() const;
/**
* Add a grounding occurrence for this Thing.
* Grounding resources are physical representations
* of the Thing.
*
* An example is an mp3 file which represents an audio track
* or a website which represents a company or a person. Or the
* addressbook entry for an abstract person thing.
*
* \sa pimo:groundingResource
*/
void addGroundingOccurrence( const Resource &res );
/**
* Merges two Things that represent the same real-world
* entity.
*
* \param other The Thing that should be merged into this
* Thing.
*
* All properties of \p other will be merged into this
* Thing and all references to \p other will be replaced
* with references to this Thing.
*/
// void merge( Thing other );
};
}
#endif
|