You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commonsrdf.apache.org by st...@apache.org on 2016/10/09 01:21:33 UTC

[1/5] incubator-commonsrdf git commit: javadoc tweaks

Repository: incubator-commonsrdf
Updated Branches:
  refs/heads/master 7fdffa55a -> 0da19723c


javadoc tweaks


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

Branch: refs/heads/master
Commit: 6c7992233a6964500d5fe2186c63573e04bb49d4
Parents: 7fdffa5
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Fri Oct 7 23:01:47 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Fri Oct 7 23:01:47 2016 +0100

----------------------------------------------------------------------
 .../java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java    | 4 ----
 .../org/apache/commons/rdf/simple/DummyRDFParserBuilder.java   | 6 +++---
 2 files changed, 3 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/6c799223/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
----------------------------------------------------------------------
diff --git a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
index 07289cf..c29b0c4 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
@@ -225,8 +225,6 @@ public final class RDF4JTermFactory implements RDFTermFactory {
 	 *
 	 * @param value
 	 *            The RDF4J {@link Value} to convert.
-	 * @param <T>
-	 *            The subclass of {@link Value}, e.g. {@link BNode}
 	 * @return A {@link RDFTerm} that corresponds to the RDF4J value
 	 * @throws IllegalArgumentException
 	 *             if the value is not a BNode, Literal or IRI
@@ -254,8 +252,6 @@ public final class RDF4JTermFactory implements RDFTermFactory {
 	 *            multiple statements in the same {@link Repository} or
 	 *            {@link Model} to ensure {@link BlankNode#equals(Object)} and
 	 *            {@link BlankNode#uniqueReference()} works as intended.
-	 * @param <T>
-	 *            The subclass of {@link Value}, e.g. {@link BNode}
 	 * @return A {@link RDFTerm} that corresponds to the RDF4J value
 	 * @throws IllegalArgumentException
 	 *             if the value is not a BNode, Literal or IRI

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/6c799223/simple/src/test/java/org/apache/commons/rdf/simple/DummyRDFParserBuilder.java
----------------------------------------------------------------------
diff --git a/simple/src/test/java/org/apache/commons/rdf/simple/DummyRDFParserBuilder.java b/simple/src/test/java/org/apache/commons/rdf/simple/DummyRDFParserBuilder.java
index 683ef7b..769202f 100644
--- a/simple/src/test/java/org/apache/commons/rdf/simple/DummyRDFParserBuilder.java
+++ b/simple/src/test/java/org/apache/commons/rdf/simple/DummyRDFParserBuilder.java
@@ -34,13 +34,13 @@ import org.apache.commons.rdf.simple.experimental.RDFParseException;
  * <p>
  * This always insert at least the triple equivalent to:
  * <pre>
- *    <urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6> <http://example.com/greeting> "Hello world" .
+ *    &lt;urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6&gt; &lt;http://example.com/greeting&gt; "Hello world" .
  * </pre>
  * Additional triples match the corresponding getter in AbstractRDFParser,
  * e.g.:
  * <pre>
- *   <urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6> <http://example.com/base> <http://www.example.org/> .
- *   <urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6> <http://example.com/sourceFile> "/tmp/file.ttl" .   
+ *   &lt;urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6&gt; &lt;http://example.com/base&gt; &lt;http://www.example.org/&gt; .
+ *   &lt;urn:uuid:b7ac3fcc-4d86-4d28-8358-a1cd094974a6&gt; &lt;http://example.com/sourceFile&gt; "/tmp/file.ttl" .   
  * </pre> 
  * 
  *


[4/5] incubator-commonsrdf git commit: mvn clean package site

Posted by st...@apache.org.
mvn clean package site

.. to include japicmp report


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

Branch: refs/heads/master
Commit: bfe27c780cf0ef37cf900eec79f542be4c8c6135
Parents: 6a0f93a
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Sun Oct 9 02:17:31 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Sun Oct 9 02:17:31 2016 +0100

----------------------------------------------------------------------
 SITE.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/bfe27c78/SITE.md
----------------------------------------------------------------------
diff --git a/SITE.md b/SITE.md
index 05e37b2..ccdcad6 100644
--- a/SITE.md
+++ b/SITE.md
@@ -22,9 +22,9 @@
 
 Some common tasks:
 
-* Build the site: `mvn clean site` and then access the generated site at `target/site/index.html`
+* Build the site: `mvn clean package site` and then access the generated site at `target/site/index.html`
 
-* Publish the site: `mvn clean site scm-publish:publish-scm`
+* Publish the site: `mvn clean package site scm-publish:publish-scm`
 
 You will need to have `svn` installed.
 


[5/5] incubator-commonsrdf git commit: about modules

Posted by st...@apache.org.
about modules


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

Branch: refs/heads/master
Commit: 0da19723c80a3a7846f791a78345d4ca9568d32c
Parents: bfe27c7
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Sun Oct 9 02:21:25 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Sun Oct 9 02:21:25 2016 +0100

----------------------------------------------------------------------
 src/site/markdown/index.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/0da19723/src/site/markdown/index.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 71b0b68..242a556 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -125,14 +125,21 @@ The project is composed by two modules:
 * [Simple](apidocs/index.html?org/apache/commons/rdf/simple/package-summary.html)
   provides a simple implementation, mainly for internal validation and very simple
   scenarios.
+* [jena](apidocs/index.html?org/apache/commons/rdf/jena/package-summary.html)
+    provides an Apache Jena-backed implementation
 
-Both modules follow the [semantic versioning](http://semver.org/) principles,
+* [rdf4j](apidocs/index.html?org/apache/commons/rdf/rdf4j/package-summary.html)
+    provides an Eclipse RDF4J-backed implementation
+* [jsonld-java](apidocs/index.html?org/apache/commons/rdf/jsonldjava/package-summary.html)
+    provides an JSONLD-Java-backed implementation    
+
+These modules follow the [semantic versioning](http://semver.org/) principles,
 where version `x.y.z` of `Simple` implements version `x.y` of
 the `API`; i.e., the version `z` are backwards-compatible patches of the
 implementation.
 
-[Implementations of the Commons RDF API](implementations.html) are
-being developed as additional modules. [Contributions welcome!](contributing.html)
+For more details, read about the
+[implementations of the Commons RDF API](implementations.html).
 
 
 ## Contributing


[2/5] incubator-commonsrdf git commit: about implementations

Posted by st...@apache.org.
about implementations


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

Branch: refs/heads/master
Commit: 748c3c869e32c1fa7bb0393d638d80e94e2e3a80
Parents: 6c79922
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Sun Oct 9 02:15:48 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Sun Oct 9 02:15:48 2016 +0100

----------------------------------------------------------------------
 src/site/markdown/implementations.md | 176 ++++++++++++++++++++++--------
 1 file changed, 130 insertions(+), 46 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/748c3c86/src/site/markdown/implementations.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/implementations.md b/src/site/markdown/implementations.md
index bf1b460..1b06b93 100644
--- a/src/site/markdown/implementations.md
+++ b/src/site/markdown/implementations.md
@@ -20,15 +20,26 @@
 
 # Implementations
 
-As a set of Java interfaces, Commons RDF must be used with one or more
+The Commons RDF API must be used with one or more
 implementations.
 
-## Current implementations
+The Apache Commons RDF distribution includes bindings for the implementations:
 
-### org.apache.commons.rdf.simple
+* [Commons RDF Simple](#Commons RDF Simple)
+* [Apache Jena](#Apache Jena)
+* [Eclipse RDF4J](#Apache Jena) (formerly Sesame)
+
+One goal of the Commons RDF API is to enable runtime cross-compatibility of such implementations, therefore it is perfectly valid to combine these and for instance do:
+
+* Copy triples from a Jena `Model` to an RDF4J `Repository`  (e.g. copying between two Common RDF `Graph`s)
+* Create an RDF4J-backed `Quad` that use a Jena-backed `BlankNode`
+* Read an RDF file with Jena's parsers into an RDF4J-backed `Dataset`
+
+
+### Commons RDF Simple
 
 [org.apache.commons.rdf.simple](apidocs/org/apache/commons/rdf/simple/package-summary.html)
-is maintained as part of Commons RDF, and its main purpose is to verify and
+is part of Commons RDF, and its main purpose is to verify and
 clarify the [test harness](testapidocs/org/apache/commons/rdf/api/package-summary.html).
 It is backed by simple (if not naive) in-memory POJO objects and have no external
 dependencies.
@@ -36,7 +47,7 @@ dependencies.
 Note that although this module fully implements the commons-rdf API, it should
 **not** be considered as a reference implementation. It is **not thread-safe** and
 probably **not scalable**, however it may be useful for testing and simple
-usage (e.g. prototyping).
+usage (e.g. prototyping and creating graph fragments).
 
 **Usage:**
 
@@ -44,7 +55,7 @@ usage (e.g. prototyping).
 <dependency>
     <groupId>org.apache.commons</groupId>
     <artifactId>commons-rdf-simple</artifactId>
-    <version>0.2.0-incubating-SNAPSHOT</version>
+    <version>0.3.0-incubating-SNAPSHOT</version>
 </dependency>
 ```
 
@@ -57,70 +68,143 @@ RDFTermFactory rdfTermFactory = new SimpleRDFTermFactory();
 Graph graph = rdfTermFactory.createGraph();
 ```
 
-### OWL API
+### Apache Jena
 
-[OWL API](http://owlapi.sourceforge.net/) 5 extends Commons RDF
-directly for its family of
-[RDFNode](https://github.com/owlcs/owlapi/blob/version5/api/src/main/java/org/semanticweb/owlapi/io/RDFNode.java#L25)
-implementations.
+[org.apache.commons.rdf.jena](apidocs/org/apache/commons/rdf/jena/package-summary.html) is an implementation of the Commons RDF API backed by [Apache Jena](http://jena.apache.org/), including converters from/to Jena and Commons RDF.
 
-For details, see [pull request #446](https://github.com/owlcs/owlapi/pull/446),
-and [pull request #452](https://github.com/owlcs/owlapi/pull/452)).
 
+**Usage:**
 
+```xml
+<dependency>
+    <groupId>org.apache.commons</groupId>
+    <artifactId>commons-rdf-jena</artifactId>
+    <version>0.3.0-incubating-SNAPSHOT</version>
+</dependency>
+```
 
-## Planned implementations
+```java
+import org.apache.commons.rdf.api.Graph;
+import org.apache.commons.rdf.api.RDFTermFactory;
+import org.apache.commons.rdf.jena.JenaRDFTermFactory;
 
-The information in this section should not be considered updated or
-authoritative as it describes ongoing development.
+RDFTermFactory rdfTermFactory = new JenaRDFTermFactory();
+Graph graph = rdfTermFactory.createGraph();
+```
 
-Feel free to [suggest changes](http://commonsrdf.incubator.apache.org/contributing.html) to the
-[source code for this page](https://github.com/apache/incubator-commonsrdf/blob/master/src/site/markdown/implementations.md).
+Objects created with  [JenaRDFTermFactory](apidocs/org/apache/commons/rdf/jena/JenaRDFTermFactory.html) implement interfaces like [JenaQuad](apidocs/org/apache/commons/rdf/jena/JenaQuad.html) and [JenaLiteral](apidocs/org/apache/commons/rdf/jena/JenaLiteral.html) which give access to the underlying Jena objects through methods like [asJenaNode()](apidocs/org/apache/commons/rdf/jena/JenaRDFTerm.html#asJenaNode--) and [asJenaGraph()](apidocs/org/apache/commons/rdf/jena/JenaGraph.html#asJenaGraph--).
 
+`JenaRDFTermFactory` includes additional methods for converting from/to Apache Jena and Commons RDF, like [fromJena(Node)](apidocs/org/apache/commons/rdf/jena/JenaRDFTermFactory.html#fromJena-org.apache.jena.graph.Node-) and [toJena(RDFTerm)](apidocs/org/apache/commons/rdf/jena/JenaRDFTermFactory.html#toJena-org.apache.commons.rdf.api.RDFTerm-).
 
+#### Generalized RDF
 
-### Apache Jena
+Apache Jena can support [generalized RDF](https://www.w3.org/TR/rdf11-concepts/#section-generalized-rdf), e.g.:
+
+> A generalized RDF triple is a triple having a subject, a predicate, and object, where each can be an IRI, a blank node or a literal.
+
+Within Commons RDF it is possible to create [generalized triples](apidocs/org/apache/commons/rdf/jena/JenaRDFTermFactory.html#createGeneralizedTriple-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-) and [quads](apidocs/org/apache/commons/rdf/jena/JenaRDFTermFactory.html#createGeneralizedQuad-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-) using `JenaRDFTermFactory` - however note that the returned [JenaGeneralizedTripleLike](apidocs/org/apache/commons/rdf/jena/JenaGeneralizedTripleLike.html) and
+[JenaGeneralizedQuadLike](apidocs/org/apache/commons/rdf/jena/JenaGeneralizedQuadLike.html)
+ do not have the [equality semantics of Triple](apidocs/org/apache/commons/rdf/api/Triple.html#equals-java.lang.Object-) or [Quad](apidocs/org/apache/commons/rdf/api/Quad.html#equals-java.lang.Object-) and thus can't be used with the regular [Graph](apidocs/org/apache/commons/rdf/api/Graph.html) or [Dataset](apidocs/org/apache/commons/rdf/api/Dataset.html) methods.
 
-An implementation that maps [Apache Jena](http://jena.apache.org/) types
-to Commons RDF is being developed on
-the [`jena`](https://github.com/apache/incubator-commonsrdf/tree/jena)
-branch of Commons RDF.
+The generalized triples/quads can be accessed as [org.apache.jena.graph.Triple](https://jena.apache.org/documentation/javadoc/jena/org/apache/jena/graph/Triple.html) and [org.apache.jena.sparql.core.Quad](https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/sparql/core/Quad.html) - but can't currently be used with an equivalent _generalized graph_ or _generalized dataset_ within Commons RDF (see [COMMONSRDF-42](https://issues.apache.org/jira/browse/COMMONSRDF-42)).
 
-For details, see [COMMONSRDF-33](https://issues.apache.org/jira/browse/COMMONSRDF-33),
-[JENA-1015](https://issues.apache.org/jira/browse/JENA-1015) or contact
-[dev@commonsrdf](mail-lists.html).
+### Eclipse RDF4j
 
+[org.apache.commons.rdf.rdf4j](apidocs/org/apache/commons/rdf/rdf4j/package-summary.html) is an implementation of the Commons RDF API backed by Eclispe [RDF4J 2.0](http://rdf4j.org/) (formerly Sesame), including converters from/to RDF4J and Commons RDF.
+
+**Usage:**
+
+```xml
+<dependency>
+    <groupId>org.apache.commons</groupId>
+    <artifactId>commons-rdf-rdf4j</artifactId>
+    <version>0.3.0-incubating-SNAPSHOT</version>
+</dependency>
+```
 
-### Eclipse RDF4j (formerly Sesame)
+```java
+import org.apache.commons.rdf.api.Graph;
+import org.apache.commons.rdf.api.RDFTermFactory;
+import org.apache.commons.rdf.rdf4j.RDF4JTermFactory;
 
-An implementation that maps [RDF4J 2.0](http://rdf4j.org/)
-to Commons RDF is being developed on
-the [`rdf4j`](https://github.com/apache/incubator-commonsrdf/tree/rdf4j)
-branch of Commons RDF.
+RDFTermFactory rdfTermFactory = new RDF4JTermFactory();
+Graph graph = rdfTermFactory.createGraph();
+```
 
+Objects created with  [RDF4JTermFactory](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.html) implement interfaces like [RDF4JTerm](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTerm.html) and [RDF4JGraph](apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html) which give access to the underlying Jena objects through methods like [asValue()](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTerm.html#asValue--) and [asRepository()](apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraphLike.html#asRepository--).
 
-For details, see [COMMONSRDF-35](https://issues.apache.org/jira/browse/COMMONSRDF-35),
-[SES-2091](https://openrdf.atlassian.net/browse/SES-2091) or contact
-[dev@commonsrdf](mail-lists.html).
+`RDF4JTermFactory` includes additional methods for converting from/to RDF4J and Commons RDF, like [asTriple(Statement)](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.html#asTriple-org.eclipse.rdf4j.model.Statement-) and
+[asRDFTerm(Value)](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.html#asRDFTerm-org.eclipse.rdf4j.model.Value-).
 
+#### Closing RDF4J resources
 
-### Eclipse RDF4j (formerly Sesame)
+When using `RDF4JTermFactory` with an RDF4J `Repository`, e.g. from [asRDFTermGraph(Repository)](apidocs/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.html#asRDFTermGraph-org.eclipse.rdf4j.repository.Repository-org.apache.commons.rdf.rdf4j.RDF4JTermFactory.Option...-), care must be taken to close underlying resources when using the methods [stream()](apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html#stream--) and [iterate()](apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html#iterate--) for both `Graph`s and `Dataset`s.
 
-An implementation that maps [JSON-LD-Java](https://github.com/jsonld-java/jsonld-java)
-to Commons RDF is being developed on
-the [`jsonld-java`](https://github.com/apache/incubator-commonsrdf/tree/jsonld-java/jsonld-java)
-branch of Commons RDF.
+This can generally achieved using a [try-with-resources](https://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html) block, e.g.:
+
+
+```java
+int subjects;
+try (Stream<RDF4JTriple> s : graph.stream(s,p,o)) {
+  subjects = s.map(RDF4JTriple::getSubject).distinct().count()
+}
+```
+
+This will ensure that the underlying RDF4J [RepositoryConnection](http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryConnection.html) and [RepositoryResult](http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryResult.html)
+
+Methods like [Graph.add()](apidocs/org/apache/commons/rdf/api/Graph.html#add-org.apache.commons.rdf.api.Triple-) will use and close separate transactions per method calls and therefore do not need any special handling; however this will come with a performance hit when calling graph/dataset methods repeatably. (See [COMMONSRDF-45](https://issues.apache.org/jira/browse/COMMONSRDF-45))
+
+[java.util.Iteratable](http://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html) and [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html) does not extend [`AutoClosable`](http://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html), and as there are many ways that a for-each loop may not run to exhaustion, Commons RDF introduces [ClosableIterable](apidocs/org/apache/commons/rdf/rdf4j/ClosableIterable.html), which can be used with RDF4J as:
+
+```java
+RDF4JGraph graph; // ...
+try (ClosableIterable<Triple> s : graph.iterate()) {
+ for (Triple t : triples) {
+     return t; // OK to terminate for-loop early
+ }
+}
+```
+
+### JSONLD-Java
+
+[org.apache.commons.rdf.jsonld](apidocs/org/apache/commons/rdf/jsonld/package-summary.html) is an implementation of the Commons RDF API backed by [JSON-LD-Java](https://github.com/jsonld-java/jsonld-java).
+
+This is primarily intended to support [JSON-LD](http://json-ld.org/) parsing and writing.
+
+**Usage:**
+
+```xml
+<dependency>
+    <groupId>org.apache.commons</groupId>
+    <artifactId>commons-rdf-jsonld</artifactId>
+    <version>0.3.0-incubating-SNAPSHOT</version>
+</dependency>
+```
+
+```java
+import org.apache.commons.rdf.api.Graph;
+import org.apache.commons.rdf.api.RDFTermFactory;
+import org.apache.commons.rdf.jsonld.JsonLdRDFTermFactory;
+
+RDFTermFactory rdfTermFactory = new JsonLdRDFTermFactory();
+Graph graph = rdfTermFactory.createGraph();
+```
+
+## External implementations
+
+
+### OWL API
+
+[OWL API](http://owlapi.sourceforge.net/) 5 extends Commons RDF
+directly for its family of
+[RDFNode](https://github.com/owlcs/owlapi/blob/version5/api/src/main/java/org/semanticweb/owlapi/io/RDFNode.java#L25)
+implementations. It is a partial compatibility implementation without its own `RDFTermFactory`, `Graph` or `Dataset`.
 
-This aims to support [JSON-LD](http://json-ld.org/) parsing and writing by adding
-new interfaces like
-[RDFParserBuilder](https://github.com/apache/incubator-commonsrdf/pull/21).
 
-For details, see [COMMONSRDF-36](https://issues.apache.org/jira/browse/COMMONSRDF-36) or contact
-[dev@commonsrdf](mail-lists.html).
 
+## Related implementations
 
 ### Apache Clerezza
 
 [Apache Clerezza](https://clerezza.apache.org/) is
-aligning its [RDF core](https://github.com/apache/clerezza-rdf-core) module
-with Commons RDF.
+aligning its [RDF core](https://github.com/apache/clerezza-rdf-core) module with Commons RDF.


[3/5] incubator-commonsrdf git commit: japicmp config

Posted by st...@apache.org.
japicmp config


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

Branch: refs/heads/master
Commit: 6a0f93aa462ab04788db3a5aae8c5e924865301a
Parents: 748c3c8
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Sun Oct 9 02:16:44 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Sun Oct 9 02:16:44 2016 +0100

----------------------------------------------------------------------
 pom.xml | 29 ++++++++++++++++-------------
 1 file changed, 16 insertions(+), 13 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/6a0f93aa/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 215b3a5..72563be 100644
--- a/pom.xml
+++ b/pom.xml
@@ -293,7 +293,7 @@
 					<link>https://jena.apache.org/documentation/javadoc/jena/</link>
 					<link>https://jena.apache.org/documentation/javadoc/arq/</link>
 					<link>http://rdf4j.org/javadoc/2.0/</link>
-					</links>                    
+					</links>
                 </configuration>
             </plugin>
             <!--
@@ -345,18 +345,6 @@
         </dependencies>
       </plugin>
 
-      <plugin>
-        <!-- Check if we broke compatibibility against previous release -->
-        <groupId>com.github.siom79.japicmp</groupId>
-        <artifactId>japicmp-maven-plugin</artifactId>
-        <version>${commons.japicmp.version}</version>
-        <configuration>
-          <parameter>
-            <!-- Tell japicmp about the -incubator suffix  -->
-            <oldVersionPattern>\d+\.\d+\.\d+\-incubating</oldVersionPattern>
-          </parameter>
-        </configuration>
-      </plugin>
 
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
@@ -434,6 +422,21 @@
                         </lifecycleMappingMetadata>
                     </configuration>
                 </plugin>
+	      <plugin>
+		<!-- Check if we broke compatibibility against previous release -->
+		<groupId>com.github.siom79.japicmp</groupId>
+		<artifactId>japicmp-maven-plugin</artifactId>
+		<version>${commons.japicmp.version}</version>
+		<configuration>
+		  <parameter>
+		    <!-- Tell japicmp about the -incubator suffix  -->
+		    <oldVersionPattern>\d+\.\d+\.\d+\-incubating</oldVersionPattern>
+		    <!-- japicmp requires "mvn package site" - below means "mvn
+			 site" still works (but without japicmp report) -->
+		    <ignoreMissingNewVersion/>
+		  </parameter>
+		</configuration>
+	      </plugin>
 
                 <!--
                 <plugin>