Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

Using multiple Struts configuration files

Brett McLaughlin, Sr. (brett@newInstance.com), Author/Editor, O'Reilly Media, Inc.
Brett McLaughlin
Brett McLaughlin has worked in computers since the Logo days. (Remember the little triangle?) In recent years, he's become one of the best-known authors and programmers in the Java technology and XML communities. He's worked for Nextel Communications, implementing complex enterprise systems; at Lutris Technologies, actually writing application servers; and, most recently, at O'Reilly Media, Inc., where he continues to write and edit books that matter. His most recent book, Java 1.5 Tiger: A Developer's Notebook , was the first book available on the newest version of Java technology, and his classic Java and XML remains one of the definitive works on using XML technologies in the Java language.

Summary:  Breaking a large configuration file into smaller, more manageable parts makes Struts applications easier to organize and maintain. In this tutorial, Brett McLaughlin shows how to set up Apache Struts to use multiple configuration files. The tutorial reviews Struts configuration, takes you step-by-step through execution of a divide-and-conquer configuration strategy, and guides you through some additional configuration cleanup options.

Date:  22 Nov 2005
Level:  Introductory PDF:  A4 and Letter (78 KB | 23 pages)Get Adobe® Reader®

Activity:  15125 views
Comments:  

Before you start

About this tutorial

This tutorial shows Java™ Web developers how to set up Apache Struts to use multiple configuration files. You'll learn about the purpose and structure of the various Struts configuration files and the rationale for working with smaller files. You'll follow steps to split a large, complex struts-config.xml file for an existing Struts application into multiple configuration files that are organized by function. Having smaller, more manageable parts to work with makes a Struts application easier to organize and reconfigure, and it can help you more easily identify points of failure when problems occur. You'll also learn about some other types of cleanup you can do to improve your Struts configurations.

Who should take this tutorial?

This tutorial is written for Java Web developers who have at least some basic experience with Apache Struts and the Apache Tomcat servlet engine. You should know how to start and stop Tomcat, install Struts, and deploy a Struts application.

You can use a servlet engine other than Tomcat (Struts plays quite well with other servlet engines), provided you know how to set it up and configure it. The tutorial assumes you're using Tomcat and provides no extra detail for non-Tomcat configurations. See Resources for a link to Struts documentation on installing Struts on non-Tomcat servlet containers.

Struts uses XML configuration files, so you should be comfortable with XML. But you don't need to be a configuration guru because I'll provide some basic information on how Struts uses these files before I go into the details of breaking them up.


Prerequisites

You need a machine -- or ISP -- that has a servlet engine installed. I highly recommend you run through this tutorial either locally, on a development machine, or on a nonproduction ISP account. Don't use a machine serving thousands of users because you'll need to make changes to your servlet container (and if your servlet engine doesn't automatically reload the changes, you'll also need to restart the container manually).

Although neither is required for this tutorial, I'm using Tomcat 5.5.9 and Java 5.0 (Release 1) on Mac OS X. Java 1.4 works just as well, but you might see some compiler warnings in the tutorial examples that you won't see with earlier JVMs. I urge you to use at least version 5.0 of Tomcat; 5.5.x is even better. You also need a text editor of your choice for working with XML.

Obviously, you need Struts installed; if you're unclear on how to install Struts, check out the appendix of Using the Struts Validator, which walks you through the entire process step by step. You can also refer to Resources in this tutorial for several more good links to help you out.

Finally, in this tutorial you'll configure the Struts Online Banking application, described in Programming Jakarta Struts by Chuck Cavaness (see Resources), so you need to obtain and install it as well:

1 of 9 | Next

Comments



Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Java technology, Open source, XML
ArticleID=132325
TutorialTitle=Using multiple Struts configuration files
publish-date=11222005
author1-email=brett@newInstance.com
author1-email-cc=jaloi@us.ibm.com

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).