Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The SSK (SiteMesh Starter Kit) will most likely be a combination of Eclipse SpringSource, Java, Tomcat SpringSource, SiteMesh, and is a development package to quickly get started with SiteMesh and see a working demonstrations of the first 2 example tutorials all setup with no dependencies on the OS.The goal is to be able to unzip, click start and .

Download, unzip, launch and import cafe.war to see SiteMesh in action instantly.

Warning

I have having trouble packaging the application after it is setup. Until this is solved see the SiteMesh Starter Kit build notes.

Info

If you are interested in how this was accomplished, read the SiteMesh Starter Kit build notes.

Microsoft Windows unzip program will not work. Consider the free 7-Zip, Winzip or WinRAR.

Info

For the keeners, read Portable Development Environment to understand what SSK is exactly composed of.

Table of Contents

Download

...

Using the SiteMesh Starter Kit on Windows

The SiteMesh Starter Kit was put together to be as unobtrusive as possible. As such there is no installation.

Unzip the ssk folder to a root folder. For example C:\ or D:\In this example, we create an apps folder on the C: drive and unzip using 7-Zip.

Note

You may use another folder, but some unzip programs will give you an error about long path names. This is a Windows limitation.

For the rest of this tutorial we will assume you are using the folder C:\apps\ssk.

Start the IDE (Integrated Development Environment)

Starting, C:\SSKapps\ssk\sts-2.68.10.SR1RELEASE\STS.exe will launch your development environment as shown below,

Image Removed

Launch the Default Example

By default, SSK includes the very .

You will be asked to select a workspace location. This will be where your web application files will be kept. The default is fine,

Image Added

Import cafe WAR File

Import cafe.war which contains the first two tutorials,

Click File, Import... which will result in an import dialog box,

Image Added

Expand the Web folder by clicking on the selection arrow and select WAR file.

Click Next.

Browse to the cafe.war file and select it,

Image Added

Click Finish.

During import you will be asked to open the Java EE perspective,

Image Added

Click Yes.

Optional - Clean Up View

By default the IDE hides the real directory structure.

Click Window, Show View, Navigator.

In the Navigator Window, expand the cafe folder to see the sample sitemesh application in your workspace,

Image Added

Launch the Default Example

Following through the tutorials the last step is to start the application server and browse to menu.jsp.

To do this with the SSK, right click on the file menu.jsp and choose Run on Server,

Note

This might take a about a minute so please be patient.

You will then be prompted to select a Server. The defaults are fine. Click the Finish button,

Finally, there There will be a Spring Insight and depending on your Windows setup a Windows Firewall dialog as shown,

Select No to the Spring Insight and if prompted Allow Access to the Windows Firewall dialog.

If everything succeeds you will see the following screen,

...

Tutorials

To keep things simple for developers new to both SiteMesh and Java web applications, subsequent tutorials are not included in the SSK. Instead they are packaged as WAR files and can be imported. You will find the WAR files for tutorials at the end of each tutorial.

...

At this point SiteMesh is setup and working. Go straight to Start Using SiteMesh in 10 Minutes to start being productive.

After that, read up on Setup Mesh in 5 Minutes for configuration into your own web application.