Spring by Example

Skip to main content.

Example Project Setup

Overview

Projects can be checked out directly from the Subversion repository located at http://svn.springbyexample.org/ or using an IDE.

The projects were setup to checkout directly into Eclipse, but Maven can also be used to generate IntelliJ project files ('mvn idea:idea'). The project is also setup to use the Spring IDE.

Basic Setup

  1. Java 5 or higher installed with JAVA_HOME set.
  2. Download and install Maven (version 2.x or higher).

Example Environment Settings

Optionally you can set MAVEN_OPTS to increase it's memory settings. 

JAVA_HOME=/usr/local/java
M2_HOME=/usr/local/maven
MAVEN_OPTS="-Xms128m -Xmx512m"

PATH=$JAVA_HOME/bin:$M2_HOME/bin:$PATH

export JAVA_HOME M2_HOME MAVEN_OPTS

Eclipse Setup

  1. Download and install Eclipse (3.3 or higher, preferably the Java EE release).
  2. Install the Subclipse Subversion Eclipse plugin so the project can be checked out from the repository.
  3. Install the Spring IDE.

  1. Configure Maven Repository location in Eclipse.
  2. Setup a Subversion repository pointing to http://svn.springbyexample.org.
  3. Navigate to the projects trunk.
  4. Right click on 'trunk', select 'Checkout...', click on the 'Finish' button.

Web Setup

  1. Download and install a compliant Web Application Server (like Tomcat).
  2. Show Sever View
    • Window/Show View/Others...
    • Server/Servers
  3. Right click in the Server View and select 'New/Server'.
    1. Choose the an installed server.
  4. Right click on project and select 'Run As'/'Run on Server'.
    1. Choose the server to run the project on.
    2. Click on Next.
    3. Click on Finish.
    4. This should launch the application and also open up a browser window in Eclipse pointing to the webapps home page.

Maven Setup

  1. From the command line (or the Maven Eclipse Plugin can be used) run 'mvn package' from the project directory at least once. This will download all the required jars.
  2. To download source (and/or javadocs) 'mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true' can be run, but note that the .classpath file generated doesn't correclty set the web modules. After running this, revert the .classpath file back to the original one or correctly set the jars that should be used when running the webapp.