Table of contents

  1. Purpose
  2. Requirements
  3. Get started
  4. Deploying
  5. The structure
  6. The RIFE project

A. Purpose

This package is meant to give you a headstart whenever you need to begin with a new web application that builds on RIFE and Laszlo.

Everything is set up to provide you with a comfortable development structure and to make the packaging of your work as easy as possible.

Note that you should never apply this setup to a production environment since it's only applicable in cases where there's only one application running inside a servlet container.

[ top ]

B. Requirements

These requirements need to be fulfilled before you can get started immediately:

Please refer to the documentation of these tools to get them installed correctly on your machine.

It's possible to use any development tool. The ones above been selected since they are the most common and make it possible to easily distribute a working machine-independent project configuration.

[ top ]

C. Get started

By following the steps below you'll quickly be able to test a small sample application with your development environment of choice.

1. Apache Ant 1.6

2. Omnicore Codeguide 7

3. X-develop 1.1 build 163

4. IntelliJ IDEA 4.5

5. NetBeans 4.1

6. Eclipse 3.x

[ top ]

D. Deployment

RIFE/Laszlo is ready to package your application as a war archive for easy deployment in any servlet container.

The Laszlo application is compiled in SOLO mode, so the proxy server will not be included in the war file. The application will be a regular flash file that works completely independently of the OpenLaszlo server.

You need Apache Ant 1.6 to package the application and perform the following steps:

E. The structure

The application's sources

src
 |
 +- rep

The rep.xml file that sets up the repository and all the XML files that are required by the participants that are started.

 |
 +- sites

The site structures that define the logic flow and data flow of your application.

 |
 +- elements

The element declarations that are used in the site structures.

 |
 +- implementations

The implementations that provide business logic to the elements.

 |
 +- templates

The templates that are used by the implementations to output content to the user.

 |
 +- java

Java source code that provided back-end logic for your element implementations.

Website files

web
 |
 +- WEB-INF

The web application directory.

 |
 +- signup.lzx

The Laszlo application.

 |
 +- formfield.lzx
 +- formlabel.lzx

The Laszlo application libraries.

 |
 +- images

The images that are used by the Laszlo application.

The application's libraries

lib

[ top ]

F. The RIFE project

The downloads are available at Downloads.

The examples can be tried online at http://rifers.org/examples.

The users guide can be read online at http://rifers.org/docs/usersguide.

The API documentation can be read online at http://rifers.org/docs/api.

The issue-tracker is available at http://servlet.uwyn.com/issues.

The wiki is available at http://rifers.org/wiki.

The mailinglists are set up at Uwyn, the following are available:

Real-time chatting about RIFE can be done through IRC at irc.freenode.net in the channel #rife.