Author: reto
Date: Mon Mar 11 08:01:32 2013
New Revision: 1455036
URL: http://svn.apache.org/r1455036
Log:
CLEREZZA-734: extended class comment
Modified:
clerezza/trunk/rdf.core/src/main/java/org/apache/clerezza/rdf/core/access/TcManager.java
Modified:
clerezza/trunk/rdf.core/src/main/java/org/apache/clerezza/rdf/core/access/TcManager.java
URL:
http://svn.apache.org/viewvc/clerezza/trunk/rdf.core/src/main/java/org/apache/clerezza/rdf/core/access/TcManager.java?rev=1455036&r1=1455035&r2=1455036&view=diff
==============================================================================
---
clerezza/trunk/rdf.core/src/main/java/org/apache/clerezza/rdf/core/access/TcManager.java
(original)
+++
clerezza/trunk/rdf.core/src/main/java/org/apache/clerezza/rdf/core/access/TcManager.java
Mon Mar 11 08:01:32 2013
@@ -74,7 +74,18 @@ import org.osgi.framework.BundleContext;
*
* This class returns <code>LockableMGraph</code>s a subtype of
<code>MGraph</code>
* that allows read/write locks.
- *
+ *
+ * This class also registers all TripleCollections as services with the
property
+ * 'name' indicating there name.
+ *
+ * Security checks are done when a TripleCollection is retrieved. The returned
+ * TripleCollection will do no further security checks. Because of this it
should
+ * not be passed to a context where different access control applies. If an
MGraph
+ * is retrieved without having write permission the returned mGraph will be
read-only.
+ *
+ * If a TripleCollections needs to passed around across different security
contexts
+ * the one retrieved from the OSGi service whiteboard should be used as this
+ * performs access control on every access.
*
* @author reto, mir, hasan
*
