Added: websites/production/commonsrdf/content/commons-rdf-parent/download.html ============================================================================== --- websites/production/commonsrdf/content/commons-rdf-parent/download.html (added) +++ websites/production/commonsrdf/content/commons-rdf-parent/download.html Thu Nov 17 14:45:34 2016 @@ -0,0 +1,327 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 17 November 2016 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20161117" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Commons RDF – Download Commons RDF</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + +<link rel="stylesheet" href="./css/prettify.css" media="all" type="text/css"/> +<script src="./js/prettify.js" type="text/javascript"></script> +<script type="text/javascript">window.onload=function() { + prettyPrint(); + }</script> + </head> + + <body class="composite"> + <a href="http://commonsrdf.incubator.apache.org/" id="bannerLeft" title="Apache Commons RDF logo"> + <img class="logo-left" src="images/commonsrdf-logo.png" alt="Apache Commons RDF logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commonsrdf.incubator.apache.org/">Commons RDF ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 17 November 2016</li> + <li class="divider">|</li> <li id="projectVersion">Version: 0.4.0-incubating-SNAPSHOT</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="http://commons.apache.org/" class="externalLink" title="Commons"> + Commons</a> + </li> + <li> + <a href="http://incubator.apache.org/" class="externalLink" title="Incubator"> + Incubator</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Project</li> + <li class="none"> + <a href="index.html" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html" title="API"> + API</a> + </li> + <li class="none"> + <a href="implementations.html" title="Implementations"> + Implementations</a> + </li> + <li class="none"> + <a href="userguide.html" title="User Guide"> + User Guide</a> + </li> + <li class="none active"> + <a href="download.html" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="contributing.html" title="Contributing"> + Contributing</a> + </li> + <li class="none"> + <a href="team-list.html" title="Team"> + Team</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Tools</li> + <li class="none"> + <a href="mail-lists.html" title="Mailing Lists"> + Mailing Lists</a> + </li> + <li class="none"> + <a href="https://git-wip-us.apache.org/repos/asf/incubator-commonsrdf.git" class="externalLink" title="Source (Git)"> + Source (Git)</a> + </li> + <li class="none"> + <a href="https://github.com/apache/incubator-commonsrdf/" class="externalLink" title="Source (GitHub mirror)"> + Source (GitHub mirror)</a> + </li> + <li class="none"> + <a href="https://issues.apache.org/jira/browse/COMMONSRDF" class="externalLink" title="Issues (Jira)"> + Issues (Jira)</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="../commons-rdf-api/api/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="http://commons.apache.org/" class="externalLink" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="http://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/components.html" class="externalLink" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/sandbox/index.html" class="externalLink" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/dormant/index.html" class="externalLink" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="http://commons.apache.org/security.html" class="externalLink" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/volunteering.html" class="externalLink" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/patches.html" class="externalLink" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/building.html" class="externalLink" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/commons-parent-pom.html" class="externalLink" title="Commons Parent Pom"> + Commons Parent Pom</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/build-plugin/index.html" class="externalLink" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/releases/index.html" class="externalLink" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="http://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + <!-- Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. --><h1>Download Commons RDF</h1> +<div class="section"> +<h2><a name="Maven"></a>Maven</h2> +<p>Apache Commons RDF (incubating) is available from <a class="externalLink" href="http://central.maven.org/maven2/org/apache/commons/commons-rdf-api/">Maven Central</a>, mirrored from <a class="externalLink" href="https://repository.apache.org/content/repositories/releases/org/apache/commons/commons-rdf-api/">ASF’s Maven repository</a>. For convenience of IDE users, the Maven artifacts include <tt>-javadoc.jar</tt> and <tt>-sources.jar</tt>, however you might prefer the online <a href="apidocs/">API javadoc</a> and the <a href="#Source_code">source code releases</a> (see below).</p> +<p>To use Commons RDF with <a class="externalLink" href="https://maven.apache.org/">Maven</a>, add to your <tt>pom.xml</tt>:</p> + +<div class="source"> +<div class="source"> +<pre><dependencies> + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-api</artifactId> + <version>0.3.0-incubating</version> + </dependency> + + <!-- and at least one of the implementations: --> + + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-simple</artifactId> + <version>0.3.0-incubating</version> + </dependency> + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-jsonld-java</artifactId> + <version>0.3.0-incubating</version> + </dependency> + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-jena</artifactId> + <version>0.3.0-incubating</version> + </dependency> + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-rdf4j</artifactId> + <version>0.3.0-incubating</version> + </dependency> + +</dependencies> +</pre></div></div> +<p>The <tt><version></tt> above might not be up to date, see the <a href="#Source_code">source code releases</a> below to find the latest version.</p> +<p>See the <a href="userguide.html">user guide</a> for documentation of the Apache Commons RDF API, and the <a href="implementations.html">implementations</a> for details on each of the bindings.</p></div> +<div class="section"> +<h2><a name="Source_code"></a>Source code</h2> +<p>Here you can find all source releases published by Apache Commons RDF (incubating).</p> +<p>For the latest developments you may also be interested in the <a href="source-repository.html">source code repository</a>, which is also <a class="externalLink" href="http://github.com/apache/incubator-commonsrdf">mirrored to GitHub</a>.</p> +<div class="section"> +<h3><a name="a0.3.0-incubating"></a>0.3.0-incubating</h3> +<p><b>Apache Commons RDF 0.3.0-incubating</b> was published on 2016-11-15, and is available for download from official mirrors of the ASF Distribution Directory <a class="externalLink" href="https://www.apache.org/dyn/closer.lua/incubator/commonsrdf/0.3.0-incubating/">incubator/commonsrdf</a>:</p> + +<ul> + +<li><a class="externalLink" href="https://www.apache.org/dyn/closer.lua/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.zip">apache-commons-rdf-0.3.0-incubating-src.zip</a> (<a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.zip.asc">asc</a>, <a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.zip.md5">md5</a>, <a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.zip.sha1">sha1</a>)</li> + +<li><a class="externalLink" href="https://www.apache.org/dyn/closer.lua/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.zip">apache-commons-rdf-0.3.0-incubating-src.tar.gz</a> (<a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.tar.gz.asc">asc</a>, <a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.tar.gz.md5">md5</a>, <a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/0.3.0-incubating/apache-commons-rdf-0.3.0-incubating-src.tar.gz.sha1">sha1</a>)</li> +</ul> +<p>After downloading the files, <a class="externalLink" href="https://www.apache.org/info/verification.html">check the signatures</a> using the following <a class="externalLink" href="https://www.apache.org/dist/incubator/commonsrdf/KEYS">KEYS</a> file. The <a class="externalLink" href="https://s.apache.org/rdf-0.3.0">changelog</a> is available from the <a class="externalLink" href="https://issues.apache.org/jira/browse/COMMONSRDF">Apache Commons RDF Jira</a>.</p></div> +<div class="section"> +<h3><a name="Previous_Releases"></a>Previous Releases</h3> +<p>Previous release are available from <a class="externalLink" href="https://archive.apache.org/dist/incubator/commonsrdf/">archive.apache.org</a>.</p></div></div> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2015-2016 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> \ No newline at end of file
Added: websites/production/commonsrdf/content/commons-rdf-parent/images/apache-incubator-logo.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/apache-incubator-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/class-diagram.nomnoml ============================================================================== --- websites/production/commonsrdf/content/commons-rdf-parent/images/class-diagram.nomnoml (added) +++ websites/production/commonsrdf/content/commons-rdf-parent/images/class-diagram.nomnoml Thu Nov 17 14:45:34 2016 @@ -0,0 +1,66 @@ +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// To render, see http://www.nomnoml.com + +#fill: #bbccdd; #aabbcc +#title: class-diagram + +#.like: fill=#fff italics + + +[<like>GraphLike] +[<like>TripleLike] +[<like>QuadLike] + +[<like>RDFTerm] +[<like>BlankNodeOrIRI] + +[<abstract>Graph] +[<abstract>Dataset] +[<abstract>Triple] +[<abstract>Quad] +[<abstract>Graph] + + +[<abstract>Literal] +[<abstract>IRI] +[<abstract>BlankNode] + +[GraphLike] -> 0..* [TripleLike] +[GraphLike]<:-[Graph] +[GraphLike]<:-[Dataset] +[Graph] -> 0..* [Triple] +[Dataset] -> 0..* [Quad] +[Triple] -> 3 [RDFTerm] +[Quad]->4 [RDFTerm] +[<abstract>TripleLike]<:-[Triple] +[<abstract>QuadLike]<:-[Quad] +[TripleLike]<:-[QuadLike] +[RDFTerm]<:-[Literal] +[RDFTerm]<:-[BlankNodeOrIRI] +[BlankNodeOrIRI]<:-[BlankNode] +[BlankNodeOrIRI]<:-[IRI] + +#.factory: fill=#ccbbdd italics +[<factory>RDF||createGraph()|createDataset()|createTriple(..)|createQuad(..)|..] + +// [RDF]<:-[<factory>Simple] +// [RDF]<:-[<factory>JenaRDF] +// [RDF]<:-[<factory>RDF4J] +// [RDF]<:-[<factory>JsonLdRDF] + + Added: websites/production/commonsrdf/content/commons-rdf-parent/images/class-diagram.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/class-diagram.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/close.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/close.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/collapsed.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/collapsed.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/commons-logo.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/commons-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/commonsrdf-logo.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/commonsrdf-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/commonsrdf-logo.xcf ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/commonsrdf-logo.xcf ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/expanded.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/expanded.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/external-classic.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/external-classic.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/help_logo.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/help_logo.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowfolderclosed1_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowfolderclosed1_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowfolderopen2_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowfolderopen2_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowwaste1_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowwaste1_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowwaste2_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_arrowwaste2_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_doc_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_doc_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_doc_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_doc_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_error_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_error_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_error_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_error_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_folder_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_folder_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_folder_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_folder_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_help_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_help_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_info_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_info_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_info_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_info_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_members_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_members_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_sortdown.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_sortdown.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_sortup.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_sortup.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_success_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_success_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_success_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_success_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_usergroups_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_usergroups_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_warning_lrg.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_warning_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_warning_sml.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/icon_warning_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/build-by-maven-black.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/build-by-maven-black.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/build-by-maven-white.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/build-by-maven-white.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/maven-feather.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/logos/maven-feather.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/newwindow-classic.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/newwindow-classic.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/nw_maj_rond.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/nw_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/rss.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/rss.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/strich.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/strich.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/sw_maj_rond.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/sw_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/images/sw_med_rond.gif ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/images/sw_med_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/img/glyphicons-halflings-white.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/img/glyphicons-halflings-white.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/img/glyphicons-halflings.png ============================================================================== Binary file - no diff available. Propchange: websites/production/commonsrdf/content/commons-rdf-parent/img/glyphicons-halflings.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/production/commonsrdf/content/commons-rdf-parent/implementations.html ============================================================================== --- websites/production/commonsrdf/content/commons-rdf-parent/implementations.html (added) +++ websites/production/commonsrdf/content/commons-rdf-parent/implementations.html Thu Nov 17 14:45:34 2016 @@ -0,0 +1,435 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 17 November 2016 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20161117" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Commons RDF – Implementations</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + +<link rel="stylesheet" href="./css/prettify.css" media="all" type="text/css"/> +<script src="./js/prettify.js" type="text/javascript"></script> +<script type="text/javascript">window.onload=function() { + prettyPrint(); + }</script> + </head> + + <body class="composite"> + <a href="http://commonsrdf.incubator.apache.org/" id="bannerLeft" title="Apache Commons RDF logo"> + <img class="logo-left" src="images/commonsrdf-logo.png" alt="Apache Commons RDF logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commonsrdf.incubator.apache.org/">Commons RDF ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 17 November 2016</li> + <li class="divider">|</li> <li id="projectVersion">Version: 0.4.0-incubating-SNAPSHOT</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="http://www.apache.org" class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="http://commons.apache.org/" class="externalLink" title="Commons"> + Commons</a> + </li> + <li> + <a href="http://incubator.apache.org/" class="externalLink" title="Incubator"> + Incubator</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Project</li> + <li class="none"> + <a href="index.html" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html" title="API"> + API</a> + </li> + <li class="none active"> + <a href="implementations.html" title="Implementations"> + Implementations</a> + </li> + <li class="none"> + <a href="userguide.html" title="User Guide"> + User Guide</a> + </li> + <li class="none"> + <a href="download.html" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="contributing.html" title="Contributing"> + Contributing</a> + </li> + <li class="none"> + <a href="team-list.html" title="Team"> + Team</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Tools</li> + <li class="none"> + <a href="mail-lists.html" title="Mailing Lists"> + Mailing Lists</a> + </li> + <li class="none"> + <a href="https://git-wip-us.apache.org/repos/asf/incubator-commonsrdf.git" class="externalLink" title="Source (Git)"> + Source (Git)</a> + </li> + <li class="none"> + <a href="https://github.com/apache/incubator-commonsrdf/" class="externalLink" title="Source (GitHub mirror)"> + Source (GitHub mirror)</a> + </li> + <li class="none"> + <a href="https://issues.apache.org/jira/browse/COMMONSRDF" class="externalLink" title="Issues (Jira)"> + Issues (Jira)</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Modules</li> + <li class="none"> + <a href="../commons-rdf-api/api/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="http://commons.apache.org/" class="externalLink" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="http://www.apache.org/licenses/" class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/components.html" class="externalLink" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/sandbox/index.html" class="externalLink" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="http://commons.apache.org/dormant/index.html" class="externalLink" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="http://commons.apache.org/security.html" class="externalLink" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/volunteering.html" class="externalLink" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/patches.html" class="externalLink" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/building.html" class="externalLink" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/commons-parent-pom.html" class="externalLink" title="Commons Parent Pom"> + Commons Parent Pom</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/build-plugin/index.html" class="externalLink" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="http://commons.apache.org/releases/index.html" class="externalLink" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /> + </a> + <a href="http://maven.apache.org/" title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a> + </div> + </td> + <td class="content"> + <!-- Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. --><h1>Implementations</h1> +<p>The Commons RDF API must be used with one or more implementations.</p> +<p>The Apache Commons RDF distribution includes bindings for the implementations:</p> + +<ul> + +<li><a href="#Commons_RDF_Simple">Commons RDF Simple</a></li> + +<li><a href="#Apache_Jena">Apache Jena</a></li> + +<li><a href="#Eclipse_RDF4J">Eclipse RDF4J</a> (formerly Sesame)</li> + +<li><a href="#JSONLD-Java">JSONLD-Java</a></li> +</ul> +<p>In addition there can be <a href="#External-implementations">External implementations</a> which are released separately by their respective projects.</p> +<p>One goal of the Commons RDF API is to enable runtime cross-compatibility of its implementations, therefore it is perfectly valid to combine them and for instance do:</p> + +<ul> + +<li>Copy triples from a Jena <tt>Model</tt> to an RDF4J <tt>Repository</tt> (e.g. copying between two Common RDF <tt>Graph</tt>s)</li> + +<li>Create an RDF4J-backed <tt>Quad</tt> that use a Jena-backed <tt>BlankNode</tt></li> + +<li>Read an RDF file with Jena’s parsers into an RDF4J-backed <tt>Dataset</tt></li> +</ul> +<div class="section"> +<div class="section"> +<h3><a name="Commons_RDF_Simple"></a>Commons RDF Simple</h3> +<p><a href="apidocs/org/apache/commons/rdf/simple/package-summary.html">org.apache.commons.rdf.simple</a> is part of Commons RDF, and its main purpose is to verify and clarify the <a href="testapidocs/org/apache/commons/rdf/api/package-summary.html">test harness</a>. It is backed by simple (if not naive) in-memory POJO objects and have no external dependencies.</p> +<p>Note that although this module fully implements the commons-rdf API, it should <b>not</b> be considered as a reference implementation. It is <b>not thread-safe</b> and probably <b>not scalable</b>, however it may be useful for testing and simple usage (e.g. prototyping and creating graph fragments).</p> +<p><b>Usage:</b></p> + +<div class="source"> +<div class="source"> +<pre><dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-simple</artifactId> + <version>0.3.0-incubating</version> +</dependency> +</pre></div></div> + +<div class="source"> +<div class="source"> +<pre>import org.apache.commons.rdf.api.Graph; +import org.apache.commons.rdf.api.RDF; +import org.apache.commons.rdf.simple.SimpleRDF; + +RDF rdf = new SimpleRDF(); +Graph graph = rdf.createGraph(); +</pre></div></div></div> +<div class="section"> +<h3><a name="Apache_Jena"></a>Apache Jena</h3> +<p><a href="apidocs/org/apache/commons/rdf/jena/package-summary.html">org.apache.commons.rdf.jena</a> is an implementation of the Commons RDF API backed by <a class="externalLink" href="http://jena.apache.org/">Apache Jena</a>, including converters from/to Jena and Commons RDF.</p> +<p><b>Usage:</b></p> + +<div class="source"> +<div class="source"> +<pre><dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-jena</artifactId> + <version>0.3.0-incubating</version> +</dependency> +</pre></div></div> + +<div class="source"> +<div class="source"> +<pre>import org.apache.commons.rdf.api.Graph; +import org.apache.commons.rdf.api.RDFTermFactory; +import org.apache.commons.rdf.jena.JenaRDF; + +RDF rdf = new JenaRDF(); +Graph graph = rdf.createGraph(); +</pre></div></div> +<p>Objects created with <a href="apidocs/org/apache/commons/rdf/jena/JenaRDF.html">JenaRDF</a> implement interfaces like <a href="apidocs/org/apache/commons/rdf/jena/JenaQuad.html">JenaQuad</a> and <a href="apidocs/org/apache/commons/rdf/jena/JenaLiteral.html">JenaLiteral</a> which give access to the underlying Jena objects through methods like <a href="apidocs/org/apache/commons/rdf/jena/JenaRDFTerm.html#asJenaNode--">asJenaNode()</a> and <a href="apidocs/org/apache/commons/rdf/jena/JenaGraph.html#asJenaGraph--">asJenaGraph()</a>.</p> +<p><tt>JenaRDF</tt> includes additional methods for converting from/to Apache Jena and Commons RDF, like <a href="apidocs/org/apache/commons/rdf/jena/JenaRDF.html#asRDFTerm-org.apache.jena.graph.Node-">asRDFTerm(Node)</a> and <a href="apidocs/org/apache/commons/rdf/jena/JenaRDF.html#asJenaNode-org.apache.commons.rdf.api.RDFTerm-">asJenaNode(RDFTerm)</a>.</p> +<div class="section"> +<h4><a name="Generalized_RDF"></a>Generalized RDF</h4> +<p>Apache Jena can support <a class="externalLink" href="https://www.w3.org/TR/rdf11-concepts/#section-generalized-rdf">generalized RDF</a>, e.g.:</p> + +<blockquote> +<p>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.</p> +</blockquote> +<p>Within Commons RDF it is possible to create <a href="apidocs/org/apache/commons/rdf/jena/JenaRDF.html#createGeneralizedTriple-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-org.apache.commons.rdf.api.RDFTerm-">generalized triples</a> and <a href="apidocs/org/apache/commons/rdf/jena/JenaRDF.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-">quads</a> using <tt>JenaRDF</tt> - however note that the returned <a href="apidocs/org/apache/commons/rdf/jena/JenaGeneralizedTripleLike.html">JenaGeneralizedTripleLike</a> and <a href="apidocs/org/apache/commons/rdf/jena/JenaGeneralizedQuadLike.html">JenaGeneralizedQuadLike</a> do not have the <a href="apidocs/org/apache/commons/rdf/api/Triple.html#equals-java.lang.Object-">equality semantics of Triple</a> or <a href="apidocs/org/apache/commons/rdf/api/Quad.html#equals-java.lang.Object-">Quad</a> and thu s can’t be used with the regular <a href="apidocs/org/apache/commons/rdf/api/Graph.html">Graph</a> or <a href="apidocs/org/apache/commons/rdf/api/Dataset.html">Dataset</a> methods.</p> +<p>The generalized triples/quads can be accessed as <a class="externalLink" href="https://jena.apache.org/documentation/javadoc/jena/org/apache/jena/graph/Triple.html">org.apache.jena.graph.Triple</a> and <a class="externalLink" href="https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/sparql/core/Quad.html">org.apache.jena.sparql.core.Quad</a> - but can’t currently be used with an equivalent <i>generalized graph</i> or <i>generalized dataset</i> within Commons RDF (see <a class="externalLink" href="https://issues.apache.org/jira/browse/COMMONSRDF-42">COMMONSRDF-42</a>).</p></div></div> +<div class="section"> +<h3><a name="Eclipse_RDF4J"></a>Eclipse RDF4J</h3> +<p><a href="apidocs/org/apache/commons/rdf/rdf4j/package-summary.html">org.apache.commons.rdf.rdf4j</a> is an implementation of the Commons RDF API backed by Eclispe <a class="externalLink" href="http://rdf4j.org/">RDF4J 2.0</a> (formerly Sesame), including converters from/to RDF4J and Commons RDF.</p> +<p><b>Usage:</b></p> + +<div class="source"> +<div class="source"> +<pre><dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-rdf4j</artifactId> + <version>0.3.0-incubating</version> +</dependency> +</pre></div></div> + +<div class="source"> +<div class="source"> +<pre>import org.apache.commons.rdf.api.Graph; +import org.apache.commons.rdf.api.RDF; +import org.apache.commons.rdf.rdf4j.RDF4J; + +RDF rdf = new RDF4J(); +Graph graph = rdf.createGraph(); +</pre></div></div> +<p>Objects created with <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4J.html">RDF4J</a> implement interfaces like <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JTerm.html">RDF4JTerm</a> and <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html">RDF4JGraph</a> which give access to the underlying Jena objects through methods like <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JTerm.html#asValue--">asValue()</a> and <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraphLike.html#asRepository--">asRepository()</a>.</p> +<p><tt>RDF4J</tt> includes additional methods for converting from/to RDF4J and Commons RDF, like <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4J.html#asTriple-org.eclipse.rdf4j.model.Statement-">asTriple(Statement)</a> and <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4J.html#asRDFTerm-org.eclipse.rdf4j.model.Value-">asRDFTerm(Value)</a>.</p> +<div class="section"> +<h4><a name="Closing_RDF4J_resources"></a>Closing RDF4J resources</h4> +<p>When using <tt>RDF4J</tt> with an RDF4J <tt>Repository</tt>, e.g. from <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4J.html#asGraph-org.eclipse.rdf4j.repository.Repository-org.apache.commons.rdf.rdf4j.RDF4J.Option...-">asRDFTermGraph(Repository)</a>, care must be taken to close underlying resources when using the methods <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html#stream--">stream()</a> and <a href="apidocs/org/apache/commons/rdf/rdf4j/RDF4JGraph.html#iterate--">iterate()</a> for both <tt>Graph</tt>s and <tt>Dataset</tt>s.</p> +<p>This can generally achieved using a <a class="externalLink" href="https://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html">try-with-resources</a> block, e.g.:</p> + +<div class="source"> +<div class="source"> +<pre>int subjects; +try (Stream<RDF4JTriple> s : graph.stream(s,p,o)) { + subjects = s.map(RDF4JTriple::getSubject).distinct().count() +} +</pre></div></div> +<p>This will ensure that the underlying RDF4J <a class="externalLink" href="http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryConnection.html">RepositoryConnection</a> and <a class="externalLink" href="http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryResult.html">RepositoryResult</a> are closed after use.</p> +<p>Methods that return directly, like <a href="apidocs/org/apache/commons/rdf/api/Graph.html#add-org.apache.commons.rdf.api.Triple-">Graph.add()</a> and <a href="apidocs/org/apache/commons/rdf/api/Dataset.html#size--">Dataset.size()</a> 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 doing multiple graph/dataset modifications. (See <a class="externalLink" href="https://issues.apache.org/jira/browse/COMMONSRDF-45">COMMONSRDF-45</a>)</p> +<p>Java’s <a class="externalLink" href="http://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html">java.util.Iteratable</a> and <a class="externalLink" href="http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html">java.util.Iterator</a> does not extend <a class="externalLink" href="http://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"><tt>AutoClosable</tt></a>, and as there are many ways that a for-each loop may not run to exhaustion, Commons RDF introduces <a href="apidocs/org/apache/commons/rdf/rdf4j/ClosableIterable.html">ClosableIterable</a>, which can be used with RDF4J as:</p> + +<div class="source"> +<div class="source"> +<pre>RDF4JGraph graph; // ... +try (ClosableIterable<Triple> s : graph.iterate()) { + for (Triple t : triples) { + return t; // OK to terminate for-loop early + } +} +</pre></div></div></div></div> +<div class="section"> +<h3><a name="JSONLD-Java"></a>JSONLD-Java</h3> +<p><a href="apidocs/org/apache/commons/rdf/jsonld/package-summary.html">org.apache.commons.rdf.jsonld</a> is an implementation of the Commons RDF API backed by <a class="externalLink" href="https://github.com/jsonld-java/jsonld-java">JSON-LD-Java</a>.</p> +<p>This is primarily intended to support <a class="externalLink" href="http://json-ld.org/">JSON-LD</a> parsing and writing.</p> +<p><b>Usage:</b></p> + +<div class="source"> +<div class="source"> +<pre><dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-rdf-jsonld</artifactId> + <version>0.3.0-incubating</version> +</dependency> +</pre></div></div> + +<div class="source"> +<div class="source"> +<pre>import org.apache.commons.rdf.api.Graph; +import org.apache.commons.rdf.api.RDFTermFactory; +import org.apache.commons.rdf.jsonld.JsonLdFactory; + +RDF rdf = new JsonLdRDF(); +Graph graph = rdfTermFactory.createGraph(); +</pre></div></div></div></div> +<div class="section"> +<h2><a name="External_implementations"></a>External implementations</h2> +<div class="section"> +<h3><a name="OWL_API"></a>OWL API</h3> +<p><a class="externalLink" href="http://owlapi.sourceforge.net/">OWL API</a> 5 extends Commons RDF directly for its family of <a class="externalLink" href="https://github.com/owlcs/owlapi/blob/version5/api/src/main/java/org/semanticweb/owlapi/io/RDFNode.java#L25">RDFNode</a> implementations. It is a partial compatibility implementation without its own <tt>RDFTermFactory</tt>, <tt>Graph</tt> or <tt>Dataset</tt>.</p></div></div> +<div class="section"> +<h2><a name="Related_implementations"></a>Related implementations</h2> +<div class="section"> +<h3><a name="Apache_Clerezza"></a>Apache Clerezza</h3> +<p><a class="externalLink" href="https://clerezza.apache.org/">Apache Clerezza</a> is aligning its <a class="externalLink" href="https://github.com/apache/clerezza-rdf-core">RDF core</a> module with Commons RDF.</p></div></div> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2015-2016 + <a href="https://www.apache.org/">The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> \ No newline at end of file