RDFDTerm is IRI/BlankNode/Literal. BlankNodeOrIRI is BlankNode/Literal Using "SHOULD" to leave open possibility of say a JenaSparqlVariable.
See https://github.com/apache/incubator-commonsrdf/pull/25#discussion_r85433083 Project: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/commit/fb0dd9c0 Tree: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/tree/fb0dd9c0 Diff: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/diff/fb0dd9c0 Branch: refs/heads/COMMONSRDF-7 Commit: fb0dd9c03ebba0da8cef75c1ee21343c9a1fdd81 Parents: d0501ac Author: Stian Soiland-Reyes <st...@apache.org> Authored: Fri Oct 28 11:27:45 2016 +0100 Committer: Stian Soiland-Reyes <st...@apache.org> Committed: Fri Oct 28 11:27:45 2016 +0100 ---------------------------------------------------------------------- .../java/org/apache/commons/rdf/api/BlankNodeOrIRI.java | 6 ++++-- .../main/java/org/apache/commons/rdf/api/RDFTerm.java | 11 +++++++---- 2 files changed, 11 insertions(+), 6 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/fb0dd9c0/api/src/main/java/org/apache/commons/rdf/api/BlankNodeOrIRI.java ---------------------------------------------------------------------- diff --git a/api/src/main/java/org/apache/commons/rdf/api/BlankNodeOrIRI.java b/api/src/main/java/org/apache/commons/rdf/api/BlankNodeOrIRI.java index 8999c6f..1c6c469 100644 --- a/api/src/main/java/org/apache/commons/rdf/api/BlankNodeOrIRI.java +++ b/api/src/main/java/org/apache/commons/rdf/api/BlankNodeOrIRI.java @@ -19,8 +19,10 @@ package org.apache.commons.rdf.api; /** * This interface represents the {@link RDFTerm}s that may be used in the - * subject position of an RDF-1.1 {@link Triple}, that is {@link BlankNode} - * and {@link IRI}. + * subject position of an RDF-1.1 {@link Triple} as well as the graph name + * position of a {@link Quad}. + * <p> + * Instances of BlankNodeOrIRI SHOULD be a {@link BlankNode} or an {@link IRI}. */ public interface BlankNodeOrIRI extends RDFTerm { } http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/fb0dd9c0/api/src/main/java/org/apache/commons/rdf/api/RDFTerm.java ---------------------------------------------------------------------- diff --git a/api/src/main/java/org/apache/commons/rdf/api/RDFTerm.java b/api/src/main/java/org/apache/commons/rdf/api/RDFTerm.java index 9488338..59d8fa1 100644 --- a/api/src/main/java/org/apache/commons/rdf/api/RDFTerm.java +++ b/api/src/main/java/org/apache/commons/rdf/api/RDFTerm.java @@ -19,12 +19,15 @@ package org.apache.commons.rdf.api; /** * An <a href= "http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-term" >RDF-1.1 - * Term</a>, as defined by <a href= "http://www.w3.org/TR/rdf11-concepts/" - * >RDF-1.1 Concepts and Abstract Syntax</a>, a W3C Recommendation published on - * 25 February 2014.<br> + * Term</a>, as defined by + * <a href= "http://www.w3.org/TR/rdf11-concepts/" >RDF-1.1 Concepts and + * Abstract Syntax</a>, a W3C Recommendation published on 25 February 2014.<br> + * <p> + * Instances of RDFTerm SHOULD be an {@link IRI}, {@link BlankNode} or + * {@link Literal}. * * @see <a href= "http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-term" >RDF-1.1 - * Term</a> + * Term</a> */ public interface RDFTerm {