Building and Running SORI via the Eclipse IDE
These instructions explain how to get the source code for Roller from Roller's Subversion repository, import it in to Eclipse and run it via an Eclipse launcher that starts Jetty and Derby.
Prerequisites
These instructions assume you have these things already installed on your computer:
- Eclipse 3.6
- Sun Java SE 1.6
- Subclipse Subversion client for Eclipse
- M2eclipse Maven client for Eclipse
Checkout code from Subversion
Use the
File->Import menu in Eclipse to start the Import, then choose the
Checkout Projects from SVN option. (If you are wondering why we don't suggest using the "Check out Maven projects from SCM" option: it does not work. See this issue for
https://issues.sonatype.org/browse/MNGECLIPSE-2596 details.)
Choose the
Create new repository location option:
Enter the URI of the SORI trunk, which is
https://oslc-tools.svn.sourceforge.net/svnroot/oslc-tools/sori/trunk
Select the top-level element in the source tree:
Choose the
Checkout as project in the workspace option:
Once you are done you should see a top-level SORI project in Eclipse:
Import Maven projects
Use the
File->Import menu again, and choose to
Import Existing Maven Projects
Select all of the SORI projects:
Now you have all of the SORI projects, plus a top-level that we really do not need. You can delete the top-level project, but don't delete its contents:
Next, you should build the
sori-core project. Right-click on the project's
pom.xml file, choose
Run As and
Maven Install:
If you see an error in the
sori-core project, that means you need to add a generated code folder to the project classpath:
Running SORI AM
To run SORI AM, use the Eclipse
Run->RunConfigurations menu, create a new
Maven Build launcher configured with:
- Base directory: ${workplace_loc:/sori-am-webapp}
- Goals: jetty:run-exploded
Next, you'll see Maven run in the console window and eventually the Jetty server start up.
Now, you can navigate to
http://localhost:8080/sori-am to access SORI AM.