[Mulgara-svn] r268 - in trunk: . docs/site-src docs/site-src/integration docs/site-src/itqlcommands docs/site-src/style
thomas at mulgara.org
thomas at mulgara.org
Fri May 11 10:07:32 UTC 2007
Author: thomas
Date: 2007-05-11 05:07:31 -0500 (Fri, 11 May 2007)
New Revision: 268
Added:
trunk/docs/site-src/integration/jrdfaddtriples.html
trunk/docs/site-src/integration/jrdfcreategraph.html
trunk/docs/site-src/integration/jrdfcreatenodes.html
trunk/docs/site-src/integration/jrdfprereq.html
trunk/docs/site-src/integration/jrdfreify.html
trunk/docs/site-src/integration/jrdfremove.html
trunk/docs/site-src/integration/jrdftutorial.html
trunk/docs/site-src/integration/searchgraph.html
Removed:
trunk/docs/site-src/integration/httpmp3/
trunk/docs/site-src/integration/jrdf/
Modified:
trunk/docs/site-src/backofbook.html
trunk/docs/site-src/integration/index.html
trunk/docs/site-src/integration/jena.html
trunk/docs/site-src/integration/jsptutorial.html
trunk/docs/site-src/integration/perl.html
trunk/docs/site-src/integration/resolverhttpmp3.html
trunk/docs/site-src/itqlcommands/index.html
trunk/docs/site-src/style/style.css
trunk/docs/site-src/style/styleIE6.css
trunk/webdocs.xml
Log:
website navigation rewound. all known technical issues with the website redesign settled. now starting to look for a better background picture
Modified: trunk/docs/site-src/backofbook.html
===================================================================
--- trunk/docs/site-src/backofbook.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/backofbook.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -63,7 +63,7 @@
<a href="/overview/about.html">About the Mulgara Project</a><br />
<a href="/overview/aboutsite.html">About this site</a><br />
<a href="/overview/aboutsite.html#access">Accessibility</a><br />
- <a href="/jrdf/jrdfaddtriples.html">Adding Triples to the Graph</a><br />
+ <a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a><br />
<a href="/inferencing/infersemweb.html#o2647">Additional Features for Describing Classes and Properties</a><br />
<a href="itqloperations/index.html">Advanced iTQL Operations</a><br />
<a href="/descriptors/descadvantages.html">Advantages and Disadvantages of Descriptors</a><br />
@@ -98,7 +98,7 @@
<a href="/itqlcommands/comment.html">comment (#)</a><br />
<a href="/itqlcommands/commit.html">commit</a><br />
<a href="/descriptors/mistakes.html">Common Mistakes</a><br />
- <a href="/jrdf/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a><br />
+ <a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a><br />
<a href="/inferencing/sofa.html#o2639">Compiling and Running the Example</a><br />
<a href="/integration/compiling.html">Compiling with Ant</a><br />
<a href="/integration/parsers.html#o2704">Configuration and Initialisation</a><br />
@@ -122,10 +122,10 @@
<a href="/itqloperations/filesysmodel.html#o3202">Creating Filesystem Models</a><br />
<a href="/itqloperations/fulltextmodels.html#o258">Creating Full-Text Models</a><br />
<a href="/tutorial/itqlbasics.html#o231">Creating New Models</a><br />
- <a href="/jrdf/jrdfcreatenodes.html">Creating Nodes and Triples</a><br />
+ <a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a><br />
<a href="/itqloperations/nodetyping.html#o2780">Creating Nodetyping Models</a><br />
<a href="/integration/jena.html#o3186">Creating Sessions</a><br />
- <a href="/jrdf/jrdfcreategraph.html">Creating the Graph</a><br />
+ <a href="/integration/jrdfcreategraph.html">Creating the Graph</a><br />
<a href="/inferencing/sofa.html#o2626">Creating the Ontology</a><br />
<a href="/itqloperations/views.html#o3012">Creating Views</a><br />
<a href="/overview/index.html#o1026">Cross OS/Platform Support</a><br />
@@ -225,11 +225,11 @@
<a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a><br />
<a href="/integration/jena.html">Jena</a><br />
<a href="/system/jrdfapis.html">JRDF APIs</a><br />
- <a href="/jrdf/jrdfcreategraph.html#o2901">JRDF Graph (Memory Graph)</a><br />
+ <a href="/integration/jrdfcreategraph.html#o2901">JRDF Graph (Memory Graph)</a><br />
<a href="/system/jrdfexamples.html#o2514">JRDF Graph (Memory)</a><br />
<a href="/system/jrdfgraphs.html">JRDF Graphs</a><br />
<a href="/system/jrdfmemory.html">JRDF Memory Implementation</a><br />
- <a href="/jrdftutorial.html">JRDF Tutorial</a>
+ <a href="/integration/jrdftutorial.html">JRDF Tutorial</a>
</div>
<div class="anchor indexanchor"><a name="75"> </a></div><div class="ABC">K</div>
<div class="indexlist">
@@ -286,7 +286,7 @@
<div class="anchor indexanchor"><a name="79"> </a></div><div class="ABC">O</div>
<div class="indexlist">
<a href="/system/jrdfgraphs.html#o2473">ObjectNodes</a><br />
- <a href="/jrdf/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a><br />
+ <a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a><br />
<a href="/itqlcommands/select.html#o192">offset Clause</a><br />
<a href="/overview/index.html#o1032">On-Line Backups</a><br />
<a href="/inferencing/ontomanage.html">Ontology Management</a><br />
@@ -360,14 +360,14 @@
<a href="/inferencing/infersemweb.html#o3019">Ranges</a><br />
<a href="/overview/links.html#o759">RDF Data</a><br />
<a href="/overview/links.html#o753">RDF Training</a><br />
- <a href="/jrdf/jrdfcreategraph.html#o2903">Read Only iTQL Result JRDF Graph (iTQL Graph)</a><br />
+ <a href="/integration/jrdfcreategraph.html#o2903">Read Only iTQL Result JRDF Graph (iTQL Graph)</a><br />
<a href="/inferencing/entailment.html#o2932">Reflexivity</a><br />
- <a href="/jrdf/jrdfreify.html">Reify Triples</a><br />
+ <a href="/integration/jrdfreify.html">Reify Triples</a><br />
<a href="/overview/faq.html#o1064">Relational databases</a><br />
<a href="/overview/index.html#o1035">Reliability</a><br />
<a href="/system/jrdfexamples.html#o2517">Remove a Triple from the JRDF Graph</a><br />
<a href="/tutorial/itqlbasics.html#o234">Removing Models</a><br />
- <a href="/jrdf/jrdfremove.html">Removing Triples from the Graph</a><br />
+ <a href="/integration/jrdfremove.html">Removing Triples from the Graph</a><br />
<a href="/system/jsptaglib.html#o489">render</a><br />
<a href="/descriptors/reserved.html">Reserved Parameters</a><br />
<a href="/resolvers/resolverdbclass.html">Resolver Database Class</a><br />
@@ -383,13 +383,13 @@
<div class="indexlist">
<a href="/overview/index.html#o1020">Scalability</a><br />
<a href="/inferencing/infermulgara.html#o2728">Schema Model</a><br />
- <a href="/jrdf/searchgraph.html">Searching the Graph</a><br />
+ <a href="/integration/searchgraph.html">Searching the Graph</a><br />
<a href="/inferencing/infersitu.html#o3016">Second Search</a><br />
<a href="/itqlcommands/select.html">select</a><br />
<a href="/itqlcommands/select.html#o188">select Clause</a><br />
<a href="/inferencing/infersemweb.html">Semantic Web</a><br />
- <a href="/jrdf/jrdfcreategraph.html#o2902">Server Backed JRDF Graph (Client Graph)</a><br />
- <a href="/jrdf/jrdfcreategraph.html#o3189">Server-side JRDF Graph (Server Graph)</a><br />
+ <a href="/integration/jrdfcreategraph.html#o2902">Server Backed JRDF Graph (Client Graph)</a><br />
+ <a href="/integration/jrdfcreategraph.html#o3189">Server-side JRDF Graph (Server Graph)</a><br />
<a href="/itqlcommands/set.html">set</a><br />
<a href="/inferencing/inferexample.html#o2736">Should I use SOFA or iTQL?</a><br />
<a href="/system/soap.html">Simple Object Access Protocol (SOAP)</a><br />
Modified: trunk/docs/site-src/integration/index.html
===================================================================
--- trunk/docs/site-src/integration/index.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/index.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -42,7 +42,7 @@
<p class="relateditem"><a href="/integration/jena.html">Jena</a></p>
<p class="relateditem"><a href="/integration/perl.html">Perl</a></p>
<p class="relateditem"><a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a></p>
-<p class="relateditem"><a href="/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
Modified: trunk/docs/site-src/integration/jena.html
===================================================================
--- trunk/docs/site-src/integration/jena.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jena.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -42,7 +42,7 @@
<p class="relateditem"><a href="/integration/resolverhttpmp3.html">HTTP Resolver and MP3 Content Handler Tutorial</a></p>
<p class="relateditem"><a href="/integration/perl.html">Perl</a></p>
<p class="relateditem"><a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a></p>
-<p class="relateditem"><a href="/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
-->
Copied: trunk/docs/site-src/integration/jrdfaddtriples.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfaddtriples.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfaddtriples.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfaddtriples.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,73 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Adding Triples to the Graph</title>
+ <meta name="keywords" content="Triples, Graph, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdfcreatenodes.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/searchgraph.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+ -->
+
+
+
+
+<h3>Adding Triples to the Graph</h3>
+
+<p>Triples are inserted a graph using the graph's <code>add(Triple triple)</code> method.</p>
+
+<p class="commandtext">graph.add(addressStatement);<br />
+graph.add(streetStatement);<br />
+graph.add(cityStatement);<br />
+graph.add(stateStatement);<br />
+graph.add(postCodeStatement);</p>
+
+<p>The graph now contains the following statements (where <code>_blankNode123</code> represents a blank node instance):</p>
+
+<p class="commandtext">http://example.org/staffid#85740 http://example.org/terms#address _blankNode123<br />
+_blankNode123 http://example.org/terms#street "1501 Grant Avenue"<br />
+_blankNode123 http://example.org/terms#city "Bedford"<br />
+_blankNode123 http://example.org/terms#state "Massachusetts"<br />
+_blankNode123 http://example.org/terms#postalCode "01730"</p>
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdfcreategraph.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfcreategraph.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfcreategraph.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfcreategraph.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,128 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Creating the Graph</title>
+ <meta name="keywords" content="Graph, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a> |
+
+ <a href="/integration/jrdfcreategraph.html#o2901">Memory Graph</a> |
+ <a href="/integration/jrdfcreategraph.html#o3189">Server Graph</a> |
+ <a href="/integration/jrdfcreategraph.html#o2902">Client Graph</a> |
+ <a href="/integration/jrdfcreategraph.html#o2903">iTQL Graph</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdfprereq.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfcreatenodes.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+ -->
+
+
+
+
+<h3>Creating the Graph</h3>
+
+<p>The <a id="h3190" class="documentlinktemplate" title="Comparison of JRDF Graph Implementations" href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations section</a> outlines the advantages and disadvantages of the different implementation options. Choose the one that is most suitable for your requirements.</p>
+
+<p>You can create more than one graph and use them together. For example, you might use an iTQL graph to retrieve results from a query, load the contents into a memory graph for efficient presentation and editing, and then persist the edited statements using a client graph.</p>
+
+<div class="anchor"><a name="o2901"> </a></div>
+<h4>JRDF Graph (Memory Graph)</h4>
+
+<p>The following code creates a memory graph:</p>
+
+<p class="commandtext">Graph graph = new GraphImpl();</p>
+<div class="anchor"><a name="o3189"> </a></div>
+<h4>Server-side JRDF Graph (Server Graph)</h4>
+
+<p>You need to obtain a session for your Mulgara server before you can create a server graph. When obtaining the session, use <code>SessionFactoryFinder.newSessionFactory(serverURI, false)</code> to indicate that the server is running in the same JVM (that is, it is running locally).</p>
+
+<p>The server graph is created using a <code>LocalJRDFSession</code>. See the Obtaining a Session from the TKS Server section for more information on how to obtain a <code>LocalJRDFSession</code>.</p>
+
+<p>After obtaining a local session, the following code creates a server graph:</p>
+
+<p class="commandtext">//create a new Model<br />
+URI modelURI = new URI("rmi://mysite.com/server1#exampleGraph");<br />
+URI modelType = new URI("http://mulgara.org/mulgara#Model");<br />
+session.createModel(modelURI, modelType);<br />
+<br />
+//create a JRDF Graph for the model<br />
+Graph graph = new JRDFGraph(session, modelURI);</p>
+<div class="anchor"><a name="o2902"> </a></div>
+<h4>Server Backed JRDF Graph (Client Graph)</h4>
+
+<p>You need to obtain a session for your Mulgara server before you can create a client graph. When obtaining the session, use <code>SessionFactoryFinder.newSessionFactory(serverURI, true)</code> to indicate that the server is running remotely.</p>
+
+<p>The Client Graph is created using a <code>JRDFSession</code>. See the Obtaining a Session from the Mulgara Server section for more information on how to obtain a <code>JRDFSession</code>.</p>
+
+<p>After obtaining a session, the following code creates a client graph:</p>
+
+<p class="commandtext">//create a new Model<br />
+URI modelURI = new URI("rmi://mysite.com/server1#exampleGraph");<br />
+URI modelType = new URI("http://mulgara.org/mulgara#Model");<br />
+session.createModel(modelURI, modelType);<br />
+<br />
+//create a JRDF Graph for the model<br />
+Graph graph = AbstractGraphFactory.createGraph(modelURI, session);</p>
+
+<p>The code <code>session.createModel(modelURI, modelType);</code> creates a new model if the model does not exist. If the model already exists, this line is not required.</p>
+<div class="anchor"><a name="o2903"> </a></div>
+<h4>Read Only iTQL Result JRDF Graph (iTQL Graph)</h4>
+
+<p>You need to obtain a session for your Mulgara server before you can create an iTQL graph. After obtaining a session, the following code creates an iTQL graph.</p>
+
+<p class="commandtext">//create the query<br />
+String queryText = "select $s $p $o from <rmi://mysite.com/server1#testModel> where $s $p $o ; ";<br />
+ItqlInterpreter interpreter = new ItqlInterpreter(new HashMap());<br />
+Query query = interpreter.parse(queryText);<br />
+<br />
+//execute the query<br />
+Answer queryResult = session.query(query);<br />
+<br />
+//create a JRDF Graph<br />
+Graph graph = AbstractGraphFactory.createGraph(queryResult);</p>
+
+<p>The iTQL query <code>select $s $p $o from <rmi://mysite.com/server1#testModel> where $s $p $o;</code> returns all statements from the model.</p>
+
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdfcreatenodes.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfcreatenodes.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfcreatenodes.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfcreatenodes.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,92 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Creating Nodes and Triples</title>
+ <meta name="keywords" content="Nodes, Triples, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdfcreategraph.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfaddtriples.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+
+ -->
+
+
+
+
+<h3>Creating Nodes and Triples</h3>
+
+<p>Nodes and tiples are created using a <code>GraphElementFactory</code> that is obtained from a JRDF graph using the graph's <code>getElementFactory()</code> method. The following code creates example nodes and triples:</p>
+
+<p class="commandtext">//get the Factory<br />
+GraphElementFactory elementFactory = graph.getElementFactory();<br />
+<br />
+//create resources<br />
+URIReference person = elementFactory.createResource(new URI("http://example.org/staffid#85740"));<br />
+BlankNode address = elementFactory.createResource();<br />
+<br />
+//create properties<br />
+URIReference hasAddress = elementFactory.createResource(new URI("http://example.org/terms#address"));<br />
+URIReference hasStreet = elementFactory.createResource(new URI("http://example.org/terms#street"));<br />
+URIReference hasCity = elementFactory.createResource(new URI("http://example.org/terms#city"));<br />
+URIReference hasState = elementFactory.createResource(new URI("http://example.org/terms#state"));<br />
+URIReference hasPostCode = elementFactory.createResource<br />
+ (new URI("http://example.org/terms#postalCode"));<br />
+<br />
+//create values<br />
+Literal street = elementFactory.createLiteral("1501 Grant Avenue");<br />
+Literal city = elementFactory.createLiteral("Bedford");<br />
+Literal state = elementFactory.createLiteral("Massachusetts");<br />
+Literal postCode = elementFactory.createLiteral("01730");<br />
+<br />
+//create statements<br />
+Triple addressStatement = elementFactory.createTriple(person, hasAddress, address);<br />
+Triple streetStatement = elementFactory.createTriple(address, hasStreet, street);<br />
+Triple cityStatement = elementFactory.createTriple(address, hasCity, city);<br />
+Triple stateStatement = elementFactory.createTriple(address, hasState, state);<br />
+Triple postCodeStatement = elementFactory.createTriple(address, hasPostCode, postCode);</p>
+
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdfprereq.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfprereq.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfprereq.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfprereq.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,298 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Prerequisites</title>
+ <meta name="keywords" content="Prerequisites, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdftutorial.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfcreategraph.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+ -->
+
+
+
+
+<h3>Prerequisites</h3>
+
+<p>The following prerequisites should be met before this JRDF tutorial can be run:</p>
+<ul><li>Java<sup>TM</sup> software, version 1.4 or higher. You can check the version you have installed by typing at a command line:
+<p class="listcontinuecommandtext">java -version</p>
+
+<p class="listcontinue">Something similar to the following should display:</p>
+
+<p class="listcontinuecommandtext">java version "1.4.2_04"<br />
+Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_04-b05)<br />
+Java HotSpot(TM) Client VM (build 1.4.2_04-b05, mixed mode)</p>
+
+<p class="listcontinue">If the above does not display, add <code><JAVA_HOME>/bin</code>, where <code><JAVA_HOME></code> is the location where J2SE<sup>TM</sup> is installed, to your <code>PATH </code>(in the appropriate way for your shell).</p>
+
+<p class="listcontinue">For more information on installing and running Java software, read the <a class="jumptemplate" title="" href="http://java.sun.com/j2se/1.4.2/install.html">J2SE 1.4 Installation guide</a>.</p>
+</li><li>A valid installation of Mulgara. For information on installing Mulgara, see the relevant sections in the Mulgara documentation.</li><li>Basic Java programming experience.</li></ul>
+<div class="anchor"><a name="o2898"> </a></div>
+<h3>Obtaining a Session from a Mulgara Server</h3>
+
+<p>The Mulgara server can be accessed using the the JRDF API using either a local connection (in the same Java Virtual Machine (JVM)) or via a client/server interface.</p>
+
+<p>The local connection provides the ability to create a new server or start an existing one and access it through the JRDF API. The client/server interface connects to an existing server using RMI, if it exists, or failing this, falls back to creating a new local server. Falling back to local server does not start the RMI registry and other external clients cannot access it unless started manually.</p>
+
+<p>The Mulgara server has a local implementation of the JRDF API that can be created using a <code>LocalJRDFSession</code> and a remote implementation that uses a <code>JRDFSession</code>. In order to use these APIs, you must first have the corresponding Session. These Sessions are obtained via a <code>SessionFactory</code>. To construct a new <code>SessionFactory</code>, the URI of the server is required as well as an optional boolean parameter indicating whether the server is remote or not. If this boolean parameter is not provided, the server is assumed to be local (in the same JVM). For example:</p>
+
+<p class="commandtext">// Create the host name<br />
+String hostname = InetAddress.getLocalHost().getCanonicalHostName();<br />
+<br />
+// Create the URI of the server<br />
+serverURI = new URI("rmi", hostname, "/" + SERVER_NAME, null);<br />
+<br />
+// Create a new session factory, ensure that it's local<br />
+SessionFactory sessionFactory = SessionFactoryFinder.newSessionFactory(serverURI, false);<br />
+<br />
+// Get a local JRDF Session (local)<br />
+LocalJRDFSession session = (LocalJRDFSession) sessionFactory.newJRDFSession();</p>
+
+<p>If a local server is created, the server configuration file is used to determine which directory to place the server's files in.</p>
+
+<p>If a remote <code>SessionFactory</code> is used, then the session can only be cast to a <code>JRDFSession</code>. For example:</p>
+
+<p class="commandtext">// Create a new remote session factory<br />
+SessionFactory sessionFactory = SessionFactoryFinder.newSessionFactory(serverURI, true);<br />
+<br />
+// Get a Remote JRDF Session (client/server)<br />
+JRDFSession session = (JRDFSession) sessionFactory.newJRDFSession();</p>
+<div class="anchor"><a name="o2899"> </a></div>
+<h3>Comparison of JRDF Graph Implementations</h3>
+
+<p>The following table outlines the advantages and disadvantages of the different JRDF graph implementations.</p>
+<table width="516" cellpadding="2" cellspacing="0" border="0" style="border-collapse:collapse">
+<tr>
+<td width="258" height="0"></td>
+<td width="258" height="0"></td>
+</tr>
+<tr align="left" valign="top">
+<td colspan="2" width="516">
+<p class="tableheading">Memory Graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p class="tableheading">Advantages</p>
+</td>
+<td width="258">
+<p class="tableheading">Disadvantages</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Very fast</p>
+</td>
+<td width="258">
+<p>Not persisted to disk</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Small footprint</p>
+</td>
+<td width="258">
+<p>Not scalable</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p> </p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td colspan="2" width="516">
+<p class="tableheading">Server Graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p class="tableheading">Advantages</p>
+</td>
+<td width="258">
+<p class="tableheading">Disadvantages</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>No network overhead</p>
+</td>
+<td width="258">
+<p>Slower than memory graph, but faster than client graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Persistent datastore</p>
+</td>
+<td width="258">
+<p>Must be run in the same JVM as the Mulgara server</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Scalable</p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p> </p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td colspan="2" width="516">
+<p class="tableheading">Client Graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p class="tableheading">Advantages</p>
+</td>
+<td width="258">
+<p class="tableheading">Disadvantages</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Client/server architecture means client can be on different machine to server</p>
+</td>
+<td width="258">
+<p>Slower than memory graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Persistent datastore</p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Full Mulgara server advantages</p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Scalable </p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p> </p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td colspan="2" width="516">
+<p class="tableheading">iTQL Graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p class="tableheading">Advantages</p>
+</td>
+<td width="258">
+<p class="tableheading">Disadvantages</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Client/server architecture means client can be on different machine to server</p>
+</td>
+<td width="258">
+<p>Slower than memory graph and client graph</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Creates a graph from the results of an iTQL query</p>
+</td>
+<td width="258">
+<p>Read-only (cannot add or remove statements)</p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Persistent datastore</p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+<tr align="left" valign="top">
+<td width="258">
+<p>Scalable </p>
+</td>
+<td width="258">
+<p> </p>
+</td>
+</tr>
+
+</table>
+
+
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdfreify.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfreify.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfreify.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfreify.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,98 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Reify Triples</title>
+ <meta name="keywords" content="reification, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/searchgraph.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfremove.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+
+
+ -->
+
+
+
+<h3>Reify Triples</h3>
+
+<p>A statement can be made about another statement using reification. JRDF supports reification via a <code>TripleFactory</code> obtained using a graph's <code>getTripleFactory()</code> method. The following code inserts a reified statement:</p>
+
+<p class="commandtext">TripleFactory tripleFactory = graph.getTripleFactory();<br />
+<br />
+//create a resource to identify the statement<br />
+URIReference statement = elementFactory.createResource<br />
+ (new URI("http://example.org/statement#address"));<br />
+<br />
+//reify the address statement (person, hasAddress, address)<br />
+tripleFactory.reifyTriple(addressStatement, statement);<br />
+<br />
+//insert a statement about the original statement<br />
+URIReference manager = elementFactory.createResource(new URI("http://example.org/managerid#65"));<br />
+URIReference hasConfirmed = elementFactory.createResource<br />
+ (new URI("http://example.org/terms#hasConfirmed"));<br />
+Triple confirmationStatement = elementFactory.createTriple(manager, hasConfirmed, statement);<br />
+graph.add(confirmationStatement);</p>
+
+<p>The graph now contains:</p>
+
+<p class="commandtext">http://example.org/staffid#85740 http://example.org/terms#address _blankNode123<br />
+_blankNode123 http://example.org/terms#street "1501 Grant Avenue"<br />
+_blankNode123 http://example.org/terms#city "Bedford"<br />
+_blankNode123 http://example.org/terms#state "Massachusetts"<br />
+_blankNode123 http://example.org/terms#postalCode "01730"<br />
+<br />
+http://example.org/managerid#65 http://example.org/terms#hasConfirmed<br />
+ http://example.org/statement#address<br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#subject<br />
+ http://example.org/staffid#85740<br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#predicate<br />
+ http://example.org/terms#address<br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#object<br />
+ _blankNode123<br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#type<br />
+ http://www.w3.org/1999/02/22-rdf-syntax-ns#Statement</p>
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdfremove.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdfremove.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdfremove.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdfremove.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,84 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Removing Triples from the Graph</title>
+ <meta name="keywords" content=", mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdfreify.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/itqlcommands/index.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+
+
+ -->
+
+
+
+<h3>Removing Triples from the Graph</h3>
+
+<p>You can remove triples from a graph using it's <code>remove(Triple triple)</code> method. The following code removes a triple:</p>
+
+<p class="commandtext">//delete the city (address, hasCity, city) <br />
+graph.remove(cityStatement);</p>
+
+<p>The graph now contains:</p>
+
+<p class="commandtext">http://example.org/staffid#85740 http://example.org/terms#address _blankNode123 <br />
+_blankNode123 http://example.org/terms#street "1501 Grant Avenue" <br />
+_blankNode123 http://example.org/terms#state "Massachusetts" <br />
+_blankNode123 http://example.org/terms#postalCode "01730" <br />
+<br />
+http://example.org/managerid#65 http://example.org/terms#hasConfirmed<br />
+ http://example.org/statement#address <br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#subject<br />
+ http://example.org/staffid#85740 <br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#predicate<br />
+ http://example.org/terms#address <br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#object<br />
+ _blankNode123<br />
+http://example.org/statement#address http://www.w3.org/1999/02/22-rdf-syntax-ns#type<br />
+ http://www.w3.org/1999/02/22-rdf-syntax-ns#Statement</p>
+
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Copied: trunk/docs/site-src/integration/jrdftutorial.html (from rev 267, trunk/docs/site-src/integration/jrdf/jrdftutorial.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/jrdftutorial.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jrdftutorial.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,92 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - JRDF Tutorial</title>
+ <meta name="keywords" content="JRDF, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jsptutorial.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfprereq.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">In This Section</p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/searchgraph.html">Searching the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/index.html">Integration Tutorials</a></p>
+<p class="relateditem"><a href="/integration/resolverhttpmp3.html">HTTP Resolver and MP3 Content Handler Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jena.html">Jena</a></p>
+<p class="relateditem"><a href="/integration/perl.html">Perl</a></p>
+<p class="relateditem"><a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a></p>
+
+ -->
+
+
+
+
+<h2>JRDF Tutorial</h2>
+
+<p>JRDF is a set of APIs that provide a concise implementation of the Resource Description Framework (RDF) using standard Java conventions. JRDF offers a highly modular and type safe interface allowing users to create, store and query RDF statements. It includes a default memory implementation that can be used in conjunction with Mulgara<sup>TM</sup> to provide a scalable RDF solution.</p>
+
+<p>The example code provided in this tutorial is from the <code>org.jrdf.mem.JRDFExample</code> class. The <code>JRDFExample</code> class uses an in-memory JRDF graph implementation and can be run by typing at a command line:</p>
+
+<p class="commandtext">java -cp <TKS installation directory>/driver-2.1.jar org.jrdf.mem.JRDFExample</p>
+
+<p>The code for <code>JRDFExample</code> is in the <code>Resources</code> directory of your TKS installation. The JRDF API documentation is in <code><a class="internetlinktemplate" title="" href="api/jrdf/index.html"><TKS install>/docs/api/jrdf</a></code>.</p>
+
+<p>There are four JRDF graph implementations to choose from:</p>
+<ol><li>JRDF graph (memory graph)
+<p class="listcontinue">The JRDF jar provides a memory implementation under 60Kb and is available for download from <code><a class="jumptemplate" title="" href="http://sourceforge.net/projects/jrdf/">http://sourceforge.net/projects/jrdf/</a></code>. The memory graph is easy to create and is useful for small graphs and caching of results from larger graphs (subgraphs). The classes are in the <code>org.jrdf.graph.mem</code> package of the JRDF jar.</p>
+</li><li>Server-side JRDF Graph (server graph)
+<p class="listcontinue">Mulgara provides a server-side JRDF Graph interface for accessing a model. The graph must be created in the same JVM that the Mulgara server is running in.</p>
+
+<p class="listcontinue">Server graphs can be used for direct access to the database using a graph API. This is useful for applications that use Mulgara as an embedded component. The server graph classes are in the <code>org.mulgara.jrdf</code> package of the server jar.</p>
+</li><li>Server backed JRDF graph (client graph)
+<p class="listcontinue">Mulgara also provides a client-side JRDF graph interface for accessing a model. This provides a scalable RDF solution for remote client applications.</p>
+
+<p class="listcontinue">Client graphs can be used in conjunction with memory graphs. Memory implemented nodes and triples can be inserted into, removed from and used to query client graphs. Other JRDF implementations can also be used, but may not be supported. The client graph classes are in the <code>org.mulgara.client.jrdf</code> package of the Driver jar.</p>
+</li><li>Read-only iTQL result JRDF graph (iTQL graph)
+<p class="listcontinue">Mulgara also allows you to create read-only JRDF graphs from the results of an iTQL query. This provides a powerful mechanism for displaying search results as a subgraph. The classes are in the <code>org.mulgara.client.jrdf</code> package of the Driver jar.</p>
+</li></ol>
+<p>Each of these JRDF graph implementations are outlined in the following sections.</p>
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Modified: trunk/docs/site-src/integration/jsptutorial.html
===================================================================
--- trunk/docs/site-src/integration/jsptutorial.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/jsptutorial.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -33,14 +33,14 @@
<!--
<p><a href="/integration/perl.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
-<p><a href="/jrdftutorial.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+<p><a href="/integration/jrdftutorial.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
<p class="relatedheading">See Also</p>
<p class="relateditem"><a href="/integration/index.html">Integration Tutorials</a></p>
<p class="relateditem"><a href="/integration/resolverhttpmp3.html">HTTP Resolver and MP3 Content Handler Tutorial</a></p>
<p class="relateditem"><a href="/integration/jena.html">Jena</a></p>
<p class="relateditem"><a href="/integration/perl.html">Perl</a></p>
-<p class="relateditem"><a href="/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
-->
Modified: trunk/docs/site-src/integration/perl.html
===================================================================
--- trunk/docs/site-src/integration/perl.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/perl.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -33,7 +33,7 @@
<p class="relateditem"><a href="/integration/resolverhttpmp3.html">HTTP Resolver and MP3 Content Handler Tutorial</a></p>
<p class="relateditem"><a href="/integration/jena.html">Jena</a></p>
<p class="relateditem"><a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a></p>
-<p class="relateditem"><a href="/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
-->
Modified: trunk/docs/site-src/integration/resolverhttpmp3.html
===================================================================
--- trunk/docs/site-src/integration/resolverhttpmp3.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/resolverhttpmp3.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -42,7 +42,7 @@
<p class="relateditem"><a href="/integration/jena.html">Jena</a></p>
<p class="relateditem"><a href="/integration/perl.html">Perl</a></p>
<p class="relateditem"><a href="/integration/jsptutorial.html">JavaServer Pages Tag Library</a></p>
-<p class="relateditem"><a href="/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
-->
Copied: trunk/docs/site-src/integration/searchgraph.html (from rev 267, trunk/docs/site-src/integration/jrdf/searchgraph.html)
===================================================================
--- trunk/docs/site-src/integration/jrdf/searchgraph.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/integration/searchgraph.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -0,0 +1,115 @@
+@@includeTop@@
+
+ <title>Mulgara | Semantic Store - Searching the Graph</title>
+ <meta name="keywords" content="Search, Graph, mulgara project, metadata, metastore, metadatabase, datastore, database, scaleable, scalable, transaction, java, open source, rdf, resource description framework" />
+
+@@includeMiddle@@
+
+<!-- INNER PAGE NAVIGATION STARTS HERE -->
+<div id="navPage">
+ <a href="#top">Top</a>
+
+</div>
+<!-- INNER PAGE NAVIGATION ENDS HERE -->
+
+
+
+<!-- PAGE CONTENT STARTS HERE -->
+<div id="content" class="inOut">
+<a name="textonlynav"></a>
+
+
+
+
+
+
+<!--
+<p><a href="/integration/jrdfaddtriples.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p><a href="/integration/jrdfreify.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+
+<p class="relatedheading">See Also</p>
+<p class="relateditem"><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html">Prerequisites</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></p>
+<p class="relateditem"><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfaddtriples.html">Adding Triples to the Graph</a></p>
+<p class="relateditem"><a href="/integration/jrdfreify.html">Reify Triples</a></p>
+<p class="relateditem"><a href="/integration/jrdfremove.html">Removing Triples from the Graph</a></p>
+
+
+ -->
+
+
+
+
+<h3>Searching the Graph</h3>
+
+<p>You can search a graph using it's <code>find(Triple triple)</code> method. The nodes in the triple are used to match the nodes in the graph. Any null nodes in the triple are treated as wildcards and match to any node in the graph.</p>
+
+<p>Triples are returned in the form of a <code>ClosableIterator,</code> which extends <code>Iterator</code> and has a <code>close()</code> method that is used to free resources. Calling <code>next()</code> on a <code>ClosableIterator</code> returns a triple object. Triples are not guaranteed to be returned in any specific order.</p>
+
+<p>The following code examples demonstrate using the <code>find(Triple triple)</code> method to search a graph.</p>
+
+<p>To search for all triples:</p>
+
+<p class="commandtext">//get all Triples <br />
+Triple findAll = elementFactory.createTriple(null, null, null); <br />
+ClosableIterator allTriples = graph.find(findAll);</p>
+
+<p>This returns:</p>
+
+<p class="commandtext">http://example.org/staffid#85740 http://example.org/terms#address _blankNode123<br />
+_blankNode123 http://example.org/terms#street "1501 Grant Avenue"<br />
+_blankNode123 http://example.org/terms#city "Bedford"<br />
+_blankNode123 http://example.org/terms#state "Massachusetts"<br />
+_blankNode123 http://example.org/terms#postalCode "01730"</p>
+
+<p>To search for all addresses:</p>
+
+<p class="commandtext">//search for address (as a subject)<br />
+Triple findAddress = elementFactory.createTriple(address, null, null);<br />
+ClosableIterator addressSubject = graph.find(findAddress);</p>
+
+<p>This returns:</p>
+
+<p class="commandtext">_blankNode123 http://example.org/terms#street "1501 Grant Avenue"<br />
+_blankNode123 http://example.org/terms#city "Bedford"<br />
+_blankNode123 http://example.org/terms#state "Massachusetts"<br />
+_blankNode123 http://example.org/terms#postalCode "01730"</p>
+
+<p>To search for a city:</p>
+
+<p class="commandtext">//search for the city: "Bedford"<br />
+Triple findCity = elementFactory.createTriple(null, null, city);<br />
+ClosableIterator bedfordCity = graph.find(findCity);</p>
+
+<p>This returns:</p>
+
+<p class="commandtext">_blankNode123 http://example.org/terms#city "Bedford"</p>
+
+<p>To search for subjects with an address property:</p>
+
+<p class="commandtext">//search for any subject that has an address<br />
+Triple findAddresses = elementFactory.createTriple(null, hasAddress, null);<br />
+ClosableIterator addresses = graph.find(findAddresses);</p>
+
+<p>This returns:</p>
+
+<p class="commandtext">http://example.org/staffid#85740 http://example.org/terms#address _blankNode123</p>
+
+
+
+
+
+
+
+
+</div>
+<!-- PAGE CONTENT ENDS HERE -->
+
+@@includeBottom@@
+
+
Modified: trunk/docs/site-src/itqlcommands/index.html
===================================================================
--- trunk/docs/site-src/itqlcommands/index.html 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/itqlcommands/index.html 2007-05-11 10:07:31 UTC (rev 268)
@@ -24,7 +24,7 @@
<!--
-<p><a href="/jrdf/jrdfremove.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
+<p><a href="/integration/jrdfremove.html"><img src="previous.gif" alt="Previous Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
<p><a href="/itqlcommands/alias.html"><img src="next.gif" alt="Next Topic" height="25px" width="23px" vspace="2" hspace="2" align="bottom" border="0" /></a></p>
-->
Modified: trunk/docs/site-src/style/style.css
===================================================================
--- trunk/docs/site-src/style/style.css 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/style/style.css 2007-05-11 10:07:31 UTC (rev 268)
@@ -124,16 +124,16 @@
}
#navSite li li {
border-left: 4px solid #aaa;
- margin: 1px 0;
+ width: 129px;
+ margin: 1px 0 2px 0;
padding: 0 0 0 3px;
line-height: 90%;
- font-size: small;
+ font-size: x-small;
}
#navSite li.secindex {
border-left: 0;
- margin-left: 0px;
margin: 2px 0;
- line-height: 110%;
+ line-height: 103%;
font-size: small;
}
#navSite .toc {
@@ -159,7 +159,7 @@
font-size: large;
}
.navtocseperator {
- height: 6px;
+ height: 8px;
}
/* nav in out arrows */
Modified: trunk/docs/site-src/style/styleIE6.css
===================================================================
--- trunk/docs/site-src/style/styleIE6.css 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/docs/site-src/style/styleIE6.css 2007-05-11 10:07:31 UTC (rev 268)
@@ -45,30 +45,45 @@
#verticalLine {
margin-left: 0px;
top: 8px;
- height: 447px;
+ height: 421px;
}
+#navSite li li, #navSite ul, li.secindex {
+ margin: 0;
+ border: 0;
+ height: 0;
+ padding: 0;
+}
-#navSite {
- line-height: inherit;
-}
+
+/*
#navSite li li {
margin: 0px 0;
padding: 0 0 0 3px;
- line-height: 70%;
-}
+
+ border-left: 4px solid #aaa;
+ width: 129px;
+ margin: 1px 0 2px 0;
+ padding: 0 0 0 3px;
+ font-size: x-small;
+ }
#navSite li.secindex {
border-left: 0;
margin: 0;
- line-height: 80%;
font-size: small;
}
#navSite li.secindex2 {
border-left: 0;
- margin-left: 0px;
- margin: 0px 0;
+ margin: 0;
line-height: 70%;
font-size: small;
- }
\ No newline at end of file
+ }
+#navSite ul.section, #navSite ul.section li {
+ padding: 0;
+ margin: 0;
+ border: 0;
+ line-height: 1.2em;
+ }
+ */
\ No newline at end of file
Modified: trunk/webdocs.xml
===================================================================
--- trunk/webdocs.xml 2007-05-10 21:11:30 UTC (rev 267)
+++ trunk/webdocs.xml 2007-05-11 10:07:31 UTC (rev 268)
@@ -190,7 +190,7 @@
<replacevalue><![CDATA[
<div id="footer">
- Copyright 2006-2007 The Mulgara Project. Some rights reserved. <a href="/overview/legal.html">MORE</a>>>
+ Copyright 2006-2007 The Mulgara Project. Some rights reserved. <a href="/overview/legal.html">MORE ></a>
</div>
<div id="validator">
<a href="http://validator.w3.org/check?uri=referer"><img src="/img-layout/w3xhtml10.gif" alt="Valid XHTML 1.0 Transitional" height="21" width="66" /></a>
@@ -512,50 +512,29 @@
<li><a href="/integration/jsptutorial.html#o995">Deploy the JSPs</a></li>
<li><a href="/integration/jsptutorial.html#o996">Open the Application</a></li>
</ul></li>
- <li><a href="/jrdf/jrdftutorial.html">JRDF Tutorial</a></li>
- @@jrdfTOC@@
- </ul></li>]]></replacevalue>
+ <li><a href="/integration/jrdftutorial.html">JRDF Tutorial</a></li>
+ <li class="ulcontainer"><ul>
+ <li><a href="/integration/jrdfprereq.html">Prerequisites</a></li>
+ <li class="ulcontainer toc"><ul class="toc">
+ <li><a href="/integration/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></li>
+ <li><a href="/integration/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></li>
+ </ul></li>
+ <li><a href="/integration/jrdfcreategraph.html">Creating the Graph</a></li>
+ <li class="ulcontainer toc"><ul class="toc">
+ <li><a href="/integration/jrdfcreategraph.html#o2901">JRDF Graph (Memory Graph)</a></li>
+ <li><a href="/integration/jrdfcreategraph.html#o3189">Server-side JRDF Graph (Server Graph)</a></li>
+ <li><a href="/integration/jrdfcreategraph.html#o2902">Server Backed JRDF Graph (Client Graph)</a></li>
+ <li><a href="/integration/jrdfcreategraph.html#o2903">Read Only iTQL Result JRDF Graph (iTQL Graph)</a></li>
+ </ul></li>
+ <li><a href="/integration/jrdfcreatenodes.html">Creating Nodes and Triples</a></li>
+ <li><a href="/integration/jrdfaddtriples.html">Adding Triples<span class="toc"> to the Graph</span></a></li>
+ <li><a href="/integration/searchgraph.html">Searching the Graph</a></li>
+ <li><a href="/integration/jrdfreify.html">Reify Triples</a></li>
+ <li><a href="/integration/jrdfremove.html">Removing Triples<span class="toc"> from the Graph</span></a></li>
+ </ul></li>
+ </ul></li>]]></replacevalue>
</replace>
-
-
- <replace dir="${src.docs.dir}" token="@@jrdfTOC@@" value="">
- <exclude name="jrdf/*.html"/>
- <exclude name="toc.html"/>
- </replace>
-
- <replace dir="${src.docs.dir}" token="@@jrdfTOC@@">
- <include name="jrdf/*.html"/>
- <include name="toc.html"/>
- <replacevalue><![CDATA[ <li class="ulcontainer"><ul>
- <li><a href="/jrdf/jrdfprereq.html">Prerequisites</a></li>
- <li class="ulcontainer toc"><ul class="toc">
- <li><a href="/jrdf/jrdfprereq.html#o2898">Obtaining a Session from a Mulgara Server</a></li>
- <li><a href="/jrdf/jrdfprereq.html#o2899">Comparison of JRDF Graph Implementations</a></li>
- </ul></li>
- <li><a href="/jrdf/jrdfcreategraph.html">Creating the Graph</a></li>
- <li class="ulcontainer toc"><ul class="toc">
- <li><a href="/jrdf/jrdfcreategraph.html#o2901">JRDF Graph (Memory Graph)</a></li>
- <li><a href="/jrdf/jrdfcreategraph.html#o3189">Server-side JRDF Graph (Server Graph)</a></li>
- <li><a href="/jrdf/jrdfcreategraph.html#o2902">Server Backed JRDF Graph (Client Graph)</a></li>
- <li><a href="/jrdf/jrdfcreategraph.html#o2903">Read Only iTQL Result JRDF Graph (iTQL Graph)</a></li>
- </ul></li>
- <li><a href="/jrdf/jrdfcreatenodes.html">Creating Nodes and Triples</a></li>
- <li><a href="/jrdf/jrdfaddtriples.html">Adding Triples<span class="toc"> to the Graph</span></a></li>
- <li><a href="/jrdf/searchgraph.html">Searching the Graph</a></li>
- <li><a href="/jrdf/jrdfreify.html">Reify Triples</a></li>
- <li><a href="/jrdf/jrdfremove.html">Removing Triples<span class="toc"> from the Graph</span></a></li>
- </ul></li>]]></replacevalue>
- </replace>
-
-
-
-
-
-
-
-
-
<replace dir="${src.docs.dir}" token="@@itqlcommandsTOC@@" value="">
<exclude name="itqlcommands/*.html"/>
<exclude name="toc.html"/>
More information about the Mulgara-svn
mailing list