You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by bu...@apache.org on 2016/09/09 12:45:45 UTC
svn commit: r997032 - in /websites/staging/jena/trunk/content: ./
documentation/io/index.html documentation/io/rdf-binary.html
documentation/io/rdf-output.html documentation/io/streaming-io.html
Author: buildbot
Date: Fri Sep 9 12:45:45 2016
New Revision: 997032
Log:
Staging update by buildbot for jena
Added:
websites/staging/jena/trunk/content/documentation/io/rdf-binary.html
Modified:
websites/staging/jena/trunk/content/ (props changed)
websites/staging/jena/trunk/content/documentation/io/index.html
websites/staging/jena/trunk/content/documentation/io/rdf-output.html
websites/staging/jena/trunk/content/documentation/io/streaming-io.html
Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Sep 9 12:45:45 2016
@@ -1 +1 @@
-1756913
+1760000
Modified: websites/staging/jena/trunk/content/documentation/io/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/index.html Fri Sep 9 12:45:45 2016
@@ -176,13 +176,12 @@ can be integrated into both the parser a
<li>TriG</li>
<li>N-Quads</li>
<li>TriX</li>
-<li>RDF Thrift</li>
+<li>RDF Binary</li>
</ul>
<p>RDF/JSON is different from JSON-LD - it is a direct encoding of RDF triples in JSON.
See the <a href="rdf-json.html">description of RDF/JSON</a>.</p>
-<p>RDF Thrift is a binary encoding of RDF (graphs and datasets) that can be useful
-for fast parsing. See the
-<a href="http://afs.github.io/rdf-thrift">description of RDF Thrift</a>.</p>
+<p>RDF Binary is a binary encoding of RDF (graphs and datasets) that can be useful
+for fast parsing. See <a href="rdf-binary.html">RDF Binary using Apache Thrift</a>.</p>
<h2 id="command-line-tools">Command line tools<a class="headerlink" href="#command-line-tools" title="Permanent link">¶</a></h2>
<p>There are scripts in Jena download to run these commands.</p>
<ul>
Added: websites/staging/jena/trunk/content/documentation/io/rdf-binary.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/rdf-binary.html (added)
+++ websites/staging/jena/trunk/content/documentation/io/rdf-binary.html Fri Sep 9 12:45:45 2016
@@ -0,0 +1,282 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ 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.
+-->
+
+ <title>Apache Jena - RDF Binary using Apache Thrift</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <link href="/css/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="/css/bootstrap-extension.css" rel="stylesheet" type="text/css">
+ <link href="/css/jena.css" rel="stylesheet" type="text/css">
+ <link rel="shortcut icon" href="/images/favicon.ico" />
+
+ <script src="https://code.jquery.com/jquery-2.0.3.min.js"></script>
+ <script src="/js/jena-navigation.js" type="text/javascript"></script>
+ <script src="/js/bootstrap.min.js" type="text/javascript"></script>
+ <script src="/js/breadcrumbs.js" type="text/javascript"></script>
+
+ <script src="/js/improve.js" type="text/javascript"></script>
+
+
+ <!-- Uncomment to enable code coloring <link href="/css/codehilite.css" rel="stylesheet" type="text/css"> -->
+
+</head>
+
+<body>
+
+
+
+<nav class="navbar navbar-default" role="navigation">
+<div class="container">
+ <div class="navbar-header">
+
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html">
+ <img class="logo-menu" src="/images/jena-logo/jena-logo-notext-small.png" alt="jena logo">Apache Jena</a>
+ </div>
+
+ <div class="collapse navbar-collapse navbar-ex1-collapse">
+ <ul class="nav navbar-nav">
+ <li id="homepage"><a href="/index.html"><span class="glyphicon glyphicon-home"></span> Home</a></li>
+ <li id="download"><a href="/download/index.cgi"><span class="glyphicon glyphicon-download-alt"></span> Download</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown"><span class="glyphicon glyphicon-book"></span> Learn <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li class="dropdown-header">Tutorials</li>
+ <li><a href="/tutorials/index.html">Overview</a></li>
+ <li><a href="/tutorials/rdf_api.html">RDF core API tutorial</a></li>
+ <li><a href="/tutorials/sparql.html">SPARQL tutorial</a></li>
+ <li><a href="/documentation/query/manipulating_sparql_using_arq.html">Manipulating SPARQL using ARQ</a></li>
+ <li><a href="/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+ <li><a href="/documentation/notes/index.html">How-To's</a></li>
+ <li class="divider"></li>
+ <li class="dropdown-header">References</li>
+ <li><a href="/documentation/index.html">Overview</a></li>
+ <li><a href="/documentation/javadoc/">Javadoc</a></li>
+ <li><a href="/documentation/rdf/index.html">RDF API</a></li>
+ <li><a href="/documentation/io/">RDF I/O</a></li>
+ <li><a href="/documentation/query/index.html">ARQ (SPARQL)</a></li>
+ <li><a href="/documentation/hadoop/index.html">Elephas - tools for RDF on Hadoop</a></li>
+ <li><a href="/documentation/query/text-query.html">Text Search</a></li>
+ <li><a href="/documentation/tdb/index.html">TDB</a></li>
+ <li><a href="/documentation/sdb/index.html">SDB</a></li>
+ <li><a href="/documentation/jdbc/index.html">SPARQL over JDBC</a></li>
+ <li><a href="/documentation/fuseki2/index.html">Fuseki</a></li>
+ <li><a href="/documentation/permissions/index.html">Permissions</a></li>
+ <li><a href="/documentation/assembler/index.html">Assembler</a></li>
+ <li><a href="/documentation/ontology/">Ontology API</a></li>
+ <li><a href="/documentation/inference/index.html">Inference API</a></li>
+ <li><a href="/documentation/tools/index.html">Command-line tools</a></li>
+ <li><a href="/documentation/extras/index.html">Extras</a></li>
+ </ul>
+ </li>
+
+ <li class="drop down">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown"><span class="glyphicon glyphicon-book"></span> Javadoc <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="/documentation/javadoc/jena/">Jena Core</a></li>
+ <li><a href="/documentation/javadoc/arq/">ARQ</a></li>
+ <li><a href="/documentation/javadoc/tdb/">TDB</a></li>
+ <li><a href="/documentation/javadoc/elephas/">Elephas</a></li>
+ <li><a href="/documentation/javadoc/text/">Text Search</a></li>
+ <li><a href="/documentation/javadoc/spatial/">Spatial Search</a></li>
+ <li><a href="/documentation/javadoc/permissions/">Permissions</a></li>
+ <li><a href="/documentation/javadoc/jdbc/">JDBC</a></li>
+ <li><a href="/documentation/javadoc/">All Javadoc</a></li>
+ </ul>
+ </li>
+
+ <li id="ask"><a href="/help_and_support/index.html"><span class="glyphicon glyphicon-question-sign"></span> Ask</a></li>
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown"><span class="glyphicon glyphicon-bullhorn"></span> Get involved <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="/getting_involved/index.html">Contribute</a></li>
+ <li><a href="/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+ <li class="divider"></li>
+ <li class="dropdown-header">Project</li>
+ <li><a href="/about_jena/about.html">About Jena</a></li>
+ <li><a href="/about_jena/roadmap.html">Roadmap</a></li>
+ <li><a href="/about_jena/architecture.html">Architecture</a></li>
+ <li><a href="/about_jena/team.html">Project team</a></li>
+ <li><a href="/about_jena/contributions.html">Related projects</a></li>
+ <li class="divider"></li>
+ <li class="dropdown-header">ASF</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </li>
+
+ <li id="edit"><a href="javascript:improveThisPage(location.href);" title="Improve this Page (Use username anonymous and empty password)"><span class="glyphicon glyphicon-pencil"></span> Improve this Page</a></li>
+ </ul>
+ </div>
+</div>
+</nav>
+
+
+<div class="container">
+ <div class="row">
+ <div class="col-md-12">
+ <div id="breadcrumbs"></div>
+ <h1 class="title">RDF Binary using Apache Thrift</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>"RDF Binary" is a efficient format for RDF and RDF-related data using
+<a href="https://thrift.apache.org/">Apache Thrift</a> as the binary encoding.</p>
+<p>The W3C standard RDF syntaxes are text or XML based. These incur costs in
+parsing; the most human-readable formats also incur high costs to write, and
+have limited scalability due to the need to analyse the data for pretty
+printing rather than simply stream to output.</p>
+<p>Binary formats are faster to process - they do not incur the parsing
+costs of text-base formats. "RDF Binary" defines basic encoding for RDF
+terms, then builds data formats for RDF graphs, RDF datasets, and for
+SPARQL result sets. This gives a basis for high-performance linked data
+systems.</p>
+<p><a href="https://thrift.apache.org/">Apache Thrift</a> provides an efficient,
+wide-used binary encoding layer with a large number of language bindings.</p>
+<p>For more details of <a href="http://afs.github.io/rdf-thrift">RDF Thrift</a>.</p>
+<p>This pages gives the details of RDF Binary encoding in <a href="http://thrift.apache.org/">Apache Thrift</a>.</p>
+<h2 id="encoding-terms">Thrift encoding of RDF Terms<a class="headerlink" href="#encoding-terms" title="Permanent link">¶</a></h2>
+<p>RDF Thrift uses the Thrift compact protocol.</p>
+<div class="codehilite"><pre><span class="n">struct</span> <span class="n">RDF_IRI</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">iri</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_BNode</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">label</span>
+<span class="p">}</span>
+
+# <span class="n">Literals</span><span class="p">,</span> <span class="n">in</span> <span class="n">full</span> <span class="n">form</span><span class="p">.</span>
+<span class="n">struct</span> <span class="n">RDF_Literal</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">lex</span>
+2<span class="p">:</span> <span class="n">optional</span> <span class="n">string</span> <span class="n">datatype</span>
+3<span class="p">:</span> <span class="n">optional</span> <span class="n">string</span> <span class="n">langtag</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_Decimal</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">i64</span> <span class="n">value</span> <span class="p">;</span>
+2<span class="p">:</span> <span class="n">required</span> <span class="n">i32</span> <span class="n">scale</span> <span class="p">;</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_VAR</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">name</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_ANY</span> <span class="p">{</span> <span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_UNDEF</span> <span class="p">{</span> <span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_REPEAT</span> <span class="p">{</span> <span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_PrefixDecl</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">prefix</span> <span class="p">;</span>
+2<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">uri</span> <span class="p">;</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_PrefixName</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">prefix</span> <span class="p">;</span>
+2<span class="p">:</span> <span class="n">required</span> <span class="n">string</span> <span class="n">localName</span> <span class="p">;</span>
+<span class="p">}</span>
+
+<span class="n">union</span> <span class="n">RDF_Term</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">RDF_IRI</span> <span class="n">iri</span>
+2<span class="p">:</span> <span class="n">RDF_BNode</span> <span class="n">bnode</span>
+3<span class="p">:</span> <span class="n">RDF_Literal</span> <span class="n">literal</span>
+4<span class="p">:</span> <span class="n">RDF_PrefixName</span> <span class="n">prefixName</span>
+5<span class="p">:</span> <span class="n">RDF_VAR</span> <span class="n">variable</span>
+6<span class="p">:</span> <span class="n">RDF_ANY</span> <span class="n">any</span>
+7<span class="p">:</span> <span class="n">RDF_UNDEF</span> <span class="n">undefined</span>
+8<span class="p">:</span> <span class="n">RDF_REPEAT</span> <span class="n">repeat</span>
+# <span class="n">Value</span> <span class="n">forms</span> <span class="n">of</span> <span class="n">literals</span><span class="p">.</span>
+10<span class="p">:</span> <span class="n">i64</span> <span class="n">valInteger</span>
+11<span class="p">:</span> <span class="n">double</span> <span class="n">valDouble</span>
+12<span class="p">:</span> <span class="n">RDF_Decimal</span> <span class="n">valDecimal</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<h2 id="encoding-graphs-datasets">Thrift encoding of Graphs and Datasets<a class="headerlink" href="#encoding-graphs-datasets" title="Permanent link">¶</a></h2>
+<div class="codehilite"><pre><span class="n">struct</span> <span class="n">RDF_Triple</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">S</span>
+2<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">P</span>
+3<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">O</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_Quad</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">S</span>
+2<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">P</span>
+3<span class="p">:</span> <span class="n">required</span> <span class="n">RDF_Term</span> <span class="n">O</span>
+4<span class="p">:</span> <span class="n">optional</span> <span class="n">RDF_Term</span> <span class="n">G</span>
+<span class="p">}</span>
+
+<span class="n">union</span> <span class="n">RDF_StreamRow</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">RDF_PrefixDecl</span> <span class="n">prefixDecl</span>
+2<span class="p">:</span> <span class="n">RDF_Triple</span> <span class="n">triple</span>
+3<span class="p">:</span> <span class="n">RDF_Quad</span> <span class="n">quad</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<h2 id="encoding-result-sets">Thrift encoding of SPARQL Result Sets<a class="headerlink" href="#encoding-result-sets" title="Permanent link">¶</a></h2>
+<div class="codehilite"><pre><span class="n">struct</span> <span class="n">RDF_VarTuple</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">list</span><span class="o">&</span><span class="n">lt</span><span class="p">;</span><span class="n">RDF_VAR</span><span class="o">&</span><span class="n">gt</span><span class="p">;</span> <span class="n">vars</span>
+<span class="p">}</span>
+
+<span class="n">struct</span> <span class="n">RDF_DataTuple</span> <span class="p">{</span>
+1<span class="p">:</span> <span class="n">list</span><span class="o">&</span><span class="n">lt</span><span class="p">;</span><span class="n">RDF_Term</span><span class="o">&</span><span class="n">gt</span><span class="p">;</span> <span class="n">row</span>
+<span class="p">}</span>
+</pre></div>
+ </div>
+</div>
+
+</div><!--/.container -->
+
+ <footer class="footer">
+ <div class="container">
+ <p>Copyright © 2011–2016 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ </p>
+ <p>
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </footer>
+
+
+</body>
+</html>
Modified: websites/staging/jena/trunk/content/documentation/io/rdf-output.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/rdf-output.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/rdf-output.html Fri Sep 9 12:45:45 2016
@@ -168,7 +168,7 @@ introduced in Jena 2.10.1.</p>
<li><a href="#streamed-block-formats">Streamed Block Formats</a></li>
<li><a href="#line-printed-formats">Line printed formats</a></li>
<li><a href="#n-triples-and-n-quads">N-Triples and N-Quads</a></li>
-<li><a href="#rdf-thrift">RDF Thrift</a></li>
+<li><a href="#rdf-thrift">RDF Binary</a></li>
<li><a href="#rdfxml">RDF/XML</a></li>
<li><a href="#examples">Examples</a></li>
<li><a href="#notes">Notes</a></li>
@@ -207,7 +207,7 @@ are available as part of the standard se
<li>TriG</li>
<li>NQuads</li>
<li>TriX</li>
-<li>RDF Thrift</li>
+<li>RDF Binary</li>
</ul>
<p>In addition, there are variants of Trutle, TriG for pretty printing,
streamed output and flat output. RDF/XML has variants for pretty printing
@@ -554,9 +554,10 @@ in ASCII (using <code>\u</code> escape s
</tr>
</tbody>
</table>
-<h3 id="rdf-thrift">RDF Thrift<a class="headerlink" href="#rdf-thrift" title="Permanent link">¶</a></h3>
-<p>The <a href="http://afs.github.io/rdf-thrift">RDF Thrift</a> format is a binary encoding of RDF Graphs
-and RDF Datasets, as well as SPARQL Result Sets, that can provide efficient parsing
+<h3 id="rdf-binary">RDF Binary<a class="headerlink" href="#rdf-binary" title="Permanent link">¶</a></h3>
+<p><a href="rdf-binary.html">This is a binary encoding</a> using
+<a href="https://thrift.apache.org/">Apache Thrift</a> for RDF Graphs
+and RDF Datasets, as well as SPARQL Result Sets, and it provides faster parsing
compared to the text-based standardised syntax such as N-triples, Turtle or RDF/XML.</p>
<table class="table">
<thead>
@@ -576,7 +577,7 @@ compared to the text-based standardised
<p><code>RDFTHRIFT_VALUES</code> is a variant where numeric values are written as values,
not as lexcial format and datatype. See the
<a href="http://afs.github.io/rdf-thrift">description of RDF Thrift</a>
-for details.</p>
+for dsicussion.</p>
<h3 id="rdfxml">RDF/XML<a class="headerlink" href="#rdfxml" title="Permanent link">¶</a></h3>
<p>RIOT supports output in RDF/XML. RIOT RDFFormats defaults to pretty printed RDF/XML,
while the jena writer writer name defaults to a streaming plain output.</p>
Modified: websites/staging/jena/trunk/content/documentation/io/streaming-io.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/streaming-io.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/streaming-io.html Fri Sep 9 12:45:45 2016
@@ -159,7 +159,7 @@ h2:hover > .headerlink, h3:hover > .head
fashion. Streaming can be used for manipulating RDF at scale. Jena
provides high performance readers and writers for all standard RDF formats,
and it can be extended with custom formats.</p>
-<p>The <a href="http://afs.github.io/rdf-thrift">RDF Thrift</a> provides the highest
+<p>The <a href="rdf-binary.html">RDF Binary using Apache Thrift</a> provides the highest
input parsing performance. N-Triples/N-Quads provide the highest
input parsing performance using W3C Standards.</p>
<p>Files ending in <code>.gz</code> are assumed to be gzip-compressed. Input and output