Modified: websites/staging/commonsrdf/trunk/dependency-info.html ============================================================================== --- websites/staging/commonsrdf/trunk/dependency-info.html (original) +++ websites/staging/commonsrdf/trunk/dependency-info.html Thu Nov 17 14:31:21 2016 @@ -9,7 +9,7 @@ <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>Commons RDF API – Dependency Information</title> + <title>Apache Commons RDF – Dependency Information</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -30,14 +30,14 @@ <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"/> + <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-api/">Commons RDF API ™</a> + <a class="brand" href="https://commonsrdf.incubator.apache.org/">Commons RDF ™</a> <ul class="nav"> <li id="publishDate">Last Published: 17 November 2016</li> @@ -72,8 +72,69 @@ <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"> + <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/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + <li class="none"> + <a href="commons-rdf-simple/index.html" title="Commons RDF impl: Simple"> + Commons RDF impl: Simple</a> + </li> + </ul> + <ul class="nav nav-list"> <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> - <li class="expanded"> + <li class="expanded"> <a href="project-info.html" title="Project Information"> Project Information</a> <ul> @@ -86,6 +147,10 @@ Summary</a> </li> <li class="none"> + <a href="modules.html" title="Project Modules"> + Project Modules</a> + </li> + <li class="none"> <a href="team-list.html" title="Team"> Team</a> </li> @@ -123,7 +188,7 @@ </li> </ul> </li> - <li class="collapsed"> + <li class="collapsed"> <a href="project-reports.html" title="Project Reports"> Project Reports</a> </li> @@ -231,37 +296,38 @@ <div class="source"> <pre><dependency> <groupId>org.apache.commons</groupId> - <artifactId>commons-rdf-api</artifactId> + <artifactId>commons-rdf-parent</artifactId> <version>0.4.0-incubating-SNAPSHOT</version> + <type>pom</type> </dependency></pre></div></div> <div class="section"> <h3><a name="Apache_Buildr"></a>Apache Buildr</h3><a name="Apache_Buildr"></a> <div class="source"> -<pre>'org.apache.commons:commons-rdf-api:jar:0.4.0-incubating-SNAPSHOT'</pre></div></div> +<pre>'org.apache.commons:commons-rdf-parent:pom:0.4.0-incubating-SNAPSHOT'</pre></div></div> <div class="section"> <h3><a name="Apache_Ivy"></a>Apache Ivy</h3><a name="Apache_Ivy"></a> <div class="source"> -<pre><dependency org="org.apache.commons" name="commons-rdf-api" rev="0.4.0-incubating-SNAPSHOT"> - <artifact name="commons-rdf-api" type="jar" /> +<pre><dependency org="org.apache.commons" name="commons-rdf-parent" rev="0.4.0-incubating-SNAPSHOT"> + <artifact name="commons-rdf-parent" type="pom" /> </dependency></pre></div></div> <div class="section"> <h3><a name="Groovy_Grape"></a>Groovy Grape</h3><a name="Groovy_Grape"></a> <div class="source"> <pre>@Grapes( -@Grab(group='org.apache.commons', module='commons-rdf-api', version='0.4.0-incubating-SNAPSHOT') +@Grab(group='org.apache.commons', module='commons-rdf-parent', version='0.4.0-incubating-SNAPSHOT') )</pre></div></div> <div class="section"> <h3><a name="GradleGrails"></a>Gradle/Grails</h3><a name="GradleGrails"></a> <div class="source"> -<pre>compile 'org.apache.commons:commons-rdf-api:0.4.0-incubating-SNAPSHOT'</pre></div></div> +<pre>compile 'org.apache.commons:commons-rdf-parent:0.4.0-incubating-SNAPSHOT'</pre></div></div> <div class="section"> <h3><a name="Scala_SBT"></a>Scala SBT</h3><a name="Scala_SBT"></a> <div class="source"> -<pre>libraryDependencies += "org.apache.commons" % "commons-rdf-api" % "0.4.0-incubating-SNAPSHOT"</pre></div></div> +<pre>libraryDependencies += "org.apache.commons" % "commons-rdf-parent" % "0.4.0-incubating-SNAPSHOT"</pre></div></div> <div class="section"> <h3><a name="Leiningen"></a>Leiningen</h3><a name="Leiningen"></a> <div class="source"> -<pre>[org.apache.commons/commons-rdf-api "0.4.0-incubating-SNAPSHOT"]</pre></div></div></div> +<pre>[org.apache.commons/commons-rdf-parent "0.4.0-incubating-SNAPSHOT"]</pre></div></div></div> </td> </tr> </table>
Modified: websites/staging/commonsrdf/trunk/distribution-management.html ============================================================================== --- websites/staging/commonsrdf/trunk/distribution-management.html (original) +++ websites/staging/commonsrdf/trunk/distribution-management.html Thu Nov 17 14:31:21 2016 @@ -9,7 +9,7 @@ <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>Commons RDF API – Project Distribution Management</title> + <title>Apache Commons RDF – Project Distribution Management</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -30,14 +30,14 @@ <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"/> + <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-api/">Commons RDF API ™</a> + <a class="brand" href="https://commonsrdf.incubator.apache.org/">Commons RDF ™</a> <ul class="nav"> <li id="publishDate">Last Published: 17 November 2016</li> @@ -72,8 +72,69 @@ <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"> + <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/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + <li class="none"> + <a href="commons-rdf-simple/index.html" title="Commons RDF impl: Simple"> + Commons RDF impl: Simple</a> + </li> + </ul> + <ul class="nav nav-list"> <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> - <li class="expanded"> + <li class="expanded"> <a href="project-info.html" title="Project Information"> Project Information</a> <ul> @@ -86,6 +147,10 @@ Summary</a> </li> <li class="none"> + <a href="modules.html" title="Project Modules"> + Project Modules</a> + </li> + <li class="none"> <a href="team-list.html" title="Team"> Team</a> </li> @@ -123,7 +188,7 @@ </li> </ul> </li> - <li class="collapsed"> + <li class="collapsed"> <a href="project-reports.html" title="Project Reports"> Project Reports</a> </li> @@ -228,14 +293,14 @@ <h2><a name="Overview"></a>Overview</h2><a name="Overview"></a> <p>The following is the distribution management information used by this project.</p> <div class="section"> -<h3><a name="Download_URL"></a>Download URL</h3><a name="Download_URL"></a><a class="externalLink" href="https://commonsrdf.incubator.apache.org/commons-rdf-api/download.html">https://commonsrdf.incubator.apache.org/commons-rdf-api/download.html</a></div> +<h3><a name="Download_URL"></a>Download URL</h3><a name="Download_URL"></a><a class="externalLink" href="https://commonsrdf.incubator.apache.org/download.html">https://commonsrdf.incubator.apache.org/download.html</a></div> <div class="section"> <h3><a name="Repository_-_apache.releases.https"></a>Repository - apache.releases.https</h3><a name="Repository_-_apache.releases.https"></a><a class="externalLink" href="https://repository.apache.org/service/local/staging/deploy/maven2">https://repository.apache.org/service/local/staging/deploy/maven2</a></div> <div class="section"> <h3><a name="Snapshot_Repository_-_apache.snapshots.https"></a>Snapshot Repository - apache.snapshots.https</h3><a name="Snapshot_Repository_-_apache.snapshots.https"></a><a class="externalLink" href="https://repository.apache.org/content/repositories/snapshots">https://repository.apache.org/content/repositories/snapshots</a></div> <div class="section"> -<h3><a name="Site_-_commonsrdf-api-site"></a>Site - commonsrdf-api-site</h3><a name="Site_-_commonsrdf-api-site"></a> -<p>scm:svn:https://svn.apache.org/repos/infra/websites/staging/commonsrdf/trunk//api/</p></div></div> +<h3><a name="Site_-_commonsrdf-site"></a>Site - commonsrdf-site</h3><a name="Site_-_commonsrdf-site"></a> +<p>scm:svn:https://svn.apache.org/repos/infra/websites/staging/commonsrdf/trunk/</p></div></div> </td> </tr> </table> Added: websites/staging/commonsrdf/trunk/download.html ============================================================================== --- websites/staging/commonsrdf/trunk/download.html (added) +++ websites/staging/commonsrdf/trunk/download.html Thu Nov 17 14:31:21 2016 @@ -0,0 +1,331 @@ +<!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/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + <li class="none"> + <a href="commons-rdf-simple/index.html" title="Commons RDF impl: Simple"> + Commons RDF impl: Simple</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/staging/commonsrdf/trunk/images/apache-incubator-logo.png ============================================================================== Binary file - no diff available. Propchange: websites/staging/commonsrdf/trunk/images/apache-incubator-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/staging/commonsrdf/trunk/images/class-diagram.nomnoml ============================================================================== --- websites/staging/commonsrdf/trunk/images/class-diagram.nomnoml (added) +++ websites/staging/commonsrdf/trunk/images/class-diagram.nomnoml Thu Nov 17 14:31:21 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/staging/commonsrdf/trunk/images/class-diagram.png ============================================================================== Binary file - no diff available. Propchange: websites/staging/commonsrdf/trunk/images/class-diagram.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/staging/commonsrdf/trunk/images/commonsrdf-logo.png ============================================================================== Binary file - no diff available. Propchange: websites/staging/commonsrdf/trunk/images/commonsrdf-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/staging/commonsrdf/trunk/images/commonsrdf-logo.xcf ============================================================================== Binary file - no diff available. Propchange: websites/staging/commonsrdf/trunk/images/commonsrdf-logo.xcf ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/staging/commonsrdf/trunk/images/rss.png ============================================================================== Binary file - no diff available. Propchange: websites/staging/commonsrdf/trunk/images/rss.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: websites/staging/commonsrdf/trunk/implementations.html ============================================================================== --- websites/staging/commonsrdf/trunk/implementations.html (added) +++ websites/staging/commonsrdf/trunk/implementations.html Thu Nov 17 14:31:21 2016 @@ -0,0 +1,439 @@ +<!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/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + <li class="none"> + <a href="commons-rdf-simple/index.html" title="Commons RDF impl: Simple"> + Commons RDF impl: Simple</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 Modified: websites/staging/commonsrdf/trunk/index.html ============================================================================== --- websites/staging/commonsrdf/trunk/index.html (original) +++ websites/staging/commonsrdf/trunk/index.html Thu Nov 17 14:31:21 2016 @@ -9,7 +9,7 @@ <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>Commons RDF API – About</title> + <title>Apache Commons RDF – Apache Commons RDF (incubating)</title> <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> <link rel="stylesheet" href="./css/site.css" type="text/css" /> @@ -30,14 +30,14 @@ <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"/> + <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-api/">Commons RDF API ™</a> + <a class="brand" href="https://commonsrdf.incubator.apache.org/">Commons RDF ™</a> <ul class="nav"> <li id="publishDate">Last Published: 17 November 2016</li> @@ -72,8 +72,69 @@ <td class="sidebar"> <div class="well sidebar-nav"> <ul class="nav nav-list"> + <li class="nav-header">Project</li> + <li class="none active"> + <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"> + <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/index.html" title="Commons RDF API"> + Commons RDF API</a> + </li> + <li class="none"> + <a href="commons-rdf-simple/index.html" title="Commons RDF impl: Simple"> + Commons RDF impl: Simple</a> + </li> + </ul> + <ul class="nav nav-list"> <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> - <li class="expanded"> + <li class="expanded"> <a href="project-info.html" title="Project Information"> Project Information</a> <ul> @@ -86,6 +147,10 @@ Summary</a> </li> <li class="none"> + <a href="modules.html" title="Project Modules"> + Project Modules</a> + </li> + <li class="none"> <a href="team-list.html" title="Team"> Team</a> </li> @@ -123,7 +188,7 @@ </li> </ul> </li> - <li class="collapsed"> + <li class="collapsed"> <a href="project-reports.html" title="Project Reports"> Project Reports</a> </li> @@ -224,9 +289,112 @@ </div> </td> <td class="content"> - <div class="section"> -<h2><a name="About_Commons_RDF_API"></a>About Commons RDF API</h2><a name="About_Commons_RDF_API"></a> -<p>Commons Java API for RDF 1.1</p></div> + <!-- 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>Apache Commons RDF (incubating)</h1> + +<div class="alert alert-info" role="alert"> + +<p> + <span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span> + Commons RDF has transitioned to the + <a class="alert-link" href="http://incubator.apache.org/">Apache Incubator</a>, with an aim to + become part of + <a class="alert-link" href="http://commons.apache.org/">Apache Commons</a>. + This project + was previously hosted at + <a class="alert-link" href="http://commons-rdf.github.io/">commons-rdf.github.io</a>, + which is not affiliated with the Apache Software Foundation. + </p> +</div> +<p>Commons RDF aims to provide a common library for <a class="externalLink" href="http://www.w3.org/TR/rdf11-concepts/">RDF 1.1</a> that could be implemented by systems on the Java Virtual Machine.</p> + +<div style="float: right; margin-left: 6em; margin-right: 2em;"> + <a href="images/class-diagram.png"> + <img src="images/class-diagram.png" alt="Class diagram" style="height: 48em" /> + </a> +</div> +<p>The main motivation behind this simple library is revise an historical incompatibility issue. This library does not pretend to be a generic api wrapping those libraries, but a set of interfaces for the RDF 1.1 concepts that can be used to expose common RDF-1.1 concepts using common Java interfaces. In the initial phase commons-rdf is focused on a subset of the core concepts defined by RDF-1.1 (URI/IRI, Blank Node, Literal, Triple, and Graph). In particular, commons RDF aims to provide a type-safe, non-general API that covers RDF 1.1. In a future phase we may define interfaces for Datasets and Quads.</p> +<div class="section"> +<h2><a name="API"></a>API</h2> +<p>The <a href="images/class-diagram.png">class diagram</a> on the right depicts the main <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">interfaces</a> which may be included in Commons RDF, specifically:</p> + +<ul> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Graph.html">Graph</a>: a graph, a set of RDF triples.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Triple.html">Triple</a>: a RDF triple with <tt>getSubject()</tt>, <tt>getPredicate()</tt>, <tt>getObject()</tt>.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Dataset.html">Dataset</a>: a dataset, of RDF quads (or if you like, a set of named graphs).</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Quad.html">Quad</a>: a RDF quad with with <tt>getGraphName()</tt>, <tt>getSubject()</tt>, <tt>getPredicate()</tt>, <tt>getObject()</tt>.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/RDFTerm.html">RDFTerm</a>: any RDF 1.1 Term which can be part of a Triple or Quad. IRIs, literals and blank nodes are collectively known as RDF terms.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/IRI.html">IRI</a>: an Internationalized Resource Identifier (e.g. representing <tt><http://example.com/></tt>)</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/BlankNode.html">BlankNode</a>: a RDF-1.1 Blank Node, e.g. representing <tt>_:b1</tt>. Disjoint from IRIs and literals.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/BlankNodeOrIRI.html">BlankNodeOrIRI</a>: this interface represents the RDF Terms that may be used in the subject position of an RDF 1.1 <tt>Triple</tt>, including <tt>BlankNode</tt> and <tt>IRI</tt>.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Literal.html">Literal</a>: a RDF-1.1 literal, e.g. representing <tt>"Hello there"@en</tt>.</li> +</ul> +<p>The design of the <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">API</a> follows the terminology as defined by <a class="externalLink" href="http://www.w3.org/TR/rdf11-concepts/">RDF 1.1 Concepts and Abstract Syntax</a>, a W3C Recommendation published on 25 February 2014. The idea is that Commons RDF provide a common library for RDF 1.1 with multiple implementions for the Java Virtual Machine, allowing the portability across different Commons RDF implementations.</p> +<p>Commons RDF is designed for compatibility between different <a href="implementations.html">implementations</a>, e.g. by defining strong equality and hash code semantics (e.g. for <a href="apidocs/org/apache/commons/rdf/api/Triple.html#equals-java.lang.Object-">triple</a> and <a href="fapidocs/org/apache/commons/rdf/api/Literal.html#equals-java.lang.Object-">literals</a> ); this allows users of Commons RDF to “mix and match”, for instance querying a <tt>FooGraphImpl</tt> and directly adding its <tt>FooTripleImpl</tt>s to a <tt>BarGraphImpl</tt> without any explicit convertion.</p> +<p>To create such instances without hard-coding an implementation, one can use:</p> + +<ul> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/RDF.html">RDF</a>: interface for creating instances of the above types (e.g. <tt>LiteralImpl</tt> and <tt>GraphImpl</tt>) as well as converting from/to the underlying framework’s API.</li> +</ul> +<p>The API also includes a couple of “upper” interfaces which do not have the above equality semantics and bridge the graph/quad duality:</p> + +<ul> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/TripleLike.html">TripleLike</a>: common super-interface of <tt>Triple</tt> and <tt>Quad</tt> (also a generalised triple).</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/QuadLike.html">QuadLike</a>: a <tt>TripleLike</tt> that also has <tt>getGraphName()</tt> (a generalized quad)</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/GraphLike.html">GraphLike</a>: common super-interface of <tt>Graph</tt> and <tt>Dataset</tt>.</li> +</ul> +<p>See the the <a href="userguide.html">user guide</a> for examples of how to interact with these interfaces.</p></div> +<div class="section"> +<h2><a name="Modules"></a>Modules</h2> +<p>The project is composed by two modules:</p> + +<ul> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">API</a> defines a common library of RDF 1.1 concepts.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/simple/package-summary.html">Simple</a> provides a simple implementation, mainly for internal validation and very simple scenarios.</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/jena/package-summary.html">jena</a> provides an Apache Jena-backed implementation</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/rdf4j/package-summary.html">rdf4j</a> provides an Eclipse RDF4J-backed implementation</li> + +<li><a href="apidocs/index.html?org/apache/commons/rdf/jsonldjava/package-summary.html">jsonld-java</a> provides an JSONLD-Java-backed implementation</li> +</ul> +<p>These modules follow the <a class="externalLink" href="http://semver.org/">semantic versioning</a> principles, where version <tt>x.y.z</tt> of <tt>Simple</tt> implements version <tt>x.y</tt> of the <tt>API</tt>; i.e., the version <tt>z</tt> are backwards-compatible patches of the implementation.</p> +<p>For more details, read about the <a href="implementations.html">implementations of the Commons RDF API</a>.</p></div> +<div class="section"> +<h2><a name="Contributing"></a>Contributing</h2> +<p>Everybody is welcomed to <a href="mail-lists.html">join the project</a> and <a href="contributing.html">contribute</a>!</p></div> +<div class="section"> +<h2><a name="Disclaimer"></a>Disclaimer</h2> +<p>Apache Commons RDF is an effort undergoing incubation at <a class="externalLink" href="http://apache.org/">The Apache Software Foundation (ASF)</a> sponsored by the <a class="externalLink" href="http://incubator.apache.org/">Apache Incubator PMC</a>. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</p> +<p><a class="externalLink" href="http://incubator.apache.org/"><img src="images/apache-incubator-logo.png" alt="Apache Incubator" height="57" width="229" /></a></p></div> </td> </tr> </table>