Differences between revisions 1 and 2
Revision 1 as of 2005-07-01 06:16:20
Size: 6018
Comment:
Revision 2 as of 2009-09-20 23:46:47
Size: 6042
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 16: Line 16:
 * [http://java.sun.com/ Java JDK 1.4]
 * [http://ant.apache.org/ Ant 1.5]
 * [http://maven.apache.org/ Maven 1.0]
 * [[http://java.sun.com/|Java JDK 1.4]]
 * [[http://ant.apache.org/|Ant 1.5]]
 * [[http://maven.apache.org/|Maven 1.0]]
Line 22: Line 22:
 1. Dowload Eclipse from [http://www.eclipse.org eclipse.org]. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.  1. Dowload Eclipse from [[http://www.eclipse.org|eclipse.org]]. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.
Line 30: Line 30:
Name: [http://mevenide.codehaus.org/mevenide-ui-eclipse/features.html Mevenide] [[BR]] Name: [[http://mevenide.codehaus.org/mevenide-ui-eclipse/features.html|Mevenide]] <<BR>>
Line 33: Line 33:
If you see a java.lang.No''''''Such''''''Method''''''Error error with Mevenide during launch, use the following URL for the Update Manager[[BR]] If you see a java.lang.No''''''Such''''''Method''''''Error error with Mevenide during launch, use the following URL for the Update Manager<<BR>>
Line 37: Line 37:
Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the [http://eclipse-cs.sourceforge.net/ Checkstyle plugin site]. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running. Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the [[http://eclipse-cs.sourceforge.net/|Checkstyle plugin site]]. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running.
Line 39: Line 39:
You may also want to try [http://propsorter.sourceforge.net/veloeclipse Veloeclipse], a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values. You may also want to try [[http://propsorter.sourceforge.net/veloeclipse|Veloeclipse]], a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values.
Line 41: Line 41:
Name: Veloeclipse [[BR]]
Update Manager URL: `http://propsorter.sourceforge.net/veloeclipse` [[BR]]
Name: Veloeclipse <<BR>>
Update Manager URL: `http://propsorter.sourceforge.net/veloeclipse` <<BR>>
Line 44: Line 44:
Some developers also use [http://xmlbuddy.com/ XMLBuddy]. Some developers also use [[http://xmlbuddy.com/|XMLBuddy]].
Line 46: Line 46:
The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse [http://www.sysdeo.com/eclipse/tomcatPlugin.html]. This is a manual install. The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse [[http://www.sysdeo.com/eclipse/tomcatPlugin.html]]. This is a manual install.
Line 48: Line 48:
There are more Eclipse plugins available at [http://www.eclipse-plugins.info/]. There are more Eclipse plugins available at [[http://www.eclipse-plugins.info/]].
Line 54: Line 54:
Download and install Tomcat from [http://jakarta.apache.org/tomcat/]. Download and install Tomcat from [[http://jakarta.apache.org/tomcat/]].
Line 56: Line 56:
Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to [http://issues.apache.org/jira/browse/JS2-55] for more information. Otherwise, Tomcat 4 or 5 are equally good choices. Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to [[http://issues.apache.org/jira/browse/JS2-55]] for more information. Otherwise, Tomcat 4 or 5 are equally good choices.
Line 65: Line 65:
Enter the following information in the Add CVS Repository dialog: [[BR]]
Host: `cvs.apache.org` [[BR]]
Repository path: `/home/cvspublic` [[BR]]
User: `anoncvs` [[BR]]
Leave Password empty. [[BR]]
Enter the following information in the Add CVS Repository dialog: <<BR>>
Host: `cvs.apache.org` <<BR>>
Repository path: `/home/cvspublic` <<BR>>
User: `anoncvs` <<BR>>
Leave Password empty. <<BR>>
Line 86: Line 86:
Maven Home will probably be something like: [[BR]] Maven Home will probably be something like: <<BR>>
Line 89: Line 89:
Maven Local Home: [[BR]] Maven Local Home: <<BR>>
Line 92: Line 92:
Maven Local Repository: [[BR]] Maven Local Repository: <<BR>>
Line 97: Line 97:
Name: `MAVEN_REPO` [[BR]] Name: `MAVEN_REPO` <<BR>>

Getting Started Developing Jetspeed

Introduction

This section is for developers who want to work on Jetspeed 2 itself, not necessarily for portlet developers.

Setting up a development environment

There are many different ways to set up a development environment that will enable you to effectively develop Jetspeed 2. This example uses Eclipse, Tomcat 5, and MySQL.

Prerequisites

Download and install these packages:

Setting up Eclipse

  1. Dowload Eclipse from eclipse.org. Any Latest Release version from 3.0 onward will probably be OK. If you have problems with any of the plugins, make sure they support the version of Eclipse you downloaded.

  2. Install Eclipse plugins:

At a minumum you will need to install the Mevenide and Checkstyle plugins. Mevenide is used for working with Mavenized projects. Checkstyle is a Java programming style enforcer.

The easiest way to install plugins is through the Eclipse Update Manager. Choose Help > Software Updates > Find and Install. In the next dialog, choose "Seach for new features to install" and then "Add Update Site".

Name: Mevenide
Update Manager URL: http://mevenide.codehaus.org/release/eclipse/update/site.xml

If you see a java.lang.NoSuchMethodError error with Mevenide during launch, use the following URL for the Update Manager
http://mevenide.codehaus.org/update/3.0/site.xml

Unfortunately, installing the Checkstyle plugin is a manual process. Start by downloading the plugin from the Checkstyle plugin site. Next, unzip the download and copy the directory to your eclipse/plugins directory. Restart Eclipse if it's running.

You may also want to try Veloeclipse, a plugin for editing Velocity templates. It's available through the Eclipse Update Manager. Use the steps described above for Mevenide, but use the following values.

Name: Veloeclipse
Update Manager URL: http://propsorter.sourceforge.net/veloeclipse

Some developers also use XMLBuddy.

The Sysdeo Tomcat plugin is also handy for controlling Tomcat from Eclipse http://www.sysdeo.com/eclipse/tomcatPlugin.html. This is a manual install.

There are more Eclipse plugins available at http://www.eclipse-plugins.info/.

Note on the Eclipse workspace: If you are using Windows, set your Eclipse workspace (in the annoying window that opens up every time you launch Eclipse until you finally notice the checkbox) such that the directory path does not contain any spaces. You will have trouble building if the path to your workspace contains spaces.

Setting up Tomcat

Download and install Tomcat from http://jakarta.apache.org/tomcat/.

Tomcat 4 and 5 are both supported. Versions of Tomcat older than 5.0.28 require a JAASRealm patch that will be automatically applied by Maven during the build. Refer to http://issues.apache.org/jira/browse/JS2-55 for more information. Otherwise, Tomcat 4 or 5 are equally good choices.

Checking out Jetspeed

The first thing you need to do is add a CVS respository: Window > Open Perspective > CVS Repository Exploring

Make sure the "CVS Repositories" tab is selected and right-click (Control-click on the Mac) that pane. Choose New > Repository Location... in the context menu. Alternatively, you can click the "Add CVS Repository" button to the right of the tabs.

Enter the following information in the Add CVS Repository dialog:
Host: cvs.apache.org
Repository path: /home/cvspublic
User: anoncvs
Leave Password empty.

The connection type is pserver, using the default port.

You can then drill down to the jakarta-jetspeed-2 module from HEAD.

Right-click (control-click on the Mac) on the jakarta-jetspeed-2 module and choose Check Out As... from the context menu.

Select "Check out as a project in the workspace" and click the Finish button.

Now switch from the CVS perspective to the Java perspective (Window > Open Perspective; you may need to choose Other... and select Java from the resulting dialog).

Presto! You have a checkout of jakarta-jetspeed-2. You'll probably get a ton of errors. Luckily they're all variations on the same theme: Unbound classpath variable: MAVEN_REPO/blah/blah/blah.

Before we go any further, make sure that the Maven settings are correct in Eclipse. Open the Eclipse Preferences dialog and select the Maven > Locations. In the author's experience on Mac OS X, it was neccessary to enter the Java Home path as a URL: file:/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home

Maven Home will probably be something like:
/usr/local/maven-1.0

Maven Local Home:
/your/home/.maven

Maven Local Repository:
/your/home/.maven/repository

OK -- now we're ready to fix those MAVEN_REPO errors. In the Preferences window, click Java > Build Path > Classpath Variables. Click the "New..." button and enter the following:

Name: MAVEN_REPO
Path: the path to your Maven Local Repositry, i.e. /your/home/.maven/repository

Click OK until you've saved your preferences and the Prefences window is closed.

The build errors should disappear. Right-click (control-click) the project name "jakarta-jetspeed-2" and choose Maven > Run Maven... . In the text field to the left of the "Choose..." button, enter allClean allBuild and click "Run".

That's it, you're building Jetspeed! Any build problems from here on are left as an exercise to the reader. :)

Jetspeed2/DevelopersDocumentation/DevelopingJetspeedPlatform (last edited 2009-09-20 23:46:47 by localhost)