Return-Path: X-Original-To: apmail-clerezza-commits-archive@www.apache.org Delivered-To: apmail-clerezza-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 99E0AF5D5 for ; Wed, 3 Apr 2013 18:39:48 +0000 (UTC) Received: (qmail 74422 invoked by uid 500); 3 Apr 2013 18:39:48 -0000 Delivered-To: apmail-clerezza-commits-archive@clerezza.apache.org Received: (qmail 74397 invoked by uid 500); 3 Apr 2013 18:39:48 -0000 Mailing-List: contact commits-help@clerezza.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@clerezza.apache.org Delivered-To: mailing list commits@clerezza.apache.org Received: (qmail 74386 invoked by uid 99); 3 Apr 2013 18:39:48 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 03 Apr 2013 18:39:48 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 03 Apr 2013 18:39:43 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 6F4AA2388BF1; Wed, 3 Apr 2013 18:38:53 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1464148 [13/34] - in /clerezza/site/production: ./ architecture/ architecture/images/ bundle-doc/ bundle-doc/org.apache.clerezza.bundledevtool/ bundle-doc/org.apache.clerezza.bundledevtool/intro-content-el/ bundle-doc/org.apache.clerezza.p... Date: Wed, 03 Apr 2013 18:37:57 -0000 To: commits@clerezza.apache.org From: reto@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20130403183853.6F4AA2388BF1@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Once you have an overview over SCB the best resource is the javadoc API documentation. The following gives hints and describes best prectices on particular toopics. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + + + + Once you have an overview over SCB the best resource is the javadoc API documentation. The following gives hints and describes best prectices on particular toopics. + + + + + 0 + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/0.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Once you have an overview over SCB the best resource is the javadoc API documentation. The following gives hints and describes best prectices on particular toopics. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + The MGraphs returned by the TcManager are lockable. A LockableMGraph has a getLock()-Method returning a ReadWriteLock. Write-Locks can be used if the applications logic requires it, i.e. when it wants to ensure that the MGraph isn't modified by another thread while some triples are being added or removed bading on the presence or absence of other triples (note that its a violation of the open world assumption if the absence of some triples causes some actions to be done). + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + + The MGraphs returned by the TcManager are lockable. A LockableMGraph has a getLock()-Method returning a ReadWriteLock. Write-Locks can be used if the applications logic requires it, i.e. when it wants to ensure that the MGraph isn't modified by another thread while some triples are being added or removed bading on the presence or absence of other triples (note that its a violation of the open world assumption if the absence of some triples causes some actions to be done). + + + + + + + 0 + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/0.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + The MGraphs returned by the TcManager are lockable. A LockableMGraph has a getLock()-Method returning a ReadWriteLock. Write-Locks can be used if the applications logic requires it, i.e. when it wants to ensure that the MGraph isn't modified by another thread while some triples are being added or removed bading on the presence or absence of other triples (note that its a violation of the open world assumption if the absence of some triples causes some actions to be done). + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Readlocks must be used when multiple threads access an MGraph and a method returning an Iterator is used. In this case a read-lock must be obtained before calling the method on MGraph and released only after the last usage of the returned iterator. Failing to do so may result in ConcurrentModification when another threads modifies the MGraph while we are iterating over it. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + Readlocks must be used when multiple threads access an MGraph and a method returning an Iterator is used. In this case a read-lock must be obtained before calling the method on MGraph and released only after the last usage of the returned iterator. Failing to do so may result in ConcurrentModification when another threads modifies the MGraph while we are iterating over it. + + + + + + 1 + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/1.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Readlocks must be used when multiple threads access an MGraph and a method returning an Iterator is used. In this case a read-lock must be obtained before calling the method on MGraph and released only after the last usage of the returned iterator. Failing to do so may result in ConcurrentModification when another threads modifies the MGraph while we are iterating over it. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Currently (this might change infuture versions), it is also necessary to lock on the MGraphs against which a sparql select queries is directed. The lock on the MGraphs should be kept till iteration over the resultset is compleeted. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + Currently (this might change infuture versions), it is also necessary to lock on the MGraphs against which a sparql select queries is directed. The lock on the MGraphs should be kept till iteration over the resultset is compleeted. + + + + + + 2 + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/2.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Currently (this might change infuture versions), it is also necessary to lock on the MGraphs against which a sparql select queries is directed. The lock on the MGraphs should be kept till iteration over the resultset is compleeted. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + + There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. + + + + + + + + 1 + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-content.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + How do I create deadlock-safe locks? + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,17 @@ + + + + + + + 0 + + + + How do I create deadlock-safe locks? + + How I create I deadlocksafe Lock? + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3-title.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + How do I create deadlock-safe locks? + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + How do I create deadlock-safe locks? + + + +
+ +
+ +
+ + +
+

How do I create deadlock-safe locks? +

+
There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,27 @@ + + + + + + + + + + 3 + + + 0 + + + + + + + 1 + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/3.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + How do I create deadlock-safe locks? + + + +
+ +
+ +
+ + +
+

How do I create deadlock-safe locks? +

+
There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + + + + + The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. + + + + 1 + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-content.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + + + + What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) + + + + + 0 + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4-title.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) + + + +
+ +
+ +
+ + +
+

What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) +

+
The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,27 @@ + + + + + + + + + + 1 + + + + 4 + + + + + + + 0 + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/4.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) + + + +
+ +
+ +
+ + +
+

What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) +

+
The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + See the documentation and tutorials for the java.util.concurrent.locks package. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + See the documentation and tutorials for the java.util.concurrent.locks package. + + + + + 1 + + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-content.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + See the documentation and tutorials for the java.util.concurrent.locks package. + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Where do I find additional documenation and source-code examples? + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,16 @@ + + + Where do I find additional documenation and source-code examples? + + + + + 0 + + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5-title.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,12 @@ + + + + + + Untitled Content + + + Where do I find additional documenation and source-code examples? + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + Where do I find additional documenation and source-code examples? + + + +
+ +
+ +
+ + +
+

Where do I find additional documenation and source-code examples? +

+
See the documentation and tutorials for the java.util.concurrent.locks package. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.rdf URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.rdf?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.rdf (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.rdf Wed Apr 3 18:37:39 2013 @@ -0,0 +1,27 @@ + + + + 0 + + + + + 5 + + + + + + 1 + + + + + + + + + + Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.xhtml URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.xhtml?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.xhtml (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content-el/5.xhtml Wed Apr 3 18:37:39 2013 @@ -0,0 +1,104 @@ + + + + Where do I find additional documenation and source-code examples? + + + +
+ +
+ +
+ + +
+

Where do I find additional documenation and source-code examples? +

+
See the documentation and tutorials for the java.util.concurrent.locks package. +
+ +
+ + + + + \ No newline at end of file Added: clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content.html URL: http://svn.apache.org/viewvc/clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content.html?rev=1464148&view=auto ============================================================================== --- clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content.html (added) +++ clerezza/site/production/bundle-doc/org.apache.clerezza.rdf.core/smart-content-binding-content-el/2-content-el/1-content.html Wed Apr 3 18:37:39 2013 @@ -0,0 +1,40 @@ + + + + + + Untitled Content + + + + +
The MGraphs returned by the TcManager are lockable. A LockableMGraph has a getLock()-Method returning a ReadWriteLock. Write-Locks can be used if the applications logic requires it, i.e. when it wants to ensure that the MGraph isn't modified by another thread while some triples are being added or removed bading on the presence or absence of other triples (note that its a violation of the open world assumption if the absence of some triples causes some actions to be done). +
+ +
Readlocks must be used when multiple threads access an MGraph and a method returning an Iterator is used. In this case a read-lock must be obtained before calling the method on MGraph and released only after the last usage of the returned iterator. Failing to do so may result in ConcurrentModification when another threads modifies the MGraph while we are iterating over it. +
+ +
Currently (this might change infuture versions), it is also necessary to lock on the MGraphs against which a sparql select queries is directed. The lock on the MGraphs should be kept till iteration over the resultset is compleeted. +
+ +

How do I create deadlock-safe locks? +

+
There is no such thing, if you try to get a write-lock withing a read-locked section you'll have a deadlock. +
+
+ +

What is the best way to Lock a Graph in a service? (the developers, wich use the service know nothing about the lock and set own locks - so the service needs to check something) +

+
The service documentation should be clear about which MGarphs the service might be writing to, so the caller can make sure it holds no read-lock on one of these MGraph. +
+
+ +

Where do I find additional documenation and source-code examples? +

+
See the documentation and tutorials for the java.util.concurrent.locks package. +
+
+ + + +