[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    KDE/kdelibs/nepomuk/core
From:       Sebastian Trueg <sebastian () trueg ! de>
Date:       2010-08-02 12:45:13
Message-ID: 20100802124513.60179AC7A9 () svn ! kde ! org
[Download RAW message or body]

SVN commit 1158286 by trueg:

Added hints to use the query API rather than the static sycronous methods

 M  +4 -0      resource.h  
 M  +10 -1     resourcemanager.h  
 M  +5 -2      tag.h  


--- trunk/KDE/kdelibs/nepomuk/core/resource.h #1158285:1158286
@@ -719,6 +719,10 @@
          * might be better to use libKNep directly.
          *
          * \sa ResourceManager::allResources
+         *
+         * \warning This list will be very big. Usage of this method is
+         * discouraged. Use Query::QueryServiceClient in combination with an
+         * empty Query::Query instead.
          */
         static QList<Resource> allResources();
 
--- trunk/KDE/kdelibs/nepomuk/core/resourcemanager.h #1158285:1158286
@@ -124,7 +124,8 @@
          * Retrieve a list of all resource managed by this manager.
          *
          * \warning This list will be very big. Usage of this method is
-         * discouraged.
+         * discouraged. Use Query::QueryServiceClient in combination with an
+         * empty Query::Query instead.
          *
          * \since 4.3
          */
@@ -135,6 +136,10 @@
          *
          * This includes Resources that are not synced yet so it might
          * not represent exactly the state as in the RDF store.
+         *
+         * \warning This list can be very big. Usage of this method is
+         * discouraged. Use Query::QueryServiceClient in combination with
+         * a Query::Query containing one Query::ResourceTypeTerm instead.
          */
         QList<Resource> allResourcesOfType( const QUrl& type );
 
@@ -153,6 +158,10 @@
          *            not include a namespace the default namespace is
          *            prepended.
          * \param v The value all returned resources should have set as properts \a uri.
+         *
+         * \warning This list can be very big. Usage of this method is
+         * discouraged. Use Query::QueryServiceClient in combination with
+         * a Query::Query containing one Query::ComparisonTerm instead.
          */
         QList<Resource> allResourcesWithProperty( const QUrl& uri, const Variant& v );
 
--- trunk/KDE/kdelibs/nepomuk/core/tag.h #1158285:1158286
@@ -115,8 +115,11 @@
          * Retrieve a list of all available Tag resources. This list consists 
          * of all resource of type Tag that are stored in the local Nepomuk 
          * meta data storage and any changes made locally. Be aware that 
-         * in some cases this list can get very big. Then it might be better 
-         * to use libKNep directly. 
+         * in some cases this list can get very big.
+         *
+         * In those cases it might be better to use the asyncronous approach
+         * via Query::QueryServiceClient and a Query::ResourceTypeTerm with
+         * type Soprano::Vocabulary::NAO::Tag().
          */
         static QList<Tag> allTags();
 
[prev in list] [next in list] [prev in thread] [next in thread]