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 2011/11/01 01:40:13 UTC
svn commit: r797817 [2/3] -
/websites/staging/jena/trunk/content/jena/documentation/tdb/
Added: websites/staging/jena/trunk/content/jena/documentation/tdb/dynamic_datasets.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/dynamic_datasets.html (added)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/dynamic_datasets.html Tue Nov 1 00:40:11 2011
@@ -0,0 +1,214 @@
+<!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.
+-->
+
+ <link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
+ <title>Apache Jena - TDB Dynamic Datasets</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
+ <script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
+</head>
+
+<body>
+ <div id="header">
+ <div id="logoblock">
+ <img alt="Apache Jena" src="/jena/images/jena-logo/jena-logo-small.png"/>
+ </div>
+
+ <div id="titleblock">
+ <h1 class="title">Apache Jena</h1>
+ <div id="topmenu" class="tabbar round-10">
+ <ul>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/index.html" id="home_menu">Home</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/help_and_support/index.html">Support</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/getting_started/index.html">Getting started</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/tutorials/index.html">Tutorials</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/documentation/index.html">Documentation</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="navigation" class="clear">
+ <h1 id="quick_links">Quick links</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/download/index.html">Downloads</a></li>
+<li><a href="/jena/help_and_support/index.html">Help and support</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/getting_involved/index.html">Getting involved</a></li>
+<li><a href="/jena/documentation/">Documentation</a></li>
+</ul>
+<h1 id="about_jena">About Jena</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/about_jena/about.html">About Jena</a></li>
+<li><a href="/jena/about_jena/architecture.html">Architecture</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/about_jena/team.html">Project team</a></li>
+</ul>
+<h1 id="download">Download</h1>
+<ul>
+<li><a href="/jena/download/index.html">Downloading Jena</a></li>
+<li><a href="/jena/download/maven.html">Using Maven</a></li>
+<li><a href="/jena/download/osgi.html">Using OSGi</a></li>
+</ul>
+<h1 id="help_and_support">Help and support</h1>
+<ul>
+<li><a href="/jena/help_and_support/index.html">Getting help</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Bugs and suggestions</a></li>
+</ul>
+<h1 id="getting_started">Getting Started</h1>
+<ul>
+<li><a href="/jena/getting_started/index.html">A first Jena project</a></li>
+<li><a href="/jena/getting_started/rdf_api.html">RDF API overview</a></li>
+<li><a href="/jena/getting_started/sparql.html">Querying RDF with SPARQL</a></li>
+<li><a href="/jena/getting_started/fuseki.html">Serving RDF over HTTP</a></li>
+<li><a href="/jena/getting_started/tell_me_how.html">Tell me how to ...</a></li>
+</ul>
+<h1 id="tutorials">Tutorials</h1>
+<ul>
+<li><a href="/jena/tutorials/index.html">RDF tutorial</a></li>
+<li><a href="/jena/tutorials/sparql.html">SPARQL queries</a></li>
+<li><a href="/jena/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/jena/documentation/index.html">Overview</a></li>
+<li><a href="/jena/documentation/javadoc">Javadoc</a></li>
+<li><a href="/jena/documentation/rdf/index.html">RDF</a></li>
+<li><a href="/jena/documentation/query/index.html">SPARQL (ARQ)</a></li>
+<li><a href="/jena/documentation/tdb/index.html">TDB</a></li>
+<li><a href="/jena/documentation/sdb/index.html">SDB</a><ul>
+<li><a href="/jena/documentation/sdb/installation.html">Installation</a></li>
+<li><a href="/jena/documentation/sdb/quickstart.html">Quick start</a></li>
+<li><a href="/jena/documentation/sdb/commands.html">Cmd line</a></li>
+<li><a href="/jena/documentation/sdb/javaapi.html">Java API</a></li>
+<li><a href="/jena/documentation/sdb/configuration.html">Config</a></li>
+<li><a href="/jena/documentation/sdb/databases_supported.html">Databases</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/larq/index.html">LARQ</a></li>
+<li><a href="/jena/documentation/serving_data/index.html">Serving Data</a></li>
+<li><a href="/jena/documentation/ontology/index.html">Ontology</a></li>
+<li><a href="/jena/documentation/inference/index.html">Inference</a></li>
+<li><a href="/jena/documentation/assembler/index.html">Assembler</a><ul>
+<li><a href="/jena/documentation/assembler/assembler-howto.html">Assembler how-to</a></li>
+<li><a href="/jena/documentation/assembler/inside-assemblers.html">Inside assemblers</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/io/index.html">I/O</a><ul>
+<li><a href="/jena/documentation/io/iohowto.html">I/O how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/notes/index.html">Notes</a><ul>
+<li><a href="/jena/documentation/notes/concurrency-howto.html">Concurrency how-to</a></li>
+<li><a href="/jena/documentation/notes/event-handler-howto.html">Event handler how-to</a></li>
+<li><a href="/jena/documentation/notes/file-manager.html">File manager how-to</a></li>
+<li><a href="/jena/documentation/notes/model-factory.html">Model factory how-to</a></li>
+<li><a href="/jena/documentation/notes/rdf-frames.html">RDF frames</a></li>
+<li><a href="/jena/documentation/notes/reification.html">Reification how-to</a></li>
+<li><a href="/jena/documentation/notes/typed-literals.html">Typed literals how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/tools/index.html">Tools</a><ul>
+<li><a href="/jena/documentation/tools/schemagen.html">schemagen</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="getting_involved">Getting Involved</h1>
+<ul>
+<li><a href="/jena/getting_involved/index.html">Contributing to Jena</a></li>
+</ul>
+<h1 id="asf_links">ASF links</h1>
+<ul>
+<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>
+ </div>
+
+ <div id="content">
+ <h1 class="title">TDB Dynamic Datasets</h1>
+ <p><em>TDB version 0.8.5 and later</em></p>
+<p>This feature allows a query to be made on a subset of all the named
+graphs in the TDB storage datasets. The SPARQL <code>GRAPH</code> pattern
+allows access to either a specific named graph or to all the named
+graph in a dataset. This feature means that only specified named
+graphs are visible to the query.</p>
+<p>SPARQL has the concept of a
+<a href="http://www.w3.org/TR/rdf-sparql-query/#specifyingDataset">dataset description</a>.
+In a query string, the clauses for FROM and FROM NAMED specify the
+dataset. The FROM clauses define the graphs that are merged to form
+the default graph, and the FROM NAMED clauses identify the graphs
+to be included as named graphs.</p>
+<p>Normally, ARQ interprets these as coming from the web, that is the
+graphs are read using HTTP GET. TDB modifies this behaviour; instead
+of the universe of graphs being the web, the universe of graph is
+the TDB data store. FROM and FROM NAMED describe a dataset with
+graphs drawn only from the TDB data store.</p>
+<ul>
+<li>Just using one or more FROM clauses, with no FROM NAMED in a
+ query, leaves the named graphs as all the named graphs in the data
+ store.</li>
+<li>Just using one or more FROM NAMED, with no FROM in a query,
+ causes an empty default graph to be used.</li>
+<li>If the symbol
+ <a href="configuration.html"><code>TDB.symUnionDefaultGraph</code></a>
+ is also set, then the default graph is set union of all the named
+ graphs (FROM NAMED) and the graphs already used for the default
+ graph via FROM</li>
+<li><code>urn:x-arq:UnionGraph</code> and <code>urn:x-arq:DefaultGraph</code> explicitly name
+ the union of named graphs (FROM NAMED) and the described default
+ graph (union of FROM) directly.</li>
+</ul>
+<p>Example</p>
+<div class="codehilite"><pre><span class="c1">#Follow a foaf:knows path across both Alice and Bobs FOAF data</span>
+<span class="c1">#where the data is in the datastore as named graphs.</span>
+
+<span class="n">BASE</span> <span class="sr"><http://example></span>
+<span class="n">SELECT</span><span class="err">Â </span><span class="p">?</span><span class="n">zName</span>
+<span class="n">FROM</span> <span class="sr"><alice-foaf></span>
+<span class="n">FROM</span> <span class="sr"><bob-foaf></span>
+<span class="p">{</span>
+ <span class="sr"><http://example/Alice#me></span> <span class="n">foaf:knows</span><span class="err">Â </span><span class="p">?</span><span class="n">y</span> <span class="o">.</span>
+ <span class="err">Â </span><span class="p">?</span><span class="n">y</span> <span class="n">foaf:knows</span><span class="err">Â </span><span class="p">?</span><span class="n">z</span> <span class="o">.</span>
+ <span class="err">Â </span><span class="p">?</span><span class="n">z</span> <span class="n">foaf:name</span><span class="err">Â </span><span class="p">?</span><span class="n">zName</span> <span class="o">.</span>
+<span class="p">}</span>
+</pre></div>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Modified: websites/staging/jena/trunk/content/jena/documentation/tdb/index.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/index.html (original)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/index.html Tue Nov 1 00:40:11 2011
@@ -20,7 +20,7 @@
-->
<link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
- <title>Apache Jena - TDB - high performance persistent RDF store</title>
+ <title>Apache Jena - TDB</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
<script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
@@ -149,10 +149,45 @@
</div>
<div id="content">
- <h1 class="title">TDB - high performance persistent RDF store</h1>
- <p>Documentation is in the process of being ported from the previous
-OpenJena site. In the meantime, please refer to the
-<a href="http://www.openjena.org/TDB">TDB documentation on <code>openjena.org</code></a></p>
+ <h1 class="title">TDB</h1>
+ <p>TDB is a component of
+<a href="http://incubator.apache.org/jena">Jena</a> for RDF storage
+and query, as well as the full range of Jena APIs.
+TDB can be used as a high performance, non-transactional, RDF store
+on a single machine. This documentation describes the latest version, unless
+otherwise noted.</p>
+<p>A TDB store can be accessed and managed with the provided command
+line scripts and via the Jena API.</p>
+<p>See also <a href="../fuseki">Fuseki</a> for a SPARQL server that
+uses TDB for persistent storage and provides the SPARQL protocols
+for query, update and REST update over HTTP.</p>
+<h2 id="contents">Contents</h2>
+<ul>
+<li><a href="#documentation">Documentation</a></li>
+<li><a href="#downloads">Downloads</a></li>
+<li><a href="#subversion">Subversion</a></li>
+</ul>
+<h2 id="documentation">Documentation</h2>
+<ul>
+<li><a href="installation.html">TDB Installation</a></li>
+<li><a href="requirements.html">TDB Requirements</a></li>
+<li><a href="commands.html">Command line utilities</a></li>
+<li><a href="java_api.html">Using TDB from Java through the API</a></li>
+<li><a href="jvm_64_32.html">Use on 64 bit or 32 bit Java systems</a></li>
+<li><a href="datasets.html">Datasets and Named Graphs</a></li>
+<li><a href="assembler.html">Assemblers for Graphs and Datasets</a></li>
+<li><a href="dynamic_datasets.html">Dynamic Datasets</a>: Query a subset of the named graphs</li>
+<li><a href="quadfilter.html">Quad filtering</a>: Hide information in the dataset</li>
+<li><a href="value_canonicalization.html">Value Canonicalization</a></li>
+<li><a href="architecture.html">TDB Design</a></li>
+<li><a href="optimizer.html">The TDB Optimizer</a></li>
+<li><a href="configuration.html">TDB Configuration</a></li>
+<li><a href="joseki_integration.html">Joseki Integration</a></li>
+</ul>
+<h2 id="downloads">Downloads</h2>
+<p>TODO download locations</p>
+<h2 id="subversion">Subversion</h2>
+<p><a href="https://svn.apache.org/repos/asf/incubator/jena/Jena2/TDB/">TDB Subversion repository</a></p>
</div>
<div id="footer">
Added: websites/staging/jena/trunk/content/jena/documentation/tdb/installation.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/installation.html (added)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/installation.html Tue Nov 1 00:40:11 2011
@@ -0,0 +1,187 @@
+<!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.
+-->
+
+ <link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
+ <title>Apache Jena - TDB Installation</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
+ <script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
+</head>
+
+<body>
+ <div id="header">
+ <div id="logoblock">
+ <img alt="Apache Jena" src="/jena/images/jena-logo/jena-logo-small.png"/>
+ </div>
+
+ <div id="titleblock">
+ <h1 class="title">Apache Jena</h1>
+ <div id="topmenu" class="tabbar round-10">
+ <ul>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/index.html" id="home_menu">Home</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/help_and_support/index.html">Support</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/getting_started/index.html">Getting started</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/tutorials/index.html">Tutorials</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/documentation/index.html">Documentation</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="navigation" class="clear">
+ <h1 id="quick_links">Quick links</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/download/index.html">Downloads</a></li>
+<li><a href="/jena/help_and_support/index.html">Help and support</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/getting_involved/index.html">Getting involved</a></li>
+<li><a href="/jena/documentation/">Documentation</a></li>
+</ul>
+<h1 id="about_jena">About Jena</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/about_jena/about.html">About Jena</a></li>
+<li><a href="/jena/about_jena/architecture.html">Architecture</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/about_jena/team.html">Project team</a></li>
+</ul>
+<h1 id="download">Download</h1>
+<ul>
+<li><a href="/jena/download/index.html">Downloading Jena</a></li>
+<li><a href="/jena/download/maven.html">Using Maven</a></li>
+<li><a href="/jena/download/osgi.html">Using OSGi</a></li>
+</ul>
+<h1 id="help_and_support">Help and support</h1>
+<ul>
+<li><a href="/jena/help_and_support/index.html">Getting help</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Bugs and suggestions</a></li>
+</ul>
+<h1 id="getting_started">Getting Started</h1>
+<ul>
+<li><a href="/jena/getting_started/index.html">A first Jena project</a></li>
+<li><a href="/jena/getting_started/rdf_api.html">RDF API overview</a></li>
+<li><a href="/jena/getting_started/sparql.html">Querying RDF with SPARQL</a></li>
+<li><a href="/jena/getting_started/fuseki.html">Serving RDF over HTTP</a></li>
+<li><a href="/jena/getting_started/tell_me_how.html">Tell me how to ...</a></li>
+</ul>
+<h1 id="tutorials">Tutorials</h1>
+<ul>
+<li><a href="/jena/tutorials/index.html">RDF tutorial</a></li>
+<li><a href="/jena/tutorials/sparql.html">SPARQL queries</a></li>
+<li><a href="/jena/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/jena/documentation/index.html">Overview</a></li>
+<li><a href="/jena/documentation/javadoc">Javadoc</a></li>
+<li><a href="/jena/documentation/rdf/index.html">RDF</a></li>
+<li><a href="/jena/documentation/query/index.html">SPARQL (ARQ)</a></li>
+<li><a href="/jena/documentation/tdb/index.html">TDB</a></li>
+<li><a href="/jena/documentation/sdb/index.html">SDB</a><ul>
+<li><a href="/jena/documentation/sdb/installation.html">Installation</a></li>
+<li><a href="/jena/documentation/sdb/quickstart.html">Quick start</a></li>
+<li><a href="/jena/documentation/sdb/commands.html">Cmd line</a></li>
+<li><a href="/jena/documentation/sdb/javaapi.html">Java API</a></li>
+<li><a href="/jena/documentation/sdb/configuration.html">Config</a></li>
+<li><a href="/jena/documentation/sdb/databases_supported.html">Databases</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/larq/index.html">LARQ</a></li>
+<li><a href="/jena/documentation/serving_data/index.html">Serving Data</a></li>
+<li><a href="/jena/documentation/ontology/index.html">Ontology</a></li>
+<li><a href="/jena/documentation/inference/index.html">Inference</a></li>
+<li><a href="/jena/documentation/assembler/index.html">Assembler</a><ul>
+<li><a href="/jena/documentation/assembler/assembler-howto.html">Assembler how-to</a></li>
+<li><a href="/jena/documentation/assembler/inside-assemblers.html">Inside assemblers</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/io/index.html">I/O</a><ul>
+<li><a href="/jena/documentation/io/iohowto.html">I/O how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/notes/index.html">Notes</a><ul>
+<li><a href="/jena/documentation/notes/concurrency-howto.html">Concurrency how-to</a></li>
+<li><a href="/jena/documentation/notes/event-handler-howto.html">Event handler how-to</a></li>
+<li><a href="/jena/documentation/notes/file-manager.html">File manager how-to</a></li>
+<li><a href="/jena/documentation/notes/model-factory.html">Model factory how-to</a></li>
+<li><a href="/jena/documentation/notes/rdf-frames.html">RDF frames</a></li>
+<li><a href="/jena/documentation/notes/reification.html">Reification how-to</a></li>
+<li><a href="/jena/documentation/notes/typed-literals.html">Typed literals how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/tools/index.html">Tools</a><ul>
+<li><a href="/jena/documentation/tools/schemagen.html">schemagen</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="getting_involved">Getting Involved</h1>
+<ul>
+<li><a href="/jena/getting_involved/index.html">Contributing to Jena</a></li>
+</ul>
+<h1 id="asf_links">ASF links</h1>
+<ul>
+<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>
+ </div>
+
+ <div id="content">
+ <h1 class="title">TDB Installation</h1>
+ <p>TDB requires Java 6 (versions to 0.8.1) and Java 5 for version
+afterwards.</p>
+<p>TDB is distributed as a complete download and also via Apache Maven
+(groupId <code>com.hp.hpl.jena</code>, artifact <code>tdb</code>).</p>
+<p>The Jena repositories are:</p>
+<ul>
+<li><a href="repo.html" title="http://openjena.org/repo">http://openjena.org/repo</a>
+ (this is mirrored to the central maven repository).</li>
+<li><a href="repo_dev.html" title="http://openjena.org/repo-dev">http://openjena.org/repo-dev</a>
+ for development builds.</li>
+</ul>
+<p>After downloading a TDB distribution, place <em>all</em> the jars in the
+<code>lib/</code> directory on the classpath. TDB itself is a single jar, the
+other jars in <code>lib/</code> are a consistent snapshot at the time of
+release.</p>
+<p>The TDB build system uses maven but there is also an ant build as
+well using "ant jar".</p>
+<p>See also the page on
+<a href="joseki_integration.html">Joseki integration</a>.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/jena/trunk/content/jena/documentation/tdb/java_api.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/java_api.html (added)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/java_api.html Tue Nov 1 00:40:11 2011
@@ -0,0 +1,284 @@
+<!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.
+-->
+
+ <link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
+ <title>Apache Jena - TDB Java API</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
+ <script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
+</head>
+
+<body>
+ <div id="header">
+ <div id="logoblock">
+ <img alt="Apache Jena" src="/jena/images/jena-logo/jena-logo-small.png"/>
+ </div>
+
+ <div id="titleblock">
+ <h1 class="title">Apache Jena</h1>
+ <div id="topmenu" class="tabbar round-10">
+ <ul>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/index.html" id="home_menu">Home</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/help_and_support/index.html">Support</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/getting_started/index.html">Getting started</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/tutorials/index.html">Tutorials</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/documentation/index.html">Documentation</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="navigation" class="clear">
+ <h1 id="quick_links">Quick links</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/download/index.html">Downloads</a></li>
+<li><a href="/jena/help_and_support/index.html">Help and support</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/getting_involved/index.html">Getting involved</a></li>
+<li><a href="/jena/documentation/">Documentation</a></li>
+</ul>
+<h1 id="about_jena">About Jena</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/about_jena/about.html">About Jena</a></li>
+<li><a href="/jena/about_jena/architecture.html">Architecture</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/about_jena/team.html">Project team</a></li>
+</ul>
+<h1 id="download">Download</h1>
+<ul>
+<li><a href="/jena/download/index.html">Downloading Jena</a></li>
+<li><a href="/jena/download/maven.html">Using Maven</a></li>
+<li><a href="/jena/download/osgi.html">Using OSGi</a></li>
+</ul>
+<h1 id="help_and_support">Help and support</h1>
+<ul>
+<li><a href="/jena/help_and_support/index.html">Getting help</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Bugs and suggestions</a></li>
+</ul>
+<h1 id="getting_started">Getting Started</h1>
+<ul>
+<li><a href="/jena/getting_started/index.html">A first Jena project</a></li>
+<li><a href="/jena/getting_started/rdf_api.html">RDF API overview</a></li>
+<li><a href="/jena/getting_started/sparql.html">Querying RDF with SPARQL</a></li>
+<li><a href="/jena/getting_started/fuseki.html">Serving RDF over HTTP</a></li>
+<li><a href="/jena/getting_started/tell_me_how.html">Tell me how to ...</a></li>
+</ul>
+<h1 id="tutorials">Tutorials</h1>
+<ul>
+<li><a href="/jena/tutorials/index.html">RDF tutorial</a></li>
+<li><a href="/jena/tutorials/sparql.html">SPARQL queries</a></li>
+<li><a href="/jena/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/jena/documentation/index.html">Overview</a></li>
+<li><a href="/jena/documentation/javadoc">Javadoc</a></li>
+<li><a href="/jena/documentation/rdf/index.html">RDF</a></li>
+<li><a href="/jena/documentation/query/index.html">SPARQL (ARQ)</a></li>
+<li><a href="/jena/documentation/tdb/index.html">TDB</a></li>
+<li><a href="/jena/documentation/sdb/index.html">SDB</a><ul>
+<li><a href="/jena/documentation/sdb/installation.html">Installation</a></li>
+<li><a href="/jena/documentation/sdb/quickstart.html">Quick start</a></li>
+<li><a href="/jena/documentation/sdb/commands.html">Cmd line</a></li>
+<li><a href="/jena/documentation/sdb/javaapi.html">Java API</a></li>
+<li><a href="/jena/documentation/sdb/configuration.html">Config</a></li>
+<li><a href="/jena/documentation/sdb/databases_supported.html">Databases</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/larq/index.html">LARQ</a></li>
+<li><a href="/jena/documentation/serving_data/index.html">Serving Data</a></li>
+<li><a href="/jena/documentation/ontology/index.html">Ontology</a></li>
+<li><a href="/jena/documentation/inference/index.html">Inference</a></li>
+<li><a href="/jena/documentation/assembler/index.html">Assembler</a><ul>
+<li><a href="/jena/documentation/assembler/assembler-howto.html">Assembler how-to</a></li>
+<li><a href="/jena/documentation/assembler/inside-assemblers.html">Inside assemblers</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/io/index.html">I/O</a><ul>
+<li><a href="/jena/documentation/io/iohowto.html">I/O how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/notes/index.html">Notes</a><ul>
+<li><a href="/jena/documentation/notes/concurrency-howto.html">Concurrency how-to</a></li>
+<li><a href="/jena/documentation/notes/event-handler-howto.html">Event handler how-to</a></li>
+<li><a href="/jena/documentation/notes/file-manager.html">File manager how-to</a></li>
+<li><a href="/jena/documentation/notes/model-factory.html">Model factory how-to</a></li>
+<li><a href="/jena/documentation/notes/rdf-frames.html">RDF frames</a></li>
+<li><a href="/jena/documentation/notes/reification.html">Reification how-to</a></li>
+<li><a href="/jena/documentation/notes/typed-literals.html">Typed literals how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/tools/index.html">Tools</a><ul>
+<li><a href="/jena/documentation/tools/schemagen.html">schemagen</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="getting_involved">Getting Involved</h1>
+<ul>
+<li><a href="/jena/getting_involved/index.html">Contributing to Jena</a></li>
+</ul>
+<h1 id="asf_links">ASF links</h1>
+<ul>
+<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>
+ </div>
+
+ <div id="content">
+ <h1 class="title">TDB Java API</h1>
+ <p>All the operations of the
+Jena API
+including the
+<a href="../query/">SPARQL query support</a>.
+The application obtains a model or RDF datasets from TDB then uses
+it as for any other model or dataset.</p>
+<p>See also
+<a href="concurrency.html">Concurrency and Locking</a>.</p>
+<h2 id="contents">Contents</h2>
+<ul>
+<li><a href="#Constructing_a_model_or_dataset">Constructing a model or dataset</a><ul>
+<li><a href="#Using_a_directory_name">Using a directory name</a></li>
+<li><a href="#Using_an_assembler_file">Using an assembler file</a></li>
+</ul>
+</li>
+<li><a href="#Bulkloader">Bulkloader</a></li>
+<li><a href="#Caching_and_synchronization">Caching and synchronization</a></li>
+<li><a href="#Concurrency">Concurrency</a></li>
+</ul>
+<h2 id="constructing_a_model_or_dataset">Constructing a model or dataset</h2>
+<p>The class <code>TDBFactory</code> contains the static factory methods for
+creating and connecting to a TDB-backed graph or an RDF dataset.
+Models and datasets should be closed after use.</p>
+<p>See also the examples in <code>src-examples</code>.</p>
+<p>An application can specify the model or dataset by:</p>
+<ol>
+<li>Giving a directory name</li>
+<li>Giving an assembler file</li>
+</ol>
+<p>If a directory is empty, the TDB files for indexes and node table
+are created. If the directory contains files from a previous
+application run, TDB connects to the data already there.</p>
+<p>Closing the model or dataset is important. Any updates made are
+forced to disk if they have not been written already.</p>
+<h3 id="using_a_directory_name">Using a directory name</h3>
+<div class="codehilite"><pre> <span class="sr">//</span> <span class="n">Direct</span> <span class="n">way:</span> <span class="n">Make</span> <span class="n">a</span> <span class="n">TDB</span><span class="o">-</span><span class="n">backed</span> <span class="n">Jena</span> <span class="n">model</span> <span class="n">in</span> <span class="n">the</span> <span class="n">named</span> <span class="n">directory</span><span class="o">.</span>
+ <span class="n">String</span> <span class="n">directory</span> <span class="o">=</span> <span class="s">"MyDatabases/DB1"</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">createModel</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">model</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+
+ <span class="sr">//</span> <span class="n">Direct</span> <span class="n">way:</span> <span class="n">Make</span> <span class="n">a</span> <span class="n">TDB</span><span class="o">-</span><span class="n">backed</span> <span class="n">dataset</span>
+ <span class="n">String</span> <span class="n">directory</span> <span class="o">=</span> <span class="s">"MyDatabases/Dataset1"</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">createDataset</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">dataset</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+</pre></div>
+
+
+<h3 id="using_an_assembler_file">Using an assembler file</h3>
+<div class="codehilite"><pre> <span class="sr">//</span> <span class="n">Assembler</span> <span class="n">way:</span> <span class="n">Make</span> <span class="n">a</span> <span class="n">TDB</span><span class="o">-</span><span class="n">back</span> <span class="n">Jena</span> <span class="n">model</span> <span class="n">in</span> <span class="n">the</span> <span class="n">named</span> <span class="n">directory</span><span class="o">.</span>
+ <span class="sr">//</span> <span class="n">This</span> <span class="n">way</span><span class="p">,</span> <span class="n">you</span> <span class="n">can</span> <span class="n">change</span> <span class="n">the</span> <span class="n">model</span> <span class="n">being</span> <span class="n">used</span> <span class="n">without</span> <span class="n">changing</span> <span class="n">the</span> <span class="n">code</span><span class="o">.</span>
+ <span class="sr">//</span> <span class="n">The</span> <span class="n">assembler</span> <span class="n">file</span> <span class="n">is</span> <span class="n">a</span> <span class="n">configuration</span> <span class="n">file</span><span class="o">.</span>
+ <span class="sr">//</span> <span class="n">The</span> <span class="n">same</span> <span class="n">assembler</span> <span class="n">description</span> <span class="n">will</span> <span class="n">work</span> <span class="n">in</span> <span class="n">Joseki</span><span class="o">.</span>
+ <span class="n">String</span> <span class="n">assemblerFile</span> <span class="o">=</span> <span class="s">"Store/tdb-assembler.ttl"</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">assembleModel</span><span class="p">(</span><span class="n">assemblerFile</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">model</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+
+ <span class="n">String</span> <span class="n">assemblerFile</span> <span class="o">=</span> <span class="s">"Store/tdb-assembler.ttl"</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">assembleDataset</span><span class="p">(</span><span class="n">assemblerFile</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">dataset</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+</pre></div>
+
+
+<p>See
+<a href="assembler.html">the TDB assembler documentation</a>
+for details.</p>
+<h2 id="bulkloader">Bulkloader</h2>
+<p>The bulkloader is a faster way to load data into an empty graph
+than just using the Jena update operations.</p>
+<p>It is accessed through the command line utility <code>tdbloader</code>.</p>
+<h2 id="caching_and_synchronization">Caching and synchronization</h2>
+<p>TDB employs caching at various levels, from RDF terms to disk
+blocks. It is important to flush all caches to make the file state
+consistent with the cached states because some caches are
+write-behind so unwritten chnages may be held in-memory.</p>
+<p>Caches are flushes when a model or dataset is closed.</p>
+<div class="codehilite"><pre> <span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">createModel</span><span class="p">(</span><span class="n">disk</span> <span class="n">location</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">model</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+
+ <span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="n">TDBFactory</span><span class="o">.</span><span class="n">createDataset</span><span class="p">(</span><span class="n">disk</span> <span class="n">location</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+ <span class="o">...</span>
+ <span class="n">dataset</span><span class="o">.</span><span class="nb">close</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+</pre></div>
+
+
+<p>In addition, while TDB does not support full transaction semantics,
+the <code>Model.commit</code> does provide for synchronising the in-memory and
+disk states.</p>
+<div class="codehilite"><pre> <span class="n">model</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span><span class="err">Â </span><span class="p">;</span>
+</pre></div>
+
+
+<p>TDB provides an explicit call for model and dataset objects for
+synchronization with disk:</p>
+<div class="codehilite"><pre> <span class="n">Model</span> <span class="n">model</span> <span class="o">=</span> <span class="o">...</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">TDB</span><span class="o">.</span><span class="n">sync</span><span class="p">(</span><span class="n">model</span><span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+
+ <span class="n">Dataset</span> <span class="n">dataset</span> <span class="o">=</span> <span class="o">...</span> <span class="err">Â </span><span class="p">;</span>
+ <span class="n">TDB</span><span class="o">.</span><span class="n">sync</span><span class="p">(</span><span class="n">dataset</span> <span class="p">)</span><span class="err">Â </span><span class="p">;</span>
+</pre></div>
+
+
+<p>Any dataset or model can be passed to these functions - if they are
+not backed by TDB then no action is taken and the call merely
+returns without error.</p>
+<h2 id="concurrency">Concurrency</h2>
+<p>TDB provides a Multiple Reader or Single Writer (MRSW) policy for
+concurrency access. Applications are expected to adhere to this
+policy - it is not automatically checked.</p>
+<p>One gotcha is Java iterators. An iterator that is moving over the
+database is making read operations and no updates to the dataset
+are possible while an iterator is being used.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/jena/trunk/content/jena/documentation/tdb/joseki_integration.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/joseki_integration.html (added)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/joseki_integration.html Tue Nov 1 00:40:11 2011
@@ -0,0 +1,186 @@
+<!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.
+-->
+
+ <link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
+ <title>Apache Jena - TDB Joseki Integration</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
+ <script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
+</head>
+
+<body>
+ <div id="header">
+ <div id="logoblock">
+ <img alt="Apache Jena" src="/jena/images/jena-logo/jena-logo-small.png"/>
+ </div>
+
+ <div id="titleblock">
+ <h1 class="title">Apache Jena</h1>
+ <div id="topmenu" class="tabbar round-10">
+ <ul>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/index.html" id="home_menu">Home</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/help_and_support/index.html">Support</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/getting_started/index.html">Getting started</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/tutorials/index.html">Tutorials</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/documentation/index.html">Documentation</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="navigation" class="clear">
+ <h1 id="quick_links">Quick links</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/download/index.html">Downloads</a></li>
+<li><a href="/jena/help_and_support/index.html">Help and support</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/getting_involved/index.html">Getting involved</a></li>
+<li><a href="/jena/documentation/">Documentation</a></li>
+</ul>
+<h1 id="about_jena">About Jena</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/about_jena/about.html">About Jena</a></li>
+<li><a href="/jena/about_jena/architecture.html">Architecture</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/about_jena/team.html">Project team</a></li>
+</ul>
+<h1 id="download">Download</h1>
+<ul>
+<li><a href="/jena/download/index.html">Downloading Jena</a></li>
+<li><a href="/jena/download/maven.html">Using Maven</a></li>
+<li><a href="/jena/download/osgi.html">Using OSGi</a></li>
+</ul>
+<h1 id="help_and_support">Help and support</h1>
+<ul>
+<li><a href="/jena/help_and_support/index.html">Getting help</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Bugs and suggestions</a></li>
+</ul>
+<h1 id="getting_started">Getting Started</h1>
+<ul>
+<li><a href="/jena/getting_started/index.html">A first Jena project</a></li>
+<li><a href="/jena/getting_started/rdf_api.html">RDF API overview</a></li>
+<li><a href="/jena/getting_started/sparql.html">Querying RDF with SPARQL</a></li>
+<li><a href="/jena/getting_started/fuseki.html">Serving RDF over HTTP</a></li>
+<li><a href="/jena/getting_started/tell_me_how.html">Tell me how to ...</a></li>
+</ul>
+<h1 id="tutorials">Tutorials</h1>
+<ul>
+<li><a href="/jena/tutorials/index.html">RDF tutorial</a></li>
+<li><a href="/jena/tutorials/sparql.html">SPARQL queries</a></li>
+<li><a href="/jena/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/jena/documentation/index.html">Overview</a></li>
+<li><a href="/jena/documentation/javadoc">Javadoc</a></li>
+<li><a href="/jena/documentation/rdf/index.html">RDF</a></li>
+<li><a href="/jena/documentation/query/index.html">SPARQL (ARQ)</a></li>
+<li><a href="/jena/documentation/tdb/index.html">TDB</a></li>
+<li><a href="/jena/documentation/sdb/index.html">SDB</a><ul>
+<li><a href="/jena/documentation/sdb/installation.html">Installation</a></li>
+<li><a href="/jena/documentation/sdb/quickstart.html">Quick start</a></li>
+<li><a href="/jena/documentation/sdb/commands.html">Cmd line</a></li>
+<li><a href="/jena/documentation/sdb/javaapi.html">Java API</a></li>
+<li><a href="/jena/documentation/sdb/configuration.html">Config</a></li>
+<li><a href="/jena/documentation/sdb/databases_supported.html">Databases</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/larq/index.html">LARQ</a></li>
+<li><a href="/jena/documentation/serving_data/index.html">Serving Data</a></li>
+<li><a href="/jena/documentation/ontology/index.html">Ontology</a></li>
+<li><a href="/jena/documentation/inference/index.html">Inference</a></li>
+<li><a href="/jena/documentation/assembler/index.html">Assembler</a><ul>
+<li><a href="/jena/documentation/assembler/assembler-howto.html">Assembler how-to</a></li>
+<li><a href="/jena/documentation/assembler/inside-assemblers.html">Inside assemblers</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/io/index.html">I/O</a><ul>
+<li><a href="/jena/documentation/io/iohowto.html">I/O how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/notes/index.html">Notes</a><ul>
+<li><a href="/jena/documentation/notes/concurrency-howto.html">Concurrency how-to</a></li>
+<li><a href="/jena/documentation/notes/event-handler-howto.html">Event handler how-to</a></li>
+<li><a href="/jena/documentation/notes/file-manager.html">File manager how-to</a></li>
+<li><a href="/jena/documentation/notes/model-factory.html">Model factory how-to</a></li>
+<li><a href="/jena/documentation/notes/rdf-frames.html">RDF frames</a></li>
+<li><a href="/jena/documentation/notes/reification.html">Reification how-to</a></li>
+<li><a href="/jena/documentation/notes/typed-literals.html">Typed literals how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/tools/index.html">Tools</a><ul>
+<li><a href="/jena/documentation/tools/schemagen.html">schemagen</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="getting_involved">Getting Involved</h1>
+<ul>
+<li><a href="/jena/getting_involved/index.html">Contributing to Jena</a></li>
+</ul>
+<h1 id="asf_links">ASF links</h1>
+<ul>
+<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>
+ </div>
+
+ <div id="content">
+ <h1 class="title">TDB Joseki Integration</h1>
+ <p>Joseki uses an
+<a href="http://www.w3.org/TR/rdf-sparql-query/#rdfDataset" title="http://www.w3.org/TR/rdf-sparql-query/#rdfDataset">RDF dataset</a>
+description. Using a TDB graph in a Joseki server instance is a
+matter of putting the graph in a dataset as in the example below
+where it is the default graph of the dataset.</p>
+<p>Full assembler details on the
+<a href="assembler.html">TDB assembler description</a> page.</p>
+<p>A simple example that publishes one TDB-backed dataset at a SPARQL
+end-point:</p>
+<div class="codehilite"><pre><span class="o">[]</span> <span class="n">ja:loadClass</span> <span class="s">"com.hp.hpl.jena.tdb.TDB"</span> <span class="o">.</span>
+<span class="n">tdb:DatasetTDB</span> <span class="n">rdfs:subClassOf</span> <span class="n">ja:RDFDataset</span> <span class="o">.</span>
+<span class="n">tdb:GraphTDB</span> <span class="n">rdfs:subClassOf</span> <span class="n">ja:Model</span> <span class="o">.</span>
+
+<span class="sr"><#dataset></span> <span class="n">rdf:type</span> <span class="n">tdb:DatasetTDB</span><span class="err">Â </span><span class="p">;</span>
+ <span class="n">tdb:location</span> <span class="s">"DB"</span><span class="err">Â </span><span class="p">;</span>
+
+ <span class="o">.</span>
+</pre></div>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
Added: websites/staging/jena/trunk/content/jena/documentation/tdb/jvm_64_32.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/tdb/jvm_64_32.html (added)
+++ websites/staging/jena/trunk/content/jena/documentation/tdb/jvm_64_32.html Tue Nov 1 00:40:11 2011
@@ -0,0 +1,191 @@
+<!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.
+-->
+
+ <link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
+ <title>Apache Jena - TDB with 64-bit and 32-bit JVMs</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <script src="/jena/js/jquery-1.6.4.min.js" type="text/javascript"></script>
+ <script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
+</head>
+
+<body>
+ <div id="header">
+ <div id="logoblock">
+ <img alt="Apache Jena" src="/jena/images/jena-logo/jena-logo-small.png"/>
+ </div>
+
+ <div id="titleblock">
+ <h1 class="title">Apache Jena</h1>
+ <div id="topmenu" class="tabbar round-10">
+ <ul>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/index.html" id="home_menu">Home</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/help_and_support/index.html">Support</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/getting_started/index.html">Getting started</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/tutorials/index.html">Tutorials</a></li>
+ <li class="round-top-8"><a class="round-top-8" href="/jena/documentation/index.html">Documentation</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="navigation" class="clear">
+ <h1 id="quick_links">Quick links</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/download/index.html">Downloads</a></li>
+<li><a href="/jena/help_and_support/index.html">Help and support</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/getting_involved/index.html">Getting involved</a></li>
+<li><a href="/jena/documentation/">Documentation</a></li>
+</ul>
+<h1 id="about_jena">About Jena</h1>
+<ul>
+<li><a href="/jena/index.html">Home</a></li>
+<li><a href="/jena/about_jena/about.html">About Jena</a></li>
+<li><a href="/jena/about_jena/architecture.html">Architecture</a></li>
+<li><a href="/jena/about_jena/roadmap.html">Roadmap</a></li>
+<li><a href="/jena/about_jena/team.html">Project team</a></li>
+</ul>
+<h1 id="download">Download</h1>
+<ul>
+<li><a href="/jena/download/index.html">Downloading Jena</a></li>
+<li><a href="/jena/download/maven.html">Using Maven</a></li>
+<li><a href="/jena/download/osgi.html">Using OSGi</a></li>
+</ul>
+<h1 id="help_and_support">Help and support</h1>
+<ul>
+<li><a href="/jena/help_and_support/index.html">Getting help</a></li>
+<li><a href="/jena/help_and_support/bugs_and_suggestions.html">Bugs and suggestions</a></li>
+</ul>
+<h1 id="getting_started">Getting Started</h1>
+<ul>
+<li><a href="/jena/getting_started/index.html">A first Jena project</a></li>
+<li><a href="/jena/getting_started/rdf_api.html">RDF API overview</a></li>
+<li><a href="/jena/getting_started/sparql.html">Querying RDF with SPARQL</a></li>
+<li><a href="/jena/getting_started/fuseki.html">Serving RDF over HTTP</a></li>
+<li><a href="/jena/getting_started/tell_me_how.html">Tell me how to ...</a></li>
+</ul>
+<h1 id="tutorials">Tutorials</h1>
+<ul>
+<li><a href="/jena/tutorials/index.html">RDF tutorial</a></li>
+<li><a href="/jena/tutorials/sparql.html">SPARQL queries</a></li>
+<li><a href="/jena/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/jena/documentation/index.html">Overview</a></li>
+<li><a href="/jena/documentation/javadoc">Javadoc</a></li>
+<li><a href="/jena/documentation/rdf/index.html">RDF</a></li>
+<li><a href="/jena/documentation/query/index.html">SPARQL (ARQ)</a></li>
+<li><a href="/jena/documentation/tdb/index.html">TDB</a></li>
+<li><a href="/jena/documentation/sdb/index.html">SDB</a><ul>
+<li><a href="/jena/documentation/sdb/installation.html">Installation</a></li>
+<li><a href="/jena/documentation/sdb/quickstart.html">Quick start</a></li>
+<li><a href="/jena/documentation/sdb/commands.html">Cmd line</a></li>
+<li><a href="/jena/documentation/sdb/javaapi.html">Java API</a></li>
+<li><a href="/jena/documentation/sdb/configuration.html">Config</a></li>
+<li><a href="/jena/documentation/sdb/databases_supported.html">Databases</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/larq/index.html">LARQ</a></li>
+<li><a href="/jena/documentation/serving_data/index.html">Serving Data</a></li>
+<li><a href="/jena/documentation/ontology/index.html">Ontology</a></li>
+<li><a href="/jena/documentation/inference/index.html">Inference</a></li>
+<li><a href="/jena/documentation/assembler/index.html">Assembler</a><ul>
+<li><a href="/jena/documentation/assembler/assembler-howto.html">Assembler how-to</a></li>
+<li><a href="/jena/documentation/assembler/inside-assemblers.html">Inside assemblers</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/io/index.html">I/O</a><ul>
+<li><a href="/jena/documentation/io/iohowto.html">I/O how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/notes/index.html">Notes</a><ul>
+<li><a href="/jena/documentation/notes/concurrency-howto.html">Concurrency how-to</a></li>
+<li><a href="/jena/documentation/notes/event-handler-howto.html">Event handler how-to</a></li>
+<li><a href="/jena/documentation/notes/file-manager.html">File manager how-to</a></li>
+<li><a href="/jena/documentation/notes/model-factory.html">Model factory how-to</a></li>
+<li><a href="/jena/documentation/notes/rdf-frames.html">RDF frames</a></li>
+<li><a href="/jena/documentation/notes/reification.html">Reification how-to</a></li>
+<li><a href="/jena/documentation/notes/typed-literals.html">Typed literals how-to</a></li>
+</ul>
+</li>
+<li><a href="/jena/documentation/tools/index.html">Tools</a><ul>
+<li><a href="/jena/documentation/tools/schemagen.html">schemagen</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="getting_involved">Getting Involved</h1>
+<ul>
+<li><a href="/jena/getting_involved/index.html">Contributing to Jena</a></li>
+</ul>
+<h1 id="asf_links">ASF links</h1>
+<ul>
+<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>
+ </div>
+
+ <div id="content">
+ <h1 class="title">TDB with 64-bit and 32-bit JVMs</h1>
+ <p>TDB runs on both 32-bit and 64-bit Java Virtual Machines. The same
+file formats are used on both systems and database files can be
+transferred between architectures (no TDB system should be running
+for the the database at the time of copy). What differs is the file
+access mechanism used.</p>
+<p>The file access mechanism can be set explicitly, but this is not a
+good idea for production usage, only for experimentation - see the
+<a href="configuration.html#file_access_mode">File Access mode option</a>.</p>
+<h2 id="64-bit_java">64-bit Java</h2>
+<p>On 64-bit Java, TDB uses memory mapped files and the operating
+system handles much of the caching between RAM and disk. The amount
+of RAM used for file caching increases and decreases as other
+application run on the machine. The fewer other programs running on
+the machine, the more RAM will be available for file caching.</p>
+<p>TDB is faster on a 64 bit JVM because more memory is available for
+file caching.</p>
+<h2 id="32-bit_java">32-bit Java</h2>
+<p>On 32-bit Java, TDB uses it's own file caching to enable large
+databases. 32-bit Java limits the address space of the JVM to about
+1.5Gbytes (the exact size is JVM-dependent), and this includes
+memory mapped files, even though they are not in the Java heap. The
+JVM heap size may need to be increased to make space for the disk
+caches used by TDB.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2011 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache Jena, Jena, the Apache Jena project logo,
+ Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>