how to setup a basic struts project using eclipse ide - apache struts

How to setup a basic Struts project using Eclipse IDE - Apache Struts

FAQs

● Kickstart

● Newbie

● How to Help

Howto Guides

● Action Forms

● Building Apps

● Database

● Indexed Properties

● SSL

● Struts-EL (JSTL)

IDE Guides

● Eclipse

● Netbeans

Quick Links

● Welcome

● User and Developer Guides

Contributors

● James Mitchell

How to setup a basic Struts project using Eclipse IDE

Legal Disclamer

http://struts.apache.org/struts-doc-1.2.x/faqs/eclipse.html (1 of 26)24-Dec-05 8:01:05 PM

http://apache.org/

http://struts.apache.org/struts-doc-1.2.x/faqs/kickstart.html

http://struts.apache.org/struts-doc-1.2.x/faqs/newbie.html

http://struts.apache.org/struts-doc-1.2.x/faqs/helping.html

http://struts.apache.org/struts-doc-1.2.x/faqs/actionForm.html

http://struts.apache.org/struts-doc-1.2.x/faqs/apps.html

http://struts.apache.org/struts-doc-1.2.x/faqs/database.html

http://struts.apache.org/struts-doc-1.2.x/faqs/indexedprops.html

http://struts.apache.org/struts-doc-1.2.x/faqs/ssl.html

http://struts.apache.org/struts-doc-1.2.x/faqs/struts-el.html

http://struts.apache.org/struts-doc-1.2.x/faqs/netbeans.html

http://struts.apache.org/struts-doc-1.2.x/index.html

http://struts.apache.org/struts-doc-1.2.x/userGuide/index.html

* DISCLAIMER - This simple How-To shows you one of many ways to setup a working project usingthe Struts framework. This is mainly geared toward struts users who are new to Eclipse, anddon't want to spend a lot of time figuring out the differences between their old IDE (if any)and this one.

I will also apologize ahead of time for the formatting of this page.

In this How-To, I will demonstrate (using Eclipse 2.0.1) how to setup, compile, run,and debug the struts-example web application that is bundled with the distribution.

Next, I will modify the code to pull some data from a MySql database using the popular relational mapping tool OJB. (This is actually quite simple)

Let's get started

Before we begin, you will need to create a directory somewhere to store your project.I typically use C:\personal\development\Projects\(some project)Once that's done, extract the struts-example.war to that directory (using your favorite zip utility)

Delete the META-INF folder because this will be created during the build/jar/war process.Add a build.xml file to the project root. I use something like this:

<project name="Struts Example" default="main" basedir=".">



 <property environment="env"/>

<property file="./build.properties"/>

<property name="tomcat.home" value="${env.CATALINA_HOME}"/> <property name="servlet.jar" value="${tomcat.home}/common/lib/servlet-api.jar"/> <property name="jsp.jar" value="${tomcat.home}/common/lib/jsp-api.jar"/> <property name="deploy.dir" value="${tomcat.home}/webapps"/> <property name="build.compiler" value="modern"/> <property name="build.dir" value="./WEB-INF/classes" /> <property name="src.dir" value="./WEB-INF/src"/> <property name="war.file" value="struts-example"/> <property name="war.file.name" value="${war.file}.war"/>

<path id="project.class.path"> <fileset dir="./WEB-INF/lib/"> <include name="**/*.jar"/> </fileset> <pathelement path="${src.dir}"/> <pathelement path="${servlet.jar}"/> <pathelement path="${jsp.jar}"/> </path>

<target name="clean"> <delete dir="${build.dir}" includeEmptyDirs="true" /> </target>

<target name="prep"> <mkdir dir="${build.dir}"/> </target>

<target name="compile">


1. Create a new project.

2. New Java Project



3. Browse for the folder you created for your project.



4. Eclipse will detect your source folders from any subdirectories under your project.



5. In our case, this is where the src folder was placed.



6. Default standard libs are automatically added depending on the type of project.



7. Add the existing web app jars.



8. Now we need to add a few jars from the file system.



9. We always need this one (servlet.jar)



10. Ahhhh...everything looks ok for now. You can always go back and modify these settings later.



11. When everything settles down, you should see something like this (of course, it might look different depending on your installation/customization):



12. Compilation warnings and errors are detected immediately. In this screenshot, I drill downinto the source folder, package, file, class, and double click on the method....which brings up the source editor. I hover the mouse over the offending warning to see a description of what's wrong.



13. I changed ApplicationConfig to ModuleConfig, then saved and now I see new errors.You can right click and import ModuleConfig right from the error.

14. A quick look at the import section.



15. Right click, Source, Organize Imports

16. Ahhhh...better



17. From the Package Explorer, right click your build.xml and run Ant:

18. Is this cool or what?



19. Uh Oh!



20. Quick look at what jars are being used to process my build.



21. I simply removed all the existing jars from the IDE's Ant configuration andadded all from my own installation.



22. Can't forget that last one



23. Everything went ok (for me)



24. Time to test-drive



Copyright (c) 2000-2005, The Apache Software Foundation - Comments?


http://wiki.apache.org/struts/StrutsDocComments

how to setup a basic struts project using eclipse ide - apache struts

Documents

basic struts project

struts framework

struts users

new project

working project

project root

type of project

properties ssl struts