/// <summary>
/// Saves the Result Set to the given Stream as an XHTML Table with embedded RDFa
/// </summary>
/// <param name="g">Graph to save</param>
/// <param name="output">Stream to save to</param>
public void Save(IGraph g, TextWriter output)
{
try
{
HtmlWriterContext context = new HtmlWriterContext(g, output);
this.GenerateOutput(context);
output.Close();
}
catch
{
try
{
output.Close();
}
catch
{
//No Catch Actions
}
throw;
}
}
/// <summary>
/// Saves the Result Set to the given Stream as an XHTML Table with embedded RDFa
/// </summary>
/// <param name="g">Graph to save</param>
/// <param name="output">Stream to save to</param>
public void Save(IGraph g, TextWriter output)
{
try
{
g.NamespaceMap.Import(this._defaultNamespaces);
HtmlWriterContext context = new HtmlWriterContext(g, output);
this.GenerateOutput(context);
output.Close();
}
catch
{
try
{
output.Close();
}
catch
{
//No Catch Actions
}
throw;
}
}
/// <summary>
/// Generates Output for a given Node
/// </summary>
/// <param name="context">Writer Context</param>
/// <param name="n">Node</param>
/// <param name="t">Triple being written</param>
private void GenerateNodeOutput(HtmlWriterContext context, INode n, Triple t)
{
//Embed RDFa on the Node Output
bool rdfASerializable = false;
if (t != null)
{
if (t.Predicate.NodeType == NodeType.Uri)
{
//Use @about to specify the Subject
if (t.Subject.NodeType == NodeType.Uri)
{
rdfASerializable = true;
context.HtmlWriter.AddAttribute("about", context.UriFormatter.FormatUri(t.Subject.ToString()));
}
else if (t.Subject.NodeType == NodeType.Blank)
{
rdfASerializable = true;
context.HtmlWriter.AddAttribute("about", "[" + t.Subject.ToString() + "]");
}
else
{
this.RaiseWarning("Cannot serialize a Triple since the Subject is not a URI/Blank Node: " + t.Subject.ToString());
}
//Then if we can serialize this Triple we serialize the Predicate
if (rdfASerializable)
{
//Get the CURIE for the Predicate
String curie;
String tempNamespace;
if (context.QNameMapper.ReduceToQName(t.Predicate.ToString(), out curie, out tempNamespace))
{
//Extract the Namespace and make sure it's registered on this Attribute
String ns = curie.Substring(0, curie.IndexOf(':'));
context.HtmlWriter.AddAttribute("xmlns:" + ns, context.UriFormatter.FormatUri(context.QNameMapper.GetNamespaceUri(ns)));
}
else
{
this.RaiseWarning("Cannot serialize a Triple since the Predicate cannot be reduced to a QName: " + t.Predicate.ToString());
rdfASerializable = false;
}
if (rdfASerializable)
{
switch (t.Object.NodeType)
{
case NodeType.Blank:
case NodeType.Uri:
//If the Object is a URI or a Blank then we specify the predicate with @rel
context.HtmlWriter.AddAttribute("rel", curie);
break;
case NodeType.Literal:
//If the Object is a Literal we specify the predicate with @property
context.HtmlWriter.AddAttribute("property", curie);
break;
default:
this.RaiseWarning("Cannot serialize a Triple since the Object is not a URI/Blank/Literal Node: " + t.Object.ToString());
rdfASerializable = false;
break;
}
}
}
}
else
{
this.RaiseWarning("Cannot serialize a Triple since the Predicate is not a URI Node: " + t.Predicate.ToString());
}
}
String qname;
switch (n.NodeType)
{
case NodeType.Blank:
if (rdfASerializable)
{
//Need to embed the CURIE for the BNode in the @resource attribute
context.HtmlWriter.AddAttribute("resource", "[" + n.ToString() + "]");
}
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassBlankNode);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Span);
context.HtmlWriter.WriteEncodedText(n.ToString());
context.HtmlWriter.RenderEndTag();
break;
case NodeType.Literal:
ILiteralNode lit = (ILiteralNode)n;
if (lit.DataType != null)
{
if (rdfASerializable)
{
//Need to embed the datatype in the @datatype attribute
String dtcurie, dtnamespace;
if (context.QNameMapper.ReduceToQName(lit.DataType.ToString(), out dtcurie, out dtnamespace))
{
//Extract the Namespace and make sure it's registered on this Attribute
String ns = dtcurie.Substring(0, dtcurie.IndexOf(':'));
context.HtmlWriter.AddAttribute("xmlns:" + ns, context.UriFormatter.FormatUri(context.QNameMapper.GetNamespaceUri(ns)));
context.HtmlWriter.AddAttribute("datatype", dtcurie);
}
}
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassLiteral);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Span);
if (lit.DataType.ToString().Equals(Parsing.RdfSpecsHelper.RdfXmlLiteral))
{
context.HtmlWriter.Write(lit.Value);
}
else
{
context.HtmlWriter.WriteEncodedText(lit.Value);
}
context.HtmlWriter.RenderEndTag();
//Output the Datatype
context.HtmlWriter.WriteEncodedText("^^");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, lit.DataType.ToString());
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassDatatype);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
if (context.QNameMapper.ReduceToQName(lit.DataType.ToString(), out qname))
{
context.HtmlWriter.WriteEncodedText(qname);
}
else
{
context.HtmlWriter.WriteEncodedText(lit.DataType.ToString());
}
context.HtmlWriter.RenderEndTag();
}
else
{
if (rdfASerializable)
{
if (!lit.Language.Equals(String.Empty))
{
//Need to add the language as an xml:lang attribute
context.HtmlWriter.AddAttribute("xml:lang", lit.Language);
}
}
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassLiteral);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Span);
context.HtmlWriter.WriteEncodedText(lit.Value);
context.HtmlWriter.RenderEndTag();
if (!lit.Language.Equals(String.Empty))
{
context.HtmlWriter.WriteEncodedText("@");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassLangSpec);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Span);
context.HtmlWriter.WriteEncodedText(lit.Language);
context.HtmlWriter.RenderEndTag();
}
}
break;
case NodeType.GraphLiteral:
//Error
throw new RdfOutputException(WriterErrorMessages.GraphLiteralsUnserializable("HTML"));
case NodeType.Uri:
if (rdfASerializable && !this.UriPrefix.Equals(String.Empty))
{
//If the URIs are being prefixed with something then we need to set the original
//URI in the resource attribute to generate the correct triple
context.HtmlWriter.AddAttribute("resource", n.ToString());
}
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, this.UriPrefix + n.ToString());
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
if (context.QNameMapper.ReduceToQName(n.ToString(), out qname))
{
context.HtmlWriter.WriteEncodedText(qname);
}
else
{
context.HtmlWriter.WriteEncodedText(n.ToString());
}
context.HtmlWriter.RenderEndTag();
break;
default:
throw new RdfOutputException(WriterErrorMessages.UnknownNodeTypeUnserializable("HTML"));
}
}
/// <summary>
/// Generates Output for a given Node
/// </summary>
/// <param name="context">Writer Context</param>
/// <param name="n">Node</param>
private void GenerateNodeOutput(HtmlWriterContext context, INode n)
{
this.GenerateNodeOutput(context, n, null);
}
/// <summary>
/// Internal method which generates the HTML Output for the Graph
/// </summary>
/// <param name="context">Writer Context</param>
private void GenerateOutput(HtmlWriterContext context)
{
//Page Header
context.HtmlWriter.Write("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML+RDFa 1.0//EN\" \"http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd\">");
context.HtmlWriter.WriteLine();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Html);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Head);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Title);
context.HtmlWriter.WriteEncodedText("RDF Graph");
if (context.Graph.BaseUri != null)
{
context.HtmlWriter.WriteEncodedText(" - " + context.Graph.BaseUri.ToString());
}
context.HtmlWriter.RenderEndTag();
if (!this.Stylesheet.Equals(String.Empty))
{
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, this.Stylesheet);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Type, "text/css");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Rel, "stylesheet");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Link);
context.HtmlWriter.RenderEndTag();
}
//TODO: Add <meta> for charset?
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Start Body
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Body);
//Title
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H3);
context.HtmlWriter.WriteEncodedText("RDF Graph");
if (context.Graph.BaseUri != null)
{
context.HtmlWriter.WriteEncodedText(" - " + context.Graph.BaseUri.ToString());
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Create a Table for the Graph
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Width, "100%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Table);
//Create a Table Header
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Thead);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Th);
context.HtmlWriter.WriteEncodedText("Subject");
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Th);
context.HtmlWriter.WriteEncodedText("Predicate");
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Th);
context.HtmlWriter.WriteEncodedText("Object");
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Create a Table Body for the Triple
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Tbody);
TripleCollection triplesDone = new TripleCollection();
foreach (INode subj in context.Graph.Triples.SubjectNodes)
{
IEnumerable<Triple> ts = context.Graph.GetTriplesWithSubject(subj);
//Start a Row
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Valign, "top");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
//Then a Column for the Subject which spans the correct number of Rows
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Rowspan, ts.Count().ToString());
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Td);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//For each Subject add an anchor if it can be reduced to a QName
if (subj.NodeType == NodeType.Uri)
{
String qname;
if (context.QNameMapper.ReduceToQName(subj.ToString(), out qname))
{
if (!qname.EndsWith(":"))
{
qname = qname.Substring(qname.IndexOf(':') + 1);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Name, qname);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.RenderEndTag();
}
}
}
this.GenerateNodeOutput(context, subj);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
bool firstPred = true;
foreach (Triple t in ts)
{
if (triplesDone.Contains(t)) continue;
if (!firstPred)
{
//If not the first Triple start a new row
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Valign, "top");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
}
//Then a Column for the Predicate
IEnumerable<Triple> predTriples = context.Graph.GetTriplesWithSubjectPredicate(t.Subject, t.Predicate);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Rowspan, predTriples.Count().ToString());
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Td);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
this.GenerateNodeOutput(context, t.Predicate);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Then we write out all the Objects
bool firstObj = true;
foreach (Triple predTriple in predTriples)
{
if (triplesDone.Contains(predTriple)) continue;
if (!firstObj)
{
//If not the first Triple start a new row
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Valign, "top");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
}
//Object Column
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Td);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
this.GenerateNodeOutput(context, predTriple.Object, predTriple);
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//End of Row
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
firstObj = false;
triplesDone.Add(predTriple);
}
firstPred = false;
}
}
//End Table Body
context.HtmlWriter.RenderEndTag();
//End Table
context.HtmlWriter.RenderEndTag();
//End of Page
context.HtmlWriter.RenderEndTag(); //End Body
context.HtmlWriter.RenderEndTag(); //End Html
}
/// <summary>
/// Internal method which generates the HTML Output for the Graph
/// </summary>
/// <param name="context">Writer Context</param>
private void GenerateOutput(HtmlWriterContext context)
{
Object results;
//Add the Namespaces we want to use later on
context.QNameMapper.AddNamespace("owl", new Uri(NamespaceMapper.OWL));
context.QNameMapper.AddNamespace("rdf", new Uri(NamespaceMapper.RDF));
context.QNameMapper.AddNamespace("rdfs", new Uri(NamespaceMapper.RDFS));
context.QNameMapper.AddNamespace("dc", new Uri("http://purl.org/dc/elements/1.1/"));
context.QNameMapper.AddNamespace("dct", new Uri("http://purl.org/dc/terms/"));
context.QNameMapper.AddNamespace("vann", new Uri("http://purl.org/vocab/vann/"));
context.QNameMapper.AddNamespace("vs", new Uri("http://www.w3.org/2003/06/sw-vocab-status/ns#"));
//Find the Node that represents the Schema Ontology
//Assumes there is exactly one thing given rdf:type owl:Ontology
IUriNode ontology = context.Graph.CreateUriNode(new Uri(NamespaceMapper.OWL + "Ontology"));
IUriNode rdfType = context.Graph.CreateUriNode(new Uri(RdfSpecsHelper.RdfType));
IUriNode rdfsLabel = context.Graph.CreateUriNode(new Uri(NamespaceMapper.RDFS + "label"));
INode ontoNode = context.Graph.GetTriplesWithPredicateObject(rdfType, ontology).Select(t => t.Subject).FirstOrDefault();
INode ontoLabel = (ontoNode != null) ? context.Graph.GetTriplesWithSubjectPredicate(ontoNode, rdfsLabel).Select(t => t.Object).FirstOrDefault() : null;
//Stuff for formatting
//We'll use the Turtle Formatter to get nice QNames wherever possible
context.NodeFormatter = new TurtleFormatter(context.QNameMapper);
context.UriFormatter = (IUriFormatter)context.NodeFormatter;
//Page Header
context.HtmlWriter.Write("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML+RDFa 1.0//EN\" \"http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd\">");
context.HtmlWriter.WriteLine();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Html);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Head);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Title);
context.HtmlWriter.WriteEncodedText("Schema");
if (ontoNode != null && ontoLabel != null)
{
context.HtmlWriter.WriteEncodedText(" - " + ontoLabel.ToSafeString());
}
else if (context.Graph.BaseUri != null)
{
context.HtmlWriter.WriteEncodedText(" - " + context.Graph.BaseUri.ToString());
}
context.HtmlWriter.RenderEndTag();
if (!this.Stylesheet.Equals(String.Empty))
{
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, this.Stylesheet);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Type, "text/css");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Rel, "stylesheet");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Link);
context.HtmlWriter.RenderEndTag();
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Start Body
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Body);
//Title
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H2);
context.HtmlWriter.WriteEncodedText("Schema");
if (ontoNode != null && ontoLabel != null)
{
context.HtmlWriter.WriteEncodedText(" - " + ontoLabel.ToSafeString());
}
else if (context.Graph.BaseUri != null)
{
context.HtmlWriter.WriteEncodedText(" - " + context.Graph.BaseUri.ToString());
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Show the Description of the Schema (if any)
if (ontoNode != null)
{
SparqlParameterizedString getOntoDescrip = new SparqlParameterizedString();
getOntoDescrip.Namespaces = context.QNameMapper;
getOntoDescrip.CommandText = "SELECT * WHERE { @onto a owl:Ontology . OPTIONAL { @onto rdfs:comment ?description } . OPTIONAL { @onto vann:preferredNamespacePrefix ?nsPrefix ; vann:preferredNamespaceUri ?nsUri } . OPTIONAL { @onto dc:creator ?creator . ?creator (foaf:name | rdfs:label) ?creatorName } }";
getOntoDescrip.SetParameter("onto", ontoNode);
try
{
results = context.Graph.ExecuteQuery(getOntoDescrip);
if (results is SparqlResultSet)
{
if (!((SparqlResultSet)results).IsEmpty)
{
SparqlResult ontoInfo = ((SparqlResultSet)results)[0];
//Show rdfs:comment on the Ontology
if (ontoInfo.HasValue("description"))
{
INode descrip = ontoInfo["description"];
if (descrip.NodeType == NodeType.Literal)
{
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.Write(((ILiteralNode)descrip).Value);
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
//Show Author Information
if (ontoInfo.HasValue("creator"))
{
INode author = ontoInfo["creator"];
INode authorName = ontoInfo["creatorName"];
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Em);
context.HtmlWriter.WriteEncodedText("Schema created by ");
if (author.NodeType == NodeType.Uri)
{
context.HtmlWriter.AddAttribute("href", ((IUriNode)author).Uri.ToString());
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
}
switch (authorName.NodeType)
{
case NodeType.Uri:
context.HtmlWriter.WriteEncodedText(((IUriNode)authorName).Uri.ToString());
break;
case NodeType.Literal:
context.HtmlWriter.WriteEncodedText(((ILiteralNode)authorName).Value);
break;
default:
context.HtmlWriter.WriteEncodedText(authorName.ToString());
break;
}
if (author.NodeType == NodeType.Uri) context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
//Show the Namespace information for the Schema
if (ontoInfo.HasValue("nsPrefix"))
{
if (ontoInfo["nsPrefix"].NodeType == NodeType.Literal && ontoInfo["nsUri"].NodeType == NodeType.Uri)
{
//Add this QName to the QName Mapper so we can get nice QNames later on
String prefix = ((ILiteralNode)ontoInfo["nsPrefix"]).Value;
context.QNameMapper.AddNamespace(prefix, ((IUriNode)ontoInfo["nsUri"]).Uri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H4);
context.HtmlWriter.WriteEncodedText("Preferred Namespace Definition");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Show human readable description of preferred Namespace Settings
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.WriteEncodedText("Preferred Namespace Prefix is ");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Strong);
context.HtmlWriter.WriteEncodedText(prefix);
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.WriteEncodedText(" and preferred Namespace URI is ");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, context.QNameMapper.GetNamespaceUri(prefix).ToString());
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.WriteEncodedText(context.QNameMapper.GetNamespaceUri(prefix).ToString());
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.RenderEndTag();
//RDF/XML Syntax
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H5);
context.HtmlWriter.WriteEncodedText("RDF/XML Syntax");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.AddStyleAttribute(HtmlTextWriterStyle.Width, "90%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Pre);
context.HtmlWriter.WriteEncodedText("<?xml version=\"1.0\" charset=\"utf-8\"?>");
context.HtmlWriter.WriteLine();
context.HtmlWriter.WriteEncodedText("<rdf:RDF xmlns:rdf=\"" + NamespaceMapper.RDF + "\" xmlns:" + prefix + "=\"" + context.UriFormatter.FormatUri(context.QNameMapper.GetNamespaceUri(prefix)) + "\">");
context.HtmlWriter.WriteLine();
context.HtmlWriter.WriteEncodedText(" <!-- Your RDF here... -->");
context.HtmlWriter.WriteLine();
context.HtmlWriter.WriteEncodedText("</rdf:RDF>");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Turtle/N3 Syntax
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H5);
context.HtmlWriter.WriteEncodedText("Turtle/N3 Syntax");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.AddStyleAttribute(HtmlTextWriterStyle.Width, "90%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Pre);
context.HtmlWriter.WriteEncodedText("@prefix " + prefix + ": <" + context.UriFormatter.FormatUri(context.QNameMapper.GetNamespaceUri(prefix)) + "> .");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//SPARQL Syntax
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H5);
context.HtmlWriter.WriteEncodedText("SPARQL Syntax");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.AddStyleAttribute(HtmlTextWriterStyle.Width, "90%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Pre);
context.HtmlWriter.WriteEncodedText("PREFIX " + prefix + ": <" + context.UriFormatter.FormatUri(context.QNameMapper.GetNamespaceUri(prefix)) + ">");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
}
}
else
{
throw new RdfOutputException("Tried to make a SPARQL Query to determine Schema Information but an unexpected Query Result was returned");
}
}
catch (RdfQueryException queryEx)
{
throw new RdfOutputException("Tried to make a SPARQL Query to determine Schema Information but a Query Error occurred", queryEx);
}
}
//Show lists of all Classes and Properties in the Schema
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H4);
context.HtmlWriter.WriteEncodedText("Class and Property Summary");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.WriteEncodedText("This Schema defines the following classes:");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.AddStyleAttribute("width", "90%");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassBox);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
//Get the Classes and Display
SparqlParameterizedString getClasses = new SparqlParameterizedString();
getClasses.Namespaces = context.QNameMapper;
getClasses.CommandText = "SELECT DISTINCT ?class WHERE { { ?class a rdfs:Class } UNION { ?class a owl:Class } FILTER(ISURI(?class)) } ORDER BY ?class";
try
{
results = context.Graph.ExecuteQuery(getClasses);
if (results is SparqlResultSet)
{
SparqlResultSet rs = (SparqlResultSet)results;
for (int i = 0; i < rs.Count; i++)
{
SparqlResult r = rs[i];
//Get the QName and output a Link to an anchor that we'll generate later to let
//users jump to a Class/Property definition
String qname = context.NodeFormatter.Format(r["class"]);
context.HtmlWriter.AddAttribute("href", "#" + qname);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.WriteEncodedText(qname);
context.HtmlWriter.RenderEndTag();
if (i < rs.Count - 1)
{
context.HtmlWriter.WriteEncodedText(" , ");
}
}
}
else
{
throw new RdfOutputException("Tried to make a SPARQL Query to find Classes in the Schema but an unexpected Query Result was returned");
}
}
catch (RdfQueryException queryEx)
{
throw new RdfOutputException("Tried to make a SPARQL Query to find Classes in the Schema but a Query Error occurred", queryEx);
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.WriteEncodedText("This Schema defines the following properties:");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
context.HtmlWriter.AddStyleAttribute("width", "90%");
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassBox);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
//Get the Properties and Display
SparqlParameterizedString getProperties = new SparqlParameterizedString();
getProperties.Namespaces = context.QNameMapper;
getProperties.CommandText = "SELECT DISTINCT ?property WHERE { { ?property a rdf:Property } UNION { ?property a owl:DatatypeProperty } UNION { ?property a owl:ObjectProperty } FILTER(ISURI(?property)) } ORDER BY ?property";
try
{
results = context.Graph.ExecuteQuery(getProperties);
if (results is SparqlResultSet)
{
SparqlResultSet rs = (SparqlResultSet)results;
for (int i = 0; i < rs.Count; i++)
{
SparqlResult r = rs[i];
//Get the QName and output a Link to an anchor that we'll generate later to let
//users jump to a Class/Property definition
String qname = context.NodeFormatter.Format(r["property"]);
context.HtmlWriter.AddAttribute("href", "#" + qname);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.WriteEncodedText(qname);
context.HtmlWriter.RenderEndTag();
if (i < rs.Count - 1)
{
context.HtmlWriter.WriteEncodedText(" , ");
}
}
}
else
{
throw new RdfOutputException("Tried to make a SPARQL Query to find Properties in the Schema but an unexpected Query Result was returned");
}
}
catch (RdfQueryException queryEx)
{
throw new RdfOutputException("Tried to make a SPARQL Query to find Properties in the Schema but a Query Error occurred", queryEx);
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Show details for each class
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H3);
context.HtmlWriter.WriteEncodedText("Classes");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Now create the URI Nodes we need for the next stage of Output
IUriNode rdfsDomain = context.Graph.CreateUriNode(new Uri(NamespaceMapper.RDFS + "domain"));
IUriNode rdfsRange = context.Graph.CreateUriNode(new Uri(NamespaceMapper.RDFS + "range"));
IUriNode rdfsSubClassOf = context.Graph.CreateUriNode(new Uri(NamespaceMapper.RDFS + "subClassOf"));
IUriNode rdfsSubPropertyOf = context.Graph.CreateUriNode(new Uri(NamespaceMapper.RDFS + "subPropertyOf"));
IUriNode owlDisjointClass = context.Graph.CreateUriNode(new Uri(NamespaceMapper.OWL + "disjointWith"));
IUriNode owlEquivalentClass = context.Graph.CreateUriNode(new Uri(NamespaceMapper.OWL + "equivalentClass"));
IUriNode owlEquivalentProperty = context.Graph.CreateUriNode(new Uri(NamespaceMapper.OWL + "equivalentProperty"));
IUriNode owlInverseProperty = context.Graph.CreateUriNode(new Uri(NamespaceMapper.OWL + "inverseOf"));
//Alter our previous getClasses query to get additional details
getClasses.CommandText = "SELECT ?class (SAMPLE(?label) AS ?classLabel) (SAMPLE(?description) AS ?classDescription) WHERE { { ?class a rdfs:Class } UNION { ?class a owl:Class } FILTER(ISURI(?class)) OPTIONAL { ?class rdfs:label ?label } OPTIONAL { ?class rdfs:comment ?description } } GROUP BY ?class ORDER BY ?class";
try
{
results = context.Graph.ExecuteQuery(getClasses);
if (results is SparqlResultSet)
{
foreach (SparqlResult r in (SparqlResultSet)results)
{
String qname = context.NodeFormatter.Format(r["class"]);
//Use a <div> for each Class
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassBox);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Div);
//Add the Anchor to which earlier Class summary links to
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Name, qname);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.RenderEndTag();
//Show Basic Class Information
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H4);
context.HtmlWriter.WriteEncodedText("Class: " + qname);
context.HtmlWriter.RenderEndTag();
//Show "Local Name - Label"
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Em);
if (TurtleSpecsHelper.IsValidQName(qname))
{
context.HtmlWriter.WriteEncodedText(qname);
}
else
{
Uri temp = new Uri(qname, UriKind.RelativeOrAbsolute);
if (!temp.Fragment.Equals(String.Empty))
{
context.HtmlWriter.WriteEncodedText(temp.Fragment);
}
else
{
#if !SILVERLIGHT
context.HtmlWriter.WriteEncodedText(temp.Segments.Last());
#else
context.HtmlWriter.WriteEncodedText(temp.Segments().Last());
#endif
}
}
context.HtmlWriter.RenderEndTag();
if (r.HasValue("classLabel"))
{
if (r["classLabel"] != null && r["classLabel"].NodeType == NodeType.Literal)
{
context.HtmlWriter.WriteEncodedText(" - ");
context.HtmlWriter.WriteEncodedText(((ILiteralNode)r["classLabel"]).Value);
}
}
context.HtmlWriter.WriteLine();
context.HtmlWriter.WriteBreak();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Output further information about the class
IEnumerable<Triple> ts;
//Output any Subclasses
ts = context.Graph.GetTriplesWithSubjectPredicate(rdfsSubClassOf, r["class"]);
this.GenerateCaptionedInformation(context, "Has Sub Classes", ts, t => t.Object);
//Output Properties which have this as domain/range
ts = context.Graph.GetTriplesWithPredicateObject(rdfsDomain, r["class"]);
this.GenerateCaptionedInformation(context, "Properties Include", ts, t => t.Subject);
ts = context.Graph.GetTriplesWithPredicateObject(rdfsRange, r["class"]);
this.GenerateCaptionedInformation(context, "Used With", ts, t => t.Subject);
//Output any Equivalent Classes
ts = context.Graph.GetTriplesWithSubjectPredicate(r["class"], owlEquivalentClass).Concat(context.Graph.GetTriplesWithPredicateObject(owlEquivalentClass, r["class"]));
this.GenerateCaptionedInformation(context, "Equivalent Classes", ts, t => t.Subject.Equals(r["class"]) ? t.Object : t.Subject);
//Output any Disjoint Classes
ts = context.Graph.GetTriplesWithSubjectPredicate(r["class"], owlDisjointClass).Concat(context.Graph.GetTriplesWithPredicateObject(owlDisjointClass, r["class"]));
this.GenerateCaptionedInformation(context, "Disjoint Classes", ts, t => t.Subject.Equals(r["class"]) ? t.Object : t.Subject);
//Show the Class Description
if (r.HasValue("classDescription"))
{
if (r["classDescription"] != null && r["classDescription"].NodeType == NodeType.Literal)
{
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.Write(((ILiteralNode)r["classDescription"]).Value);
context.HtmlWriter.RenderEndTag();
}
}
//End the </div> for the Class
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
else
{
throw new RdfOutputException("Tried to make a SPARQL Query to get Class Information from the Schema but an unexpected Query Result was returned");
}
}
catch (RdfQueryException queryEx)
{
throw new RdfOutputException("Tried to make a SPARQL Query to get Class Information from the Schema but a Query Error occurred", queryEx);
}
//Show details for each property
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H3);
context.HtmlWriter.WriteEncodedText("Properties");
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Alter our previous getClasses query to get additional details
getProperties.CommandText = "SELECT ?property (SAMPLE(?label) AS ?propertyLabel) (SAMPLE(?description) AS ?propertyDescription) WHERE { { ?property a rdf:Property } UNION { ?property a owl:ObjectProperty } UNION { ?property a owl:DatatypeProperty } FILTER(ISURI(?property)) OPTIONAL { ?property rdfs:label ?label } OPTIONAL { ?property rdfs:comment ?description } } GROUP BY ?property ORDER BY ?property";
try
{
results = context.Graph.ExecuteQuery(getProperties);
if (results is SparqlResultSet)
{
foreach (SparqlResult r in (SparqlResultSet)results)
{
String qname = context.NodeFormatter.Format(r["property"]);
//Use a <div> for each Property
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassBox);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Div);
//Add the Anchor to which earlier Property summary links to
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Name, qname);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.RenderEndTag();
//Show Basic Property Information
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.H4);
context.HtmlWriter.WriteEncodedText("Property: " + qname);
context.HtmlWriter.RenderEndTag();
//Show "Local Name - Label"
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Em);
if (TurtleSpecsHelper.IsValidQName(qname))
{
context.HtmlWriter.WriteEncodedText(qname);
}
else
{
Uri temp = new Uri(qname, UriKind.RelativeOrAbsolute);
if (!temp.Fragment.Equals(String.Empty))
{
context.HtmlWriter.WriteEncodedText(temp.Fragment);
}
else
{
#if !SILVERLIGHT
context.HtmlWriter.WriteEncodedText(temp.Segments.Last());
#else
context.HtmlWriter.WriteEncodedText(temp.Segments().Last());
#endif
}
}
context.HtmlWriter.RenderEndTag();
if (r.HasValue("propertyLabel"))
{
if (r["propertyLabel"] != null && r["propertyLabel"].NodeType == NodeType.Literal)
{
context.HtmlWriter.WriteEncodedText(" - ");
context.HtmlWriter.WriteEncodedText(((ILiteralNode)r["propertyLabel"]).Value);
}
}
context.HtmlWriter.WriteLine();
context.HtmlWriter.WriteBreak();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
//Output further information about the property
IEnumerable<Triple> ts;
//Output any Subproperties
ts = context.Graph.GetTriplesWithSubjectPredicate(rdfsSubPropertyOf, r["property"]);
this.GenerateCaptionedInformation(context, "Has Sub Properties", ts, t => t.Object);
//Output Domain and Range
ts = context.Graph.GetTriplesWithSubjectPredicate(r["property"], rdfsDomain);
this.GenerateCaptionedInformation(context, "Has Domain", ts, t => t.Object);
ts = context.Graph.GetTriplesWithSubjectPredicate(r["property"], rdfsRange);
this.GenerateCaptionedInformation(context, "Has Range", ts, t => t.Object);
//Output any Equivalent Properties
ts = context.Graph.GetTriplesWithSubjectPredicate(r["property"], owlEquivalentProperty).Concat(context.Graph.GetTriplesWithPredicateObject(owlEquivalentProperty, r["property"]));
this.GenerateCaptionedInformation(context, "Equivalent Properties", ts, t => t.Subject.Equals(r["property"]) ? t.Object : t.Subject);
//Output any Disjoint Classes
ts = context.Graph.GetTriplesWithSubjectPredicate(r["property"], owlInverseProperty).Concat(context.Graph.GetTriplesWithPredicateObject(owlInverseProperty, r["property"]));
this.GenerateCaptionedInformation(context, "Inverse Property", ts, t => t.Subject.Equals(r["property"]) ? t.Object : t.Subject);
//Show the Property Description
if (r.HasValue("propertyDescription"))
{
if (r["propertyDescription"] != null && r["propertyDescription"].NodeType == NodeType.Literal)
{
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.Write(((ILiteralNode)r["propertyDescription"]).Value);
context.HtmlWriter.RenderEndTag();
}
}
//End the </div> for the Property
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
else
{
throw new RdfOutputException("Tried to make a SPARQL Query to get Property Information from the Schema but an unexpected Query Result was returned");
}
}
catch (RdfQueryException queryEx)
{
throw new RdfOutputException("Tried to make a SPARQL Query to get Property Information from the Schema but a Query Error occurred", queryEx);
}
//End of Page
context.HtmlWriter.RenderEndTag(); //End Body
context.HtmlWriter.RenderEndTag(); //End Html
}
private void GenerateCaptionedInformation(HtmlWriterContext context, String caption, IEnumerable<Triple> ts, Func<Triple,INode> displaySelector)
{
if (ts.Any())
{
context.HtmlWriter.AddStyleAttribute("width", "90%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.WriteLine();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Strong);
context.HtmlWriter.WriteEncodedText(caption + ": ");
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.WriteLine();
foreach (Triple t in ts.OrderBy(displaySelector))
{
String qname = context.NodeFormatter.Format(displaySelector(t));
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, "#" + qname);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.WriteEncodedText(qname);
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.Write(' ');
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
private void GenerateCaptionedInformation(HtmlWriterContext context, String caption, IEnumerable<INode> ns)
{
if (ns.Any())
{
context.HtmlWriter.AddStyleAttribute("width", "90%");
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.P);
context.HtmlWriter.WriteLine();
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.Strong);
context.HtmlWriter.WriteEncodedText(caption + ": ");
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.WriteLine();
foreach (INode n in ns.OrderBy(x => x))
{
String qname = context.NodeFormatter.Format(n);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Href, "#" + qname);
context.HtmlWriter.AddAttribute(HtmlTextWriterAttribute.Class, this.CssClassUri);
context.HtmlWriter.RenderBeginTag(HtmlTextWriterTag.A);
context.HtmlWriter.WriteEncodedText(qname);
context.HtmlWriter.RenderEndTag();
context.HtmlWriter.Write(' ');
}
context.HtmlWriter.RenderEndTag();
#if !NO_WEB
context.HtmlWriter.WriteLine();
#endif
}
}
private void GenerateCaptionedInformation(HtmlWriterContext context, String caption, SparqlResultSet results, String var)
{
if (results == null) return;
this.GenerateCaptionedInformation(context, caption, results.Select(r => r[var]).Where(n => n != null));
}
private void GenerateCaptionedInformation(HtmlWriterContext context, String caption, IEnumerable<Triple> ts, Func<Triple,INode> displaySelector)
{
this.GenerateCaptionedInformation(context, caption, ts.Select(t => displaySelector(t)));
}
