helloopensource

hellowaffle

Page history last edited by paulo 2 yrs ago

Hello Waffle

This Tutorial will show you how to create and deploy a simple java web application using Waffle, Eclipse Web Tools Platform (WTP) and Tomcat Web Server.

Main Learning's

After following this tutorial you will learn how to:
Download and install Waffle
Create a simple Java web project using Waffle
Run a Waffle sample Web application on the Tomcat server within WTP
Create a WAR file and deploy it on Tomcat
Run the Waffle sample Web application in Tomcat

Versions used:

OS: Windows XP V1.6
JDK version 1.5.0_12
Apache Tomcat v 5.5.23
WTP - Web Tools Platform All-In-One Packages - R2.0 (from June 26, 2007)
Waffle 1.0-beta-1 (28 July 2007)

Assumptions:

Common Issue:

Incorrect Tomcat installation directory on WTP

Tutorial Steps:

Go to the Waffle download web site: http://waffle.codehaus.org/download.html
Download the latest Waffle stable version (E.g. waffle-distribution-1.0-beta-1-bin.zip)
Create a waffle folder under C:\Program Files\ (or wherever you want)
Unzip waffle-distribution-1.0-beta-1-bin.zip to C:\Program Files\waffle
Extract to C:\Program Files\waffle
Open Eclipse WTP
Create a New Project
1. Select File/New/Project…
3. Select Dynamic Web Project
4. Click on Next>
6. Select a Project name (E.g. helloWaffle)
7. Make sure Apache Tomcat 5.5 is selected as the Target Runtime
8. Click on Finish
Add waffle lib to the build path
2. Select User Library
4. Select User Library
5. Click Next>
6. Click on User Libraries…
8. User Library name: waffle
9. Click on OK
11. Click on Add JARS…
12. Select all jar files under <waffle_dir?/lib (E.g. C:\Program Files\waffle\waffle-1.0-beta-1\lib)
14. Click on Open
16. Click on OK
18. Click on Finish
19. A User Librry named waffle have been created and added to helloWaffle project build path.
Create a Controller
2. Create HelloWorldController
4. Class Name: HelloWorldController
5. Package name: com.hellopensource.waffle
6. Click on Finish
8. Add getGree getGreeting() to HelloWorldController class
9. public String getGreeting() {
  
  return "Hello World!";
  
  }
Create a Registrar
2. Create MyRegistrar Class
4. Class Name: MyRegistrar
5. Package name: com.hellopensource.waffle
6. Click on Finish
7. Add the following code to MyRegistrar
8. package com.hellopensource.waffle;
  
  import org.codehaus.waffle.registrar.AbstractRegistrar;
  
  import org.codehaus.waffle.registrar.Registrar;
  
  public class MyRegistrar extends AbstractRegistrar {
  
       public MyRegistrar(Registrar delegate) {
  
            super(delegate);
  
       }
  
       public void application() {
  
            register("hello", HelloWorldController.class);
  
       }
  
  }
Create a jpsx page - the View
3. File name: hello.jspx
4. Click on Finish
6. Replace the generated code by the following code:
7. <?xml version="1.0" encoding="UTF-8"?>
  
  <html xmlns="http://www.w3.org/1999/xhtml"
  
        xmlns:jsp="http://java.sun.com/JSP/Page">
  
  <jsp:output doctype-root-element="html"
  
              doctype-public="-//W3C//DTD XHTML 1.0 Transitional//EN"
  
              doctype-system="http://www.w3c.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"/>
  
  <jsp:directive.page contentType="text/html;charset=UTF-8"/>
  
  <head></head>
  
  <body>
  
  <h1>${controller.greeting}</h1>
  
  </body>
  
  </html>
Update web.xml
1. Open the current web.xml (located under WebContent/WEB-INF)
3. Replace web.xml by the following content:
4. <?xml version="1.0" encoding="UTF-8"?>
  
  <web-app version="2.4"
  
         xmlns="http://java.sun.com/xml/ns/j2ee"
  
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
  
  <display-name>Waffle Example</display-name>
  
  
  
  <context-param>
  
      <param-name>org.codehaus.waffle.registrar.Registrar</param-name>
  
      <param-value>com.hellopensource.waffle.MyRegistrar</param-value>
  
  </context-param>
  
  
  
  <listener>
  
      <listener-class>org.codehaus.waffle.context.pico.PicoWaffleContextListener</listener-class>
  
  </listener>
  
  
  
  <filter>
  
      <filter-name>WaffleRequestFilter</filter-name>
  
      <filter-class>org.codehaus.waffle.context.WaffleRequestFilter</filter-class>
  
  </filter>
  
  <filter-mapping>
  
      <filter-name>WaffleRequestFilter</filter-name>
  
      <url-pattern>*.action</url-pattern>
  
  </filter-mapping>
  
  
  
  <servlet>
  
      <servlet-name>waffle</servlet-name>
  
      <servlet-class>org.codehaus.waffle.servlet.WaffleServlet</servlet-class>
  
      <init-param>
  
        <param-name>view.suffix</param-name>
  
        <param-value>.jspx</param-value>
  
      </init-param>
  
      <load-on-startup>1</load-on-startup>
  
  </servlet>
  
  <servlet-mapping>
  
      <servlet-name>waffle</servlet-name>
  
      <url-pattern>*.action</url-pattern>
  
  </servlet-mapping>
  
  </web-app>
Add waffle JAR files to WebContent/Web-INF/Lib
1. Copy the waffle JAR files
3. Paste it on WebContent/Web-INF/Lib
Run hello.jspx on Toncat within WTP
1. Select hello.jspx / Run as > Run on Server
3. Click on Finish
5. Rename the url (on WTP) from http://localhost:8587/helloWaffle/hello.jspx to http://localhost:8587/helloWaffle/hello.action
6. Press Enter