TaniaTudorache at 01:13, April 26, 2013

2013-04-26T01:13:40Z

TaniaTudorache: Created page with "
WebProtégé Developer's Guide
TOC ''Return to main [[WebProtegeDevelopersGuide|W..."

2013-01-22T19:30:54Z

Created page with "<p style="padding:0; margin:0; font-size:1.9em; font-weight:bold; word-spacing:-2px;">WebProtégé Developer's Guide</p> __TOC__ ''Return to main [[WebProtegeDevelopersGuide|W..."

New page

<p style="padding:0; margin:0; font-size:1.9em; font-weight:bold; word-spacing:-2px;">WebProtégé Developer's Guide</p>

__TOC__

''Return to main [[WebProtegeDevelopersGuide|WebProtege Developer's Guide]]''

''Return to main [[WebProtege|WebProtégé page]]''

== Compile and run WebProtégé with Eclipse ==

To follow is some documentation on how one would go about compiling and running WebProtégé in the [http://www.eclipse.org/ Eclipse development environment]. There is more than one way to compile and run WebProtégé in Eclipse - this page documents one possibility, but is not meant to be exhaustive.

The version of Eclipse used for the writing of this documentation is 3.5 (Galileo).

=== Prerequisites ===

==== Google Plugin for Eclipse ====
We are currently using the [http://code.google.com/webtoolkit/ Google Web Toolkit (GWT)] in our development of WebProtégé. The [http://code.google.com/eclipse/ Google Plugin for Eclipse] greatly simplifies working with GWT applications from within Eclipse. There is no need to download GWT separately, as the plug-in includes the necessary GWT SDK.

Please refer to the Quick Start guide on the Google code website for installation instructions:

http://code.google.com/eclipse/docs/getting_started.html

If you want to know what version of GWT we are using, you can check the readme file in our Subversion repository:

http://smi-protege.stanford.edu/svn/icat/trunk/readme.txt

<span style="font-weight:bold;">Older instructions for GWT SDK 1.5 are [[WebProtegeDevelopersGuide_GWT_1_5|still available]].</span>

==== Java 6 ====
WebProtégé requires Java 6, which is [http://www.oracle.com/technetwork/java/javase/downloads/index.html available for download] from Sun's website.

=== Checkout WebProtégé source code ===
Launch Eclipse and go to the SVN Repository Exploring perspective. (This step assumes that you have already installed an Eclipse plug-in called [http://subclipse.tigris.org/ Subclipse] that adds Subversion integration to the Eclipse IDE). Click the "Add SVN Repository" button to bring up the "Add SVN Repository" dialog. In the "Url" text box, type the following URL:

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

... and click Finish. Eclipse should now look something like the following screenshot:

<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Svn-repos-perspective.jpg]]
</div>

Once you have successfully connected to the Protégé Subversion repository, navigate to the '''icat/trunk''' folder, right-click to bring up the context menu, and choose "Checkout..." to bring up the "Checkout from SVN" dialog. Select the options indicated in the screenshot below and click Finish.

<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Webprotege-checkout-dialog.jpg]]
</div>

In the resulting "New Project" wizard, select '''Web Application Project''' (in the Google folder) and click Next. In the "New Web Application Project" dialog, type a project name (for this documentation, we will use "web-protege"). Fill in the rest of the dialog as indicated in the following screenshot:

<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Webprotege-new-webapp-prj-dialog.jpg|450px]]
</div>

Click Finish to begin checking out WebProtégé source code.

<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Webprotege-checkout-complete2.jpg|frame|none|web-protege project in Eclipse IDE after successful checkout of sources]]
</div>

=== Fix project compilation errors ===

<ol>
<li>Right-click on the "web-protege" project and choose Properties from the context menu.</li>

<li>In the Properties dialog, select Java Build Path on the left, and click the Libraries tab on the right.</li>

<li>Click the Add JARs... button and add all JAR files from the "war/WEB-INF/lib" subdirectory to the classpath, such as gwtext.jar, etc.</li>

<li>WebProtégé depends on several jar files available in the Protégé 3.4.7 (or later) installation folder. Protégé 3.4.7 can be downloaded [http://protege.stanford.edu/download/download.html here].

<li>These items are listed below, with the location where you can find the JAR files. There are several different ways these JAR files could be added to your classpath. Once of the easiest ways is probably to create a User Library called something like "Protege" and then add this library to your classpath. You could also create separate User Libraries for Protégé and each Protégé plug-in and add all of these libraries to your classpath. This is simply a matter of personal preference and also assumes that you have the Protégé application installed on your system.

<ul style="padding-top:7px; padding-bottom:7px;">
<li>Core Protege application (root directory of your Protege installation - need protege.jar, unicode_panel.jar, and looks-2.1.3.jar)</li>
<li>Protege-OWL editor (<protege-install-dir>/plugins/edu.stanford.smi.protegex.owl - need all JARS)</li>
<li>Changes tab (<protege-install-dir>/plugins/edu.stanford.smi.protegex.changes - need all JARS)</li>
<li>Chat plug-in (<protege-install-dir>/plugins/edu.stanford.smi.protegex.chatPlugin - need all JARS)</li>
<li>Collaborative Protege (<protege-install-dir>/plugins/edu.stanford.smi.protege.collab - need all JARS)</li>
<li>RDF Backend (<protege-install-dir>/plugins/edu.stanford.smi.protegex.rdf_backend - only rdf-api.jar and rdf-backend.jar)</li>
<li>Standard Extensions Library (<protege-install-dir>/plugins/edu.stanford.smi.protegex.standard_extensions - need all JARS)</li>
<li>BioPortal Reference plug-in (<protege-install-dir>/plugins/edu.stanford.smi.protegex.bp.ref - need all JARS)</li>
<li>Lucene Query plug-in (<protege-install-dir>/plugins/edu.stanford.smi.protegex.query.lucene - need all JARS)</li>
</ul>
<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Webprotege-libraries2.jpg|frame|none|Screenshot of Properties dialog with all necessary libraries for WebProtégé]]
</div>

</li>
<li>Once all of the needed JAR files are on the classpath, click OK and the "web-protege" project should compile successfully.</li>
</ol>

If you see many compilation errors, you might need to add the GWT jars (gwt-user.jar and gwt-dev.jsr) to the build path as well.

=== Modify launch configuration ===

# Bring up the Run Configurations dialog and select the web-protege launch configuration under Web Application on the left-hand side.
# On the GWT tab, modify the contents of "Available modules", and keep only the WebProtege module (remove the other modules)
# Select the Arguments tab and pass a VM argument to give WebProtege more memory, e.g., "-Xmx1000M".
# Click Apply and Close.

=== Run WebProtégé from Eclipse ===

By default, WebProtégé will load some example projects from a local directory (/war/projects) on startup.

If you would like to change the list of projects that are loaded on startup, you can configure this through the Protégé "metaproject", located in the war/projects/metaproject directory. The metaproject is a frame-based ontology that models permissions (a more [[Protege_Client-Server_Tutorial#The_Metaproject|detailed explanation of the metaproject]] is available in the [[Protege Client-Server Tutorial | Protégé Client-Server Tutorial]]).

To run WebProtégé, click the Run button and choose web-protege. You should see something like the following output in Eclipse's Console View:

<pre style="font-size:12px;color:red;">
WebProtege running in: C:\eclipse-sources\web-protege\war\
Path to local metaproject: C:\eclipse-sources\web-protege\war\projects\metaproject\metaproject.pprj
WebProtege server running with local projects
Found project def in metaproject: Collaborative Newspaper at: projects/collaborativeNewspaper/collaborativeNewspaper.pprj
Found project def in metaproject: Newspaper at: projects/newspaper/newspaper.pprj
Found project def in metaproject: Wines at: projects/wines/wines.pprj
Found project def in metaproject: Pizza at: projects/pizza/pizza.owl.pprj
Found project def in metaproject: Collaborative Pizza at: projects/collaborativePizza/collaborativePizza.owl.pprj
</pre>

... and WebProtégé should launch in GWT's dev mode(previously known as hosted mode) browser:

<div style="padding-top:10px; padding-bottom:10px;">
[[Image:Webprotege-hosted-mode2.jpg]]
</div>

'''Note. If you have troubles starting the dev mode on Mac OSX, then use the [http://www.omnigroup.com/products/omniweb/ Omniweb browser].'''

=== Run WebProtégé from Eclipse with external server ===

To run WebProtégé with the Protégé server, please review the instructions [[WebProtegeAdminGuide#Install_WebProtege_-_External_Server_Mode|here]].

You need to make sure that the Protégé server version matches the WebProtégé version you have in Eclipse. You can check the compatibility [[http://protegewiki.stanford.edu/wiki/WebProtegeAdminGuide#Protege_Standalone_Application| here].

To configure WebProtégé to connect to the Protégé server, you need to edit the <code>protege.properties</code> file from the war folder:

<pre>
load.ontologies.from.protege.server=true
</pre>

If the Protégé server doesn't run on <code>localhost</code>, then you should change this properties to match your setup:

<pre>
protege.server.hostname=your_host_name:port_no
</pre>

You start WebProtégé the same way as described in the "Run WebProtégé from Eclipse" section. You will see in the Eclipse console something like:

<pre style="font-size:12px;color:red;">
WebProtégé running in: /work/src/GWT/web-protege/war/
WebProtégé server running with remote projects loaded from the Protégé server: localhost
</pre>

== Configure the projects, users, access policies ==

We have described how to configure the projects available to WebProtégé for both the local and external server mode [[WebProtegeAdminGuide#Configuring_projects.2C_users_and_access_policies|here]].

'''Go back to [[WebProtegeDevelopersGuide|WebProtege Developer's Guide]]'''

'''Go back to [[WebProtege|WebProtégé main page]].'''

[[Category:WebProtege documentation]]

@@ Line 1: / Line 1: @@
 <p style="padding:0; margin:0; font-size:1.9em; font-weight:bold; word-spacing:-2px;">WebProtégé Developer's Guide</p>
@@ Line 165: / Line 167: @@
 '''Go back to [[WebProtege|WebProtégé main page]].'''
-[[Category:WebProtege documentation]]
+[[Category:WebProtege 1.0 documentation]]

WebProtegeCompiling - Revision history

TaniaTudorache at 01:13, April 26, 2013

TaniaTudorache: Created page with "WebProtégé Developer's Guide __TOC__ ''Return to main [[WebProtegeDevelopersGuide|W..."

TaniaTudorache: Created page with "
WebProtégé Developer's Guide
TOC ''Return to main [[WebProtegeDevelopersGuide|W..."