Setting up Eclipse

Setting up a project to build CXF is pretty easy. There are three parts to it:

Required plugins

We use several Eclipse plugins to make building CXF a bit easier

• Checkstyle - we use checkstyle to make sure we have consistent code style as well as to find various types of bugs and other issues. http://eclipse-cs.sourceforge.net/update
• PMD - like Checkstyle, we use PMD to find potential programming problems in the code. Point the Eclipse auto-install thing at http://pmd.sourceforge.net/eclipse
• Subversion plugins - there are a couple of these to enable Subversion checkins/checkouts from within eclipse: http://subclipse.tigris.org/update_1.2.x

To install the plugins:

• Go to

  Help -> Software updates -> Find and install
  

• Select "Search for new features to install" and hit Next
• For each of the above plugins, click on "New Remote Site", enter a name and the above URL.
• Select the three new sites and click finish. It will search for the new plugins. Select them all and hit OK.

It will then download them and install them.

Creating a workspace

To create a workspace, just run

> mvn -Pfastinstall
> mvn -Psetup.eclipse  

OR

> mvn install -Pfastinstall -Psetup.eclipse

This creates a new workspace in "../workspace" for use with CXF. If you don't want the workspace there, you can run: "mvn -Psetup.eclipse -Declipse.workspace.dir=path/to/workspace".

What this does is create a workspace and imports our checkstyle rules, the maven 2 repository, code format rules, import order rules, etc... into that workspace. It also goes through each sub-project and creates the .project and .classpath files. This process will take some time. It will down load source jars for most of the dependencies and hook them up in the .classpath file as well. Thus, while coding/debugging, you can trace right into the dependent libraries. While running, you WILL see a bunch of warnings and such flying by. There are a bunch of jars on ibiblio that do NOT have source jars with them. Thus, you will see warning about those. Those warnings are safely ignorable. As long as it says "BUILD SUCCESSFUL" at the end, you should be OK.

Create the project in Eclipse

• In eclipse, switch to the workspace setup as above.
• Go To:

  File -> Import....
  

• Select "Existing Projects into Workspace" and hit Next
• Select root directory: enter the path to your trunk directory and hit Next.
• Select all the subprojects and hit Finish. Then wait a while while it imports the projects and rebuilds them. This will take a while.

That's all there is to it. From eclipse, all the unit tests and system tests should be runnable. However, to build kits/jars and stuff, you still need to use the command line "mvn" stuff.