All Downloads are FREE. Search and download functionalities are using the official Maven repository.

uk.ac.manchester.owl.owlapi.tutorialowled2011.OWLTutorialSyntaxObjectRenderer Maven / Gradle / Ivy

There is a newer version: 5.5.0
Show newest version
/* This file is part of the OWL API.
 * The contents of this file are subject to the LGPL License, Version 3.0.
 * Copyright 2014, The University of Manchester
 * 
 * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License along with this program.  If not, see http://www.gnu.org/licenses/.
 *
 * Alternatively, the contents of this file may be used under the terms of the Apache License, Version 2.0 in which case, the provisions of the Apache License Version 2.0 are applicable instead of those above.
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */
package uk.ac.manchester.owl.owlapi.tutorialowled2011;

import java.io.IOException;
import java.io.Writer;
import java.util.Collection;
import java.util.Iterator;

import javax.annotation.Nonnull;

import org.semanticweb.owlapi.model.IRI;
import org.semanticweb.owlapi.model.OWLAsymmetricObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLAxiom;
import org.semanticweb.owlapi.model.OWLCardinalityRestriction;
import org.semanticweb.owlapi.model.OWLClass;
import org.semanticweb.owlapi.model.OWLClassAssertionAxiom;
import org.semanticweb.owlapi.model.OWLDataAllValuesFrom;
import org.semanticweb.owlapi.model.OWLDataComplementOf;
import org.semanticweb.owlapi.model.OWLDataExactCardinality;
import org.semanticweb.owlapi.model.OWLDataHasValue;
import org.semanticweb.owlapi.model.OWLDataMaxCardinality;
import org.semanticweb.owlapi.model.OWLDataMinCardinality;
import org.semanticweb.owlapi.model.OWLDataOneOf;
import org.semanticweb.owlapi.model.OWLDataProperty;
import org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom;
import org.semanticweb.owlapi.model.OWLDataPropertyDomainAxiom;
import org.semanticweb.owlapi.model.OWLDataPropertyRangeAxiom;
import org.semanticweb.owlapi.model.OWLDataSomeValuesFrom;
import org.semanticweb.owlapi.model.OWLDatatype;
import org.semanticweb.owlapi.model.OWLDatatypeRestriction;
import org.semanticweb.owlapi.model.OWLDeclarationAxiom;
import org.semanticweb.owlapi.model.OWLDifferentIndividualsAxiom;
import org.semanticweb.owlapi.model.OWLDisjointClassesAxiom;
import org.semanticweb.owlapi.model.OWLDisjointDataPropertiesAxiom;
import org.semanticweb.owlapi.model.OWLDisjointObjectPropertiesAxiom;
import org.semanticweb.owlapi.model.OWLDisjointUnionAxiom;
import org.semanticweb.owlapi.model.OWLEntity;
import org.semanticweb.owlapi.model.OWLEquivalentClassesAxiom;
import org.semanticweb.owlapi.model.OWLEquivalentDataPropertiesAxiom;
import org.semanticweb.owlapi.model.OWLEquivalentObjectPropertiesAxiom;
import org.semanticweb.owlapi.model.OWLFacetRestriction;
import org.semanticweb.owlapi.model.OWLFunctionalDataPropertyAxiom;
import org.semanticweb.owlapi.model.OWLFunctionalObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLImportsDeclaration;
import org.semanticweb.owlapi.model.OWLInverseFunctionalObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLInverseObjectPropertiesAxiom;
import org.semanticweb.owlapi.model.OWLIrreflexiveObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLLiteral;
import org.semanticweb.owlapi.model.OWLNamedIndividual;
import org.semanticweb.owlapi.model.OWLNegativeDataPropertyAssertionAxiom;
import org.semanticweb.owlapi.model.OWLNegativeObjectPropertyAssertionAxiom;
import org.semanticweb.owlapi.model.OWLObject;
import org.semanticweb.owlapi.model.OWLObjectAllValuesFrom;
import org.semanticweb.owlapi.model.OWLObjectComplementOf;
import org.semanticweb.owlapi.model.OWLObjectExactCardinality;
import org.semanticweb.owlapi.model.OWLObjectHasSelf;
import org.semanticweb.owlapi.model.OWLObjectHasValue;
import org.semanticweb.owlapi.model.OWLObjectIntersectionOf;
import org.semanticweb.owlapi.model.OWLObjectInverseOf;
import org.semanticweb.owlapi.model.OWLObjectMaxCardinality;
import org.semanticweb.owlapi.model.OWLObjectMinCardinality;
import org.semanticweb.owlapi.model.OWLObjectOneOf;
import org.semanticweb.owlapi.model.OWLObjectProperty;
import org.semanticweb.owlapi.model.OWLObjectPropertyAssertionAxiom;
import org.semanticweb.owlapi.model.OWLObjectPropertyDomainAxiom;
import org.semanticweb.owlapi.model.OWLObjectPropertyRangeAxiom;
import org.semanticweb.owlapi.model.OWLObjectSomeValuesFrom;
import org.semanticweb.owlapi.model.OWLObjectUnionOf;
import org.semanticweb.owlapi.model.OWLOntology;
import org.semanticweb.owlapi.model.OWLPropertyExpression;
import org.semanticweb.owlapi.model.OWLQuantifiedDataRestriction;
import org.semanticweb.owlapi.model.OWLQuantifiedObjectRestriction;
import org.semanticweb.owlapi.model.OWLReflexiveObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLRuntimeException;
import org.semanticweb.owlapi.model.OWLSameIndividualAxiom;
import org.semanticweb.owlapi.model.OWLSubClassOfAxiom;
import org.semanticweb.owlapi.model.OWLSubDataPropertyOfAxiom;
import org.semanticweb.owlapi.model.OWLSubObjectPropertyOfAxiom;
import org.semanticweb.owlapi.model.OWLSubPropertyChainOfAxiom;
import org.semanticweb.owlapi.model.OWLSymmetricObjectPropertyAxiom;
import org.semanticweb.owlapi.model.OWLTransitiveObjectPropertyAxiom;
import org.semanticweb.owlapi.model.SWRLRule;
import org.semanticweb.owlapi.util.OWLObjectVisitorAdapter;
import org.semanticweb.owlapi.util.QNameShortFormProvider;
import org.semanticweb.owlapi.util.ShortFormProvider;

/**
 * A renderer that provides an HTML version of the ontology.
 * 
 * @author Sean Bechhofer, The University Of Manchester, Information Management
 *         Group
 * @since 2.0.0
 */
@SuppressWarnings({ "javadoc", "null" })
public class OWLTutorialSyntaxObjectRenderer extends OWLObjectVisitorAdapter {

    @Nonnull
    private final ShortFormProvider shortForms;
    private final Writer writer;
    private int pos;
    int lastNewLinePos;
    private static final boolean TABLES = true;
    private static final int TABLE_COLUMNS = 3;

    @Nonnull
    public String labelFor(@Nonnull OWLEntity entity) {
        return shortForms.getShortForm(entity);
    }

    public OWLTutorialSyntaxObjectRenderer(Writer writer) {
        this.writer = writer;
        shortForms = new QNameShortFormProvider();
    }

    private void write(@Nonnull String s) {
        try {
            int newLineIndex = s.indexOf('\n');
            if (newLineIndex != -1) {
                lastNewLinePos = pos + newLineIndex;
            }
            pos += s.length();
            writer.write(s);
        } catch (IOException e) {
            throw new OWLRuntimeException(e);
        }
    }

    private void write(int i) {
        try {
            String s = " " + i + ' ';
            pos += s.length();
            writer.write(s);
        } catch (IOException e) {
            throw new OWLRuntimeException(e);
        }
    }

    private void write(@Nonnull IRI iri) {
        write("<");
        write(iri.toQuotedString());
        write(">");
    }

    public void header() {
        write("\n");
        write("\n");
        write("\n");
        write("\n");
    }

    public void footer() {
        write("\n");
        write("\n");
    }

    private  void writeCollection(
            @Nonnull Collection objects) {
        if (TABLES) {
            writeTable(objects);
        } else {
            writeList(objects);
        }
    }

    private  void
            writeTable(@Nonnull Collection objects) {
        writeTableStart();
        int count = 0;
        for (Iterator it = objects.iterator(); it.hasNext();) {
            if (count % TABLE_COLUMNS == 0) {
                if (count > 0) {
                    writeTableRowEnd();
                }
                writeTableRowStart();
            }
            writeTableCellStart();
            it.next().accept(this);
            writeTableCellEnd();
            count++;
        }
        writeTableRowEnd();
        writeTableEnd();
    }

    private  void
            writeList(@Nonnull Collection objects) {
        writeListStart();
        for (Iterator it = objects.iterator(); it.hasNext();) {
            writeListItemStart();
            it.next().accept(this);
            writeListItemEnd();
        }
        writeListEnd();
    }

    @Override
    public void visit(@Nonnull OWLOntology ontology) {
        header();
        write("

"); write(ontology.getOntologyID().toString()); write("

\n"); write("
"); write("
\n"); for (OWLImportsDeclaration decl : ontology.getImportsDeclarations()) { write("Imports: "); write(decl.getIRI().toString()); write("\n"); } write("

Classes

\n"); writeCollection(ontology.getClassesInSignature()); write("
\n"); write("
\n"); write("

Properties

\n"); writeCollection(ontology.getObjectPropertiesInSignature()); writeCollection(ontology.getDataPropertiesInSignature()); write("
\n"); write("
\n"); write("

Individuals

\n"); writeCollection(ontology.getIndividualsInSignature()); write("
"); write("
"); write("
"); write("

Axioms

\n"); writeListStart(); for (OWLAxiom ax : ontology.getAxioms()) { writeListItemStart(); ax.accept(this); writeListEnd(); } writeListEnd(); write("
"); footer(); } public void write(@Nonnull String str, @Nonnull OWLObject o) { write(str); write("("); o.accept(this); write(")"); } private void write(@Nonnull Collection objects, @Nonnull String separator) { for (Iterator it = objects.iterator(); it .hasNext();) { it.next().accept(this); if (it.hasNext()) { writeSpace(); write(separator); writeSpace(); } } } private void write(@Nonnull Collection objects) { write(objects, ""); } public void writeOpenBracket() { write("("); } public void writeCloseBracket() { write(")"); } public void writeSpace() { write(" "); } public void writeAnnotations(@SuppressWarnings("unused") OWLAxiom ax) { // TODO: IMPLEMENT } public void writeListStart() { write("
    \n"); } public void writeListEnd() { write("
\n"); } public void writeTableStart() { write("\n"); } public void writeTableEnd() { write("
\n"); } public void writeTableRowStart() { write("\n"); } public void writeTableRowEnd() { write("\n"); } public void writeTableCellStart() { write("\n"); } public void writeTableCellEnd() { write("\n"); } public void writeListItemStart() { write("
  • \n"); } public void writeListItemEnd() { write("
  • \n"); } @SuppressWarnings("unused") public void writePropertyCharacteristic(String str, OWLAxiom ax, @Nonnull OWLPropertyExpression prop) { write(keyword(str)); writeSpace(); prop.accept(this); } @Override public void visit(@Nonnull OWLAsymmetricObjectPropertyAxiom axiom) { writePropertyCharacteristic("asymmetric", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLClassAssertionAxiom axiom) { axiom.getIndividual().accept(this); write(keyword(":")); writeSpace(); axiom.getClassExpression().accept(this); } @Override public void visit(@Nonnull OWLDataPropertyAssertionAxiom axiom) { axiom.getSubject().accept(this); writeSpace(); axiom.getProperty().accept(this); writeSpace(); axiom.getObject().accept(this); } @Override public void visit(@Nonnull OWLDataPropertyDomainAxiom axiom) { axiom.getProperty().accept(this); writeSpace(); write(keyword("domain")); writeSpace(); axiom.getDomain().accept(this); } @Override public void visit(@Nonnull OWLDataPropertyRangeAxiom axiom) { axiom.getProperty().accept(this); writeSpace(); write(keyword("range")); writeSpace(); axiom.getRange().accept(this); } @Override public void visit(@Nonnull OWLSubDataPropertyOfAxiom axiom) { axiom.getSubProperty().accept(this); writeSpace(); write(keyword("subProperty")); writeSpace(); axiom.getSuperProperty().accept(this); } @Override public void visit(OWLDeclarationAxiom axiom) {} @Override public void visit(@Nonnull OWLDifferentIndividualsAxiom axiom) { write(axiom.getIndividuals(), keyword("!=")); } @Override public void visit(@Nonnull OWLDisjointClassesAxiom axiom) { write(axiom.getClassExpressions(), keyword("|")); } @Override public void visit(@Nonnull OWLDisjointDataPropertiesAxiom axiom) { write(axiom.getProperties(), keyword("|")); } @Override public void visit(@Nonnull OWLDisjointObjectPropertiesAxiom axiom) { write(keyword("disjoint")); write(axiom.getProperties(), keyword("|")); } @Override public void visit(@Nonnull OWLDisjointUnionAxiom axiom) { axiom.getOWLClass().accept(this); writeSpace(); write(keyword("==")); writeSpace(); write(axiom.getClassExpressions(), keyword("|")); } @Override public void visit(@Nonnull OWLEquivalentClassesAxiom axiom) { write(axiom.getClassExpressions(), keyword("==")); } @Override public void visit(@Nonnull OWLEquivalentDataPropertiesAxiom axiom) { write(axiom.getProperties(), keyword("==")); } @Override public void visit(@Nonnull OWLEquivalentObjectPropertiesAxiom axiom) { write(axiom.getProperties(), keyword("==")); } @Override public void visit(@Nonnull OWLFunctionalDataPropertyAxiom axiom) { writePropertyCharacteristic("functional", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLFunctionalObjectPropertyAxiom axiom) { writePropertyCharacteristic("functional", axiom, axiom.getProperty()); } public void visit(@Nonnull OWLImportsDeclaration axiom) { write(keyword("imports")); write(axiom.getIRI()); } @Override public void visit(@Nonnull OWLInverseFunctionalObjectPropertyAxiom axiom) { writePropertyCharacteristic("inversefunctional", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLInverseObjectPropertiesAxiom axiom) { axiom.getFirstProperty().accept(this); writeSpace(); write(keyword("inverse")); writeSpace(); axiom.getSecondProperty().accept(this); } @Override public void visit(@Nonnull OWLIrreflexiveObjectPropertyAxiom axiom) { writePropertyCharacteristic("Irreflexive", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLNegativeDataPropertyAssertionAxiom axiom) { axiom.getSubject().accept(this); writeSpace(); write(keyword("notvalue")); axiom.getProperty().accept(this); writeSpace(); axiom.getObject().accept(this); } @Override public void visit(@Nonnull OWLNegativeObjectPropertyAssertionAxiom axiom) { axiom.getSubject().accept(this); writeSpace(); write(keyword("notvalue")); axiom.getProperty().accept(this); writeSpace(); axiom.getObject().accept(this); } @Override public void visit(@Nonnull OWLObjectPropertyAssertionAxiom axiom) { axiom.getSubject().accept(this); writeSpace(); axiom.getProperty().accept(this); writeSpace(); axiom.getObject().accept(this); } @Override public void visit(@Nonnull OWLSubPropertyChainOfAxiom axiom) { write("chain"); writeOpenBracket(); write(axiom.getPropertyChain()); writeCloseBracket(); writeSpace(); write(keyword("subProperty")); writeSpace(); axiom.getSuperProperty().accept(this); } @Override public void visit(@Nonnull OWLObjectPropertyDomainAxiom axiom) { axiom.getProperty().accept(this); writeSpace(); write(keyword("domain")); writeSpace(); axiom.getDomain().accept(this); } @Override public void visit(@Nonnull OWLObjectPropertyRangeAxiom axiom) { axiom.getProperty().accept(this); writeSpace(); write(keyword("range")); writeSpace(); axiom.getRange().accept(this); } @Override public void visit(@Nonnull OWLSubObjectPropertyOfAxiom axiom) { axiom.getSubProperty().accept(this); writeSpace(); write(keyword("subProperty")); writeSpace(); axiom.getSuperProperty().accept(this); } @Override public void visit(@Nonnull OWLReflexiveObjectPropertyAxiom axiom) { writePropertyCharacteristic("reflexive", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLSameIndividualAxiom axiom) { write(axiom.getIndividuals(), keyword("=")); } @Override public void visit(@Nonnull OWLSubClassOfAxiom axiom) { axiom.getSubClass().accept(this); writeSpace(); write(keyword("subClass")); writeSpace(); axiom.getSuperClass().accept(this); } @Override public void visit(@Nonnull OWLSymmetricObjectPropertyAxiom axiom) { writePropertyCharacteristic("symmetric", axiom, axiom.getProperty()); } @Override public void visit(@Nonnull OWLTransitiveObjectPropertyAxiom axiom) { writePropertyCharacteristic("transitive", axiom, axiom.getProperty()); } @Override public void visit(OWLClass ce) { write("" + labelFor(ce) + ""); } private void writeRestriction(@Nonnull String str, @Nonnull OWLCardinalityRestriction restriction, @Nonnull OWLPropertyExpression property) { write(str); writeOpenBracket(); write(restriction.getCardinality()); writeSpace(); property.accept(this); if (restriction.isQualified()) { writeSpace(); restriction.getFiller().accept(this); } writeCloseBracket(); } private void writeRestriction(@Nonnull String str, @Nonnull OWLQuantifiedDataRestriction restriction) { writeRestriction(str, restriction.getProperty(), restriction.getFiller()); } private void writeRestriction(@Nonnull String str, @Nonnull OWLQuantifiedObjectRestriction restriction) { writeRestriction(str, restriction.getProperty(), restriction.getFiller()); } private void writeRestriction(@Nonnull String str, @Nonnull OWLPropertyExpression prop, @Nonnull OWLObject filler) { write(str); writeOpenBracket(); prop.accept(this); writeSpace(); filler.accept(this); writeCloseBracket(); } @Override public void visit(OWLDataAllValuesFrom ce) { writeRestriction(operator("only"), ce); } @Override public void visit(@Nonnull OWLDataExactCardinality ce) { writeRestriction("exact", ce, ce.getProperty()); } @Override public void visit(@Nonnull OWLDataMaxCardinality ce) { writeRestriction("atmost", ce, ce.getProperty()); } @Override public void visit(@Nonnull OWLDataMinCardinality ce) { writeRestriction("atleast", ce, ce.getProperty()); } @Override public void visit(OWLDataSomeValuesFrom ce) { writeRestriction(operator("some"), ce); } @Override public void visit(@Nonnull OWLDataHasValue ce) { writeRestriction("has-value", ce.getProperty(), ce.getFiller()); } @Override public void visit(OWLObjectAllValuesFrom ce) { writeRestriction(operator("only"), ce); } @Override public void visit(@Nonnull OWLObjectComplementOf ce) { write(operator("not"), ce.getOperand()); } @Override public void visit(@Nonnull OWLObjectExactCardinality ce) { writeRestriction("exact", ce, ce.getProperty()); } @Override public void visit(@Nonnull OWLObjectIntersectionOf ce) { writeOpenBracket(); write(ce.getOperands(), keyword("and")); writeCloseBracket(); } @Override public void visit(@Nonnull OWLObjectMaxCardinality ce) { writeRestriction("atmost", ce, ce.getProperty()); } @Override public void visit(@Nonnull OWLObjectMinCardinality ce) { writeRestriction("atleast", ce, ce.getProperty()); } @Override public void visit(@Nonnull OWLObjectOneOf ce) { write(operator("one-of")); writeOpenBracket(); write(ce.getIndividuals()); writeCloseBracket(); } @Override public void visit(@Nonnull OWLObjectHasSelf ce) { write("self", ce.getProperty()); } @Override public void visit(OWLObjectSomeValuesFrom ce) { writeRestriction(operator("some"), ce); } @Override public void visit(@Nonnull OWLObjectUnionOf ce) { writeOpenBracket(); write(ce.getOperands(), " or "); writeCloseBracket(); } @Override public void visit(@Nonnull OWLObjectHasValue ce) { writeRestriction("hasValue", ce.getProperty(), ce.getFiller()); } @Override public void visit(@Nonnull OWLDataComplementOf node) { write(operator("not"), node.getDataRange()); } @Override public void visit(@Nonnull OWLDataOneOf node) { write(operator("one-of")); write("("); write(node.getValues()); write(")"); } @Override public void visit(@Nonnull OWLDatatype node) { write("Datatype"); writeOpenBracket(); write(node.getIRI()); writeCloseBracket(); } @Override public void visit(@Nonnull OWLDatatypeRestriction node) { write("DatatypeRestriction"); writeOpenBracket(); node.getDatatype().accept(this); for (OWLFacetRestriction restriction : node.getFacetRestrictions()) { writeSpace(); restriction.accept(this); } writeCloseBracket(); } @Override public void visit(@Nonnull OWLFacetRestriction node) { write(node.getFacet().getIRI()); writeSpace(); node.getFacetValue().accept(this); } @Override public void visit(@Nonnull OWLLiteral node) { write("\""); write(node.getLiteral()); write("\""); if (node.hasLang()) { write("@"); write(node.getLang()); } else { write("^^"); write(node.getDatatype().getIRI()); } } @Override public void visit(OWLDataProperty property) { write("" + labelFor(property) + ""); } @Override public void visit(OWLObjectProperty property) { write("" + labelFor(property) + ""); } @Override public void visit(@Nonnull OWLObjectInverseOf property) { write("inv"); writeOpenBracket(); property.getInverse().accept(this); writeCloseBracket(); } @Override public void visit(OWLNamedIndividual individual) { write("" + labelFor(individual) + ""); } @Override public void visit(SWRLRule rule) {} @Nonnull public String keyword(String str) { return "" + str + ""; } @Nonnull public String operator(String str) { return "" + str + ""; } }




    © 2015 - 2024 Weber Informatics LLC | Privacy Policy