NOTE: This page is a translation from the original Japanese version of setup.html, rev 470 as of 2008-05-05.

Menu

Setting up

Setting up Tutorial

The tutorial project is configured for use with Eclipse, Tomcat and Tomcat launcher. Though SAStruts itself does not depend on any specific IDEs or app servers, you should use Eclipse, Tomcat and Tomcat Launcher for tutorial.

1. Tutorial project

Download sa-struts-tutorial-xxx.zip from the download page and extract the archive.

Import a directory named sa-struts-tutorial in the extracted contents as an Eclipse project.

2. Tomcat and related plugin

Install Tomcat from this link following the instrunctions. Select a release of version 5.5 or later. Installation is not needed if you have already installed one.

Tomcat Launcher is a plugin developed by EclipseTotale. You can install it from the Eclipse3.2 update site of Seasar Project. From Eclipse menu, select [Help]-> [Software Updates] -> [Find and Install…] to show Install/Update dialog.

Check [Search for new features to install] radio button then click [Next]. Click [New Remote site], enter [Seasar Plugin3.2] to [Name], enter [http://eclipse.seasar.org/updates/3.2/] to [URL], then click [OK].

Click [Finish], then Tomcat Launcher appears as an option. Check it and install. Installation is not needed if you have already installed one.

3. Plugins to facilitate development with SAStruts

SAStrutsPlugin is an Eclipse plugin to assist your development work with SAStruts. You can switch between a Java file and a corresponding JSP. For datails, see SAStrutsPlugin page.

To use SAStrutsPlugin, WST2.0 is required. WTP2.0 is already installed if you use Eclipse IDE for JAVA EE Developers. If you use other distributions, check Eclipse site and install required packages before you proceed.

ResourceSynchronizer is a plugin to operate Eclipes from your web browser. By using it, you can display stack trace and the appropriate part of the source code when an JAVA exception is thrown.

You can install SAStrutsPlugin and ResourceSynchronizer from the Eclipse3.3 update site of Seasar Project.

From Eclipse menu, select [Help]-> [Software Updates] -> [Find and Install…] to show Install/Update dialog.

Check [Search for new features to install] radio button then click [Next]. Click [New Remote site], enter [Seasar Plugin3.3] to [Name], enter [http://eclipse.seasar.org/updates/3.3/] to [URL], then click [OK].

Click [Finish], then ResourceSynchronizer and SAStrutsPlugin will appear as options. Check them and install. Installation is not needed if you have already installed one.

4. PropertiesEditor Plugin

Optionally, you can install PropertiesEditor plugin to edit .properties file in a native language, e.g. Japanese. Though this plugin is optional, it is very useful for developers who handle properties with i18n characters.

From Eclipse menu, select [Help]-> [Software Updates] -> [Find and Install…] to show Install/Update dialog.

Check [Search for new features to install] radio button then click [Next]. Click [New Remote site], enter [PropertiesEditor] to [Name], enter [http://propedit.sourceforge.jp/eclipse/updates/] to [URL], then click [OK].

Click [Finish], then PropertiesEditorForEclipse3.x appears as an option. Install it. Installation is not needed if you have already installed one.

5. Setting after the installation and checking that it works

After the installation, let us configure Tomcat Launcher. In the menu, select [Window] -> [Preferences…]-> [Tomcat]. Specify Tomcat version and Tomcat home to the version you have downloaded and the directory you have installed Tomcat. Select Context files as Context declaration mode, then click [OK].

Right-click the project of sa-struts-tutorial then select [Tomcat project] -> [Update context definition]. That's all for Tomcat Launcher configuration.

The next step is to configure Tomcat. Modify conf/server.xmlconf/context.xmlconf/web.xml following the instructions found in the links.

Now let's start Tomcat. From the Menu, select [Tomcat]->[Start Tomcat] to start Tomcat. Confirm that the startup process is complete with no errors, then access
http://localhost:8080/sa-struts-tutorial with your web browser. If index page is displayed, that indicates that the setup prcess goes well.

Please proceed to Tutorial.

Setting up Blank

A Blank project is available as a template for your project. The content of Blank project is the same as the content of Tutorial project except that it lacks the sample application. Please refer to Setting up Tutorial to set up Blank.

Specify a root package for your project. For details of root package, see Project components.

For configurations of data access, please see here.

For configurations of transaction, please see here.

Primitive Setup

In the case you want to set up without relying on Tutorial nor Blank, download sa-struts-blank-xxx.zip from the download page and extract the archive to obtain required files.

Add files in sa-struts-blank/src/main/resources to your classpath.

Copy files in sa-struts-blank/webapp/WEB-INF into WEB-INF.

Copy files in sa-struts-blank/webapp/WEB-INF/lib into WEB-INF/lib.

Specify a root package for your project. For details of root package, see Project components.

For configurations of data access, please see here.

For configurations of transaction, please see here.