Difference between revisions of "Protege Server design"

From Protege Wiki
Jump to: navigation, search
(Main concepts)
(Plugin Model)
 
(4 intermediate revisions by the same user not shown)
Line 26: Line 26:
 
==Plugin Model==
 
==Plugin Model==
  
 +
While a server may be configured in a programatic fashion, one of the primary methods of running the server uses a plugin architecture. In this plugin architecture, jar files for server plugins are placed in a directory where they are automatically loaded and then configured to work together by following the instructions in a server configuration file.  This plugin mechanism is based on the OSGi declarative services.  There are four main types of extensions that a plugin may make to the Protege OWL Server:
 +
* A core server.  The server is the core component that implements all the [https://github.com/protegeproject/org.protege.owl.server/blob/master/src/main/java/org/protege/owl/server/api/server/Server.java server interface] which includes both [https://github.com/protegeproject/org.protege.owl.server/blob/master/src/main/java/org/protege/owl/server/api/server/ServerExports.java public interfaces] that are accessible to the client as well as [https://github.com/protegeproject/org.protege.owl.server/blob/master/src/main/java/org/protege/owl/server/api/server/ServerInternals.java server private interfaces] that are only accessible by plugins on the server.  This means that somebody who thinks they have a better implementation of the server interface can simply write a plugin and configure a Protege OWL Server to use their implementation.
 +
* A server filter extension.  This type of extension intercepts all calls to the server and may perform arbitrary processing, including throwing an exception, either before or after calling the server.  Examples of server filters that are used by the standard Protege OWL server distribution include
 +
** extensions that  check that a given call is consistent with policy,
 +
** extensions that check that the caller is properly authenticated,
 +
** extensions that detect conflicts,
 +
** extensions that prevent race conditions by making sure that certain operations, in this case commit operations, occur in a sequential manner, and
 +
** extensions that make sure that the server is properly shutdown on completion.
 +
* A server transport extension.  This extension controls the protocol that the client and the server use to communicate.  Thus for example the current Protege OWL distribution uses the RMI protocol for client server communications.  While a restful implementation of the client server communications would probably not be very efficient, it might make sense for a for an instance of the Protege OWL Server that
  
 
==Interfaces==
 
==Interfaces==

Latest revision as of 14:42, September 13, 2013


Protege Server Design

Main concepts

The Protege OWL Server is loosely based on the ideas expressed in a paper that was a collaborative effort between Stanford University and the University of Manchester. The Protege OWL server presents a hierarchical arrangement of directories and evolving ontologies. Each evolving ontology in this hierarchical arrangement is represented as a sequence of revisions together with a collection of ontology changes that represent the change needed to take one revision to the next. Thus, for example, if a user wants to take an existing ontology and place it on the server, a client may perform the following steps

  • The client utilizes Protege OWL Server calls to navigate to the directory where she wants to place the original version of her ontology.
  • The client creates an ontology document in that directory. This ontology document will initially have only one revision and if the ontology at that revision is retrieved it will be empty; it will not even have a name.
  • The client commits all those changes to the ontology document to bring it from its empty document status to the ontology that the client wishes to put on the server. At this point the ontology document will have two revisions, the initial empty revision and the next revision.

The server interface as seen by a client is contained in the class org.protege.owl.server.api.server.ServerExports. This class is intentionally a very lean interface; it currently contains only seven interface methods. The ServerExports class will have some interfaces to provide the hierarchical directory structure that contains the ontology documents. For example, one of the interfaces in ServerExports is the following:

        Collection<ServerDocument> list(AuthToken u, ServerDirectory dir) throws OWLServerException;

This call lists the contents of a Protege OWL Server directory. The AuthToken parameter is a representation of the authenticated user that wants to list the contents of the directory. The ServerDirectory parameter is the Protege OWL Server document that represents a directory. The call returns a list of the entities in the directories which are represented by ServerDocuments. A ServerDocument is an interface which may represent either a ServerDirectory object or a ServerOntologyDocument. That is to say, a server directory contains a collection of zero or more server directories and server ontology documents. The ServerExports class will have some interfaces to get the changes between any two revisions

           ChangeHistory getChanges(AuthToken u, ServerOntologyDocument doc, OntologyDocumentRevision start, OntologyDocumentRevision end) throws OWLServerException;

and some interfaces to commit changes to the server:

    void commit(AuthToken u, ServerOntologyDocument doc, SingletonChangeHistory changes) throws OWLServerException;

In addition to these simple interfaces supporting the main functionality of the server, that is maintaining the change sets between different versions of ontologies, the server has support for orthogonal requirements such as authentication and the enforcement of policies for reading and/or writing ontologies.

Plugin Model

While a server may be configured in a programatic fashion, one of the primary methods of running the server uses a plugin architecture. In this plugin architecture, jar files for server plugins are placed in a directory where they are automatically loaded and then configured to work together by following the instructions in a server configuration file. This plugin mechanism is based on the OSGi declarative services. There are four main types of extensions that a plugin may make to the Protege OWL Server:

  • A core server. The server is the core component that implements all the server interface which includes both public interfaces that are accessible to the client as well as server private interfaces that are only accessible by plugins on the server. This means that somebody who thinks they have a better implementation of the server interface can simply write a plugin and configure a Protege OWL Server to use their implementation.
  • A server filter extension. This type of extension intercepts all calls to the server and may perform arbitrary processing, including throwing an exception, either before or after calling the server. Examples of server filters that are used by the standard Protege OWL server distribution include
    • extensions that check that a given call is consistent with policy,
    • extensions that check that the caller is properly authenticated,
    • extensions that detect conflicts,
    • extensions that prevent race conditions by making sure that certain operations, in this case commit operations, occur in a sequential manner, and
    • extensions that make sure that the server is properly shutdown on completion.
  • A server transport extension. This extension controls the protocol that the client and the server use to communicate. Thus for example the current Protege OWL distribution uses the RMI protocol for client server communications. While a restful implementation of the client server communications would probably not be very efficient, it might make sense for a for an instance of the Protege OWL Server that

Interfaces

Protege Server Modules

Serialization of ontology changes

Client side revision management

Tricky points

Update after a commit

Out of band interfaces