Difference between revisions of "ProtegeOWL API Programmers Guide"

From Protege Wiki
Jump to: navigation, search
(split section out to separate page ProtegeOWL_API_Basics)
 
(43 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
- Original Author: [http://www.knublauch.com/ Holger Knublauch]<br />
 
- Original Author: [http://www.knublauch.com/ Holger Knublauch]<br />
 
- Currently maintained by: [http://protege.stanford.edu/aboutus/aboutus.html Protege staff members] (contributions from the user community are welcome)<br />
 
- Currently maintained by: [http://protege.stanford.edu/aboutus/aboutus.html Protege staff members] (contributions from the user community are welcome)<br />
- Last update: May 13, 2010
+
- Last update: June 30, 2010
 
</div>
 
</div>
  
Line 60: Line 60:
  
 
Execute this program stand-alone. The output should be "Class URI: <nowiki>http://hello.com#World</nowiki>".
 
Execute this program stand-alone. The output should be "Class URI: <nowiki>http://hello.com#World</nowiki>".
 +
  
 
== Basics ==
 
== Basics ==
  
=== Working with OWL Models ===
+
''For more details on this topic, see [[ProtegeOWL_API_Basics|Protege-OWL API Basics]]''
 +
 
 +
Covered topics include:
 +
 
 +
* Working with OWL Models
 +
* Names, Namespace prefixes, and URIs
 +
* Understanding the Model Interfaces
 +
* Creating Named Classes and Individuals
 +
* Using Datatype Properties and Datatype Values
 +
* Using Object Properties to Build Relationships between Resources
 +
* Working with References to External/Untyped Resources
 +
* Property Domains
 +
 
  
The Protege-OWL API is centered around a collection of Java interfaces from the '''model''' package. These interfaces provide access to the OWL model and its elements like classes, properties, and individuals. Application developers should not access the implementation of these interfaces (such as '''DefaultRDFIndividual''') directly, but only operate on the interfaces. Using these interfaces you don't have to worry about the internal details of how Protege stores ontologies. Everything is abstracted into interfaces and your code should not make any assumptions about the specific implementation.
+
== Advanced Class Definitions (OWL DL) ==
  
The most important model interface is '''[http://protege.stanford.edu/protege/3.4/docs/api/owl/edu/stanford/smi/protegex/owl/model/OWLModel.html OWLModel]''', which provides access to the top-level container of the resources in the ontology. You can use OWLModel to create, query, and delete resources of various types and then use the objects returned by the OWLModel to do specific operations. For example, the following snippet creates a new '''OWLNamedClass''' (which corresponds to '''owl:Class''' in OWL), and then gets its URI:
+
''For more details on this topic, see [[ProtegeOWL_API_Advanced_Class_Definitions|Protege-OWL API Advanced Class Definitions (OWL DL)]]''
  
<pre>
+
Covered topics include:
OWLModel owlModel = ProtegeOWL.createJenaOWLModel();
+
 
OWLNamedClass worldClass = owlModel.createOWLNamedClass("World");
+
* Restrictions
System.out.println("Class URI: " + worldClass.getURI());
+
* Logical Class Definitions (Unions, Intersections, Complements)
</pre>
+
* Enumerated Classes
 +
* Creating Defined Classes
 +
 
 +
 
 +
== Advanced Topics ==
 +
 
 +
''For more details on this topic, see [[ProtegeOWL_API_Advanced_Topics|Protege-OWL API Advanced Topics]]''
 +
 
 +
Covered topics include:
 +
 
 +
* Querying the OWLModel
 +
* RDF(S) and OWL
 +
* Reacting to Changes using Listeners
 +
* Loading and Saving Files
 +
* Working with Multi-File Projects and TripleStores
 +
* Working with Jena Models
 +
 
 +
 
 +
== Protege Programming ==
 +
 
 +
''For more details on this topic, see [[ProgrammingWithProtege|Programming with Protege-OWL]]''
 +
 
 +
Covered topics include:
 +
 
 +
* Protege-OWL and the Core Protege API
 +
* Changes from the old Protege-OWL API
 +
* Protege User Interface Programming
 +
* Protege Plug-in Development
 +
 
 +
 
 +
== Building Semantic Web Applications ==
  
Note that the class '''ProtegeOWL''' provides a couple of convenient static methods to create OWLModels, also from existing OWL files. For example, you can load an existing ontology from the web using
+
''For more details on this topic, see [[BuildingSemanticWebApplications|Building Semantic Web Applications]]''
  
<pre>
+
This section provides information on building standalone Semantic Web applications using the Protege-OWL API.
String uri = "http://www.co-ode.org/ontologies/pizza/2007/02/12/pizza.owl";
 
OWLModel owlModel = ProtegeOWL.createJenaOWLModelFromURI(uri);
 
</pre>
 

Latest revision as of 12:25, July 8, 2010

Protege-OWL API Programmer's Guide

The Protege-OWL API is an open-source Java library for the Web Ontology Language (OWL) and RDF(S). The API provides classes and methods to load and save OWL files, to query and manipulate OWL data models, and to perform reasoning based on Description Logic engines. Furthermore, the API is optimized for the implementation of graphical user interfaces.

- Original Author: Holger Knublauch
- Currently maintained by: Protege staff members (contributions from the user community are welcome)
- Last update: June 30, 2010



Overview

The Protege-OWL API is an open-source Java library for the Web Ontology Language (OWL) and RDF(S). The API provides classes and methods to load and save OWL files, to query and manipulate OWL data models, and to perform reasoning based on Description Logic engines. Furthermore, the API is optimized for the implementation of graphical user interfaces.

The API is designed to be used in two contexts:

  • For the development of components that are executed inside of the Protege-OWL editor's user interface
  • For the development of stand-alone applications (e.g., Swing applications, Servlets, or Eclipse plug-ins)

Protege is a flexible, configurable platform for the development of arbitrary model-driven applications and components. Protege has an open architecture that allows programmers to integrate plug-ins, which can appear as separate tabs, specific user interface components (widgets), or perform any other task on the current model. The Protege-OWL editor provides many editing and browsing facilities for OWL models, and therefore can serve as an attractive starting point for rapid application development. Developers can initially wrap their components into a Protege tab widget and later extract them to distribute them as part of a stand-alone application.

This guide will introduce you to some basic concepts of the Protege-OWL API, no matter whether you intend to use it for stand-alone applications or Protege plug-ins. The guide tries to illustrate the API by examples, and most examples create parts of OWL ontologies such as properties and restrictions. The complete source code for most of the examples can be found in the edu.stanford.smi.protegex.owlx.examples package in the Protege-OWL source code. If you have trouble getting started, please post questions on the protege-owl mailing list.

Installation & Getting Started

The Protege-OWL editor is provided with the standard installation of Protege. In addition to installing Protege, you should download the source code from the Protege Subversion repository. The source code is the most reliable reference for the system's functionality and browsing the source code with a Java IDE is a great way to learn the API. Detailed instructions on how to download source code from our repository are available on the main Protege website. The URL to download the Protege-OWL source code using a Subversion client is:

http://smi-protege.stanford.edu/repos/protege/owl/trunk/.

You will also find Javadoc for the API useful. In particular, you will need to understand the interfaces from the edu.stanford.smi.protegex.owl.model package.

Following a successful installation, your directory structure should look approximately as follows:

Directory structure of the Protege application after a successful install

Now let us configure our Java project and write a small "Hello World" application. If you are using a Java IDE such as Eclipse or IntelliJ, select the Protege installation folder as your project home. Next, add all the JAR files from the installation to your project classpath. Set your compiler output path to plugins/classes.

Then create a Java class such as the following:

package com.demo.application;

import edu.stanford.smi.protegex.owl.model.OWLModel;
import edu.stanford.smi.protegex.owl.model.OWLNamedClass;
import edu.stanford.smi.protegex.owl.ProtegeOWL;

public class OWLAPIDemoApplication {

    public static void main(String[] args) {
        OWLModel owlModel = ProtegeOWL.createJenaOWLModel();
        owlModel.getNamespaceManager().setDefaultNamespace("http://hello.com#");
        OWLNamedClass worldClass = owlModel.createOWLNamedClass("World");
        System.out.println("Class URI: " + worldClass.getURI());
    }
}

Execute this program stand-alone. The output should be "Class URI: http://hello.com#World".


Basics

For more details on this topic, see Protege-OWL API Basics

Covered topics include:

  • Working with OWL Models
  • Names, Namespace prefixes, and URIs
  • Understanding the Model Interfaces
  • Creating Named Classes and Individuals
  • Using Datatype Properties and Datatype Values
  • Using Object Properties to Build Relationships between Resources
  • Working with References to External/Untyped Resources
  • Property Domains


Advanced Class Definitions (OWL DL)

For more details on this topic, see Protege-OWL API Advanced Class Definitions (OWL DL)

Covered topics include:

  • Restrictions
  • Logical Class Definitions (Unions, Intersections, Complements)
  • Enumerated Classes
  • Creating Defined Classes


Advanced Topics

For more details on this topic, see Protege-OWL API Advanced Topics

Covered topics include:

  • Querying the OWLModel
  • RDF(S) and OWL
  • Reacting to Changes using Listeners
  • Loading and Saving Files
  • Working with Multi-File Projects and TripleStores
  • Working with Jena Models


Protege Programming

For more details on this topic, see Programming with Protege-OWL

Covered topics include:

  • Protege-OWL and the Core Protege API
  • Changes from the old Protege-OWL API
  • Protege User Interface Programming
  • Protege Plug-in Development


Building Semantic Web Applications

For more details on this topic, see Building Semantic Web Applications

This section provides information on building standalone Semantic Web applications using the Protege-OWL API.