commonsrdf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wik...@apache.org
Subject [21/50] [abbrv] incubator-commonsrdf git commit: Clarify that internalIdentifer need not match ntriplesString
Date Fri, 27 Mar 2015 18:15:19 GMT
Clarify that internalIdentifer need not match ntriplesString

Project: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/commit/d2a7bf0f
Tree: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/tree/d2a7bf0f
Diff: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/diff/d2a7bf0f

Branch: refs/heads/master
Commit: d2a7bf0f1383e042cc6f6ba75392f6f9b898961c
Parents: 2800895
Author: Stian Soiland-Reyes <stain@apache.org>
Authored: Mon Jan 26 10:16:58 2015 +0000
Committer: Stian Soiland-Reyes <stain@apache.org>
Committed: Mon Jan 26 10:16:58 2015 +0000

----------------------------------------------------------------------
 .../com/github/commonsrdf/api/BlankNode.java     | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/d2a7bf0f/api/src/main/java/com/github/commonsrdf/api/BlankNode.java
----------------------------------------------------------------------
diff --git a/api/src/main/java/com/github/commonsrdf/api/BlankNode.java b/api/src/main/java/com/github/commonsrdf/api/BlankNode.java
index 5105dfa..ea586e1 100644
--- a/api/src/main/java/com/github/commonsrdf/api/BlankNode.java
+++ b/api/src/main/java/com/github/commonsrdf/api/BlankNode.java
@@ -18,11 +18,11 @@ package com.github.commonsrdf.api;
  * Blank Node</a>, as defined by <a href=
  * "http://www.w3.org/TR/rdf11-concepts/#section-blank-nodes" >RDF-1.1 Concepts
  * and Abstract Syntax</a>, a W3C Recommendation published on 25 February 2014.<br>
- *
+ * <p>
  * Note that: Blank nodes are disjoint from IRIs and literals. Otherwise, the
  * set of possible blank nodes is arbitrary. RDF makes no reference to any
  * internal structure of blank nodes.
- *
+ * <p>
  * Also note that: Blank node identifiers are local identifiers that are used in
  * some concrete RDF syntaxes or RDF store implementations. They are always
  * locally scoped to the file or RDF store, and are not persistent or portable
@@ -46,17 +46,17 @@ public interface BlankNode extends BlankNodeOrIRI {
 	 * >label</a> for the blank node. This is not a serialization/syntax label.
 	 * It should be uniquely identifying within the local scope it is created in
 	 * but has no uniqueness guarantees other than that.
-	 *
+	 * <p>
 	 * In particular, the existence of two objects of type {@link BlankNode}
 	 * with the same value returned from {@link #internalIdentifier()} are not
 	 * equivalent unless they are known to have been created in the same local
-	 * scope.
-	 *
+	 * scope (see {@link #equals(Object)})
+	 * <p>
 	 * An example of a local scope may be an instance of a Java Virtual Machine
 	 * (JVM). In the context of a JVM instance, an implementor may support
 	 * insertion and removal of {@link Triple} objects containing Blank Nodes
 	 * without modifying the blank node labels.
-	 *
+	 * <p>
 	 * Another example of a local scope may be a <a
 	 * href="http://www.w3.org/TR/rdf11-concepts/#section-rdf-graph">Graph</a>
 	 * or <a
@@ -67,11 +67,16 @@ public interface BlankNode extends BlankNodeOrIRI {
 	 * guarantee that it is unique for the JVM instance. In this case, the
 	 * implementor may support a mechanism to provide a mapping for blank nodes
 	 * between Graph or Dataset instances to guarantee their uniqueness.
-	 *
+	 * <p>
 	 * If implementors support <a
 	 * href="http://www.w3.org/TR/rdf11-concepts/#section-skolemization"
 	 * >Skolemisation</a>, they may map instances of {@link BlankNode} objects
 	 * to {@link IRI} objects to reduce scoping issues.
+	 * <p>
+	 * It is not a requirement for the internal identifier to be a part of the
+	 * {@link #ntriplesString()}, except that two BlankNode instances with the
+	 * same internalIdentifier() and same local scope should have the same
+	 * {@link #ntriplesString()}.
 	 *
 	 * @return An internal, system identifier for the {@link BlankNode}.
 	 */


Mime
View raw message