Getting started

ECForms is a framework to build Java Server Faces web applications using a simple scripting language (IENJINIA Programming Language).

This framework is built on top of Java Server faces and the IENJINIA PROGRAMMING LANGUAGE (http://sourceforge.net/projects/ienjinia) to provide an easy-to-learn environment to develop Java Web applications.

This article has the objective of provide you a brief introduction about how to start using the ECF framework.

  • Step 1. Download the framework !

    Download the ECF-JSF package from:

    http://sourceforge.net/projects/ecforms/

  • Step 2. Learn how to install the framework.

    To install the framework you just need to extract the content of the file downloaded (ECF-JSF-0_2.tar.gz or ECF-JSF-0_2.zip) into the directory of your preference and make sure that your work environment is properly configured with the following development tools:

    • JDK 1.4 or higher
    • ANT 1.6 or higher
    • Java Web Server (recommended: Tomcat 5.0 or higher)

    If you need more information about the installation process, please refer to the following tutorial:

  • Step 3. Create your own project directory using the framework.

    To build a new project "from scratch", execute the following commands inside the directory where you extracted the framework from a system terminal and execute the following commands:

    1. "ant" (or "ant create-project").
      You will be prompted for the following properties:
      • Base directory (from now on )
      • Name of project (from now on )
      • Sample or blank project ( if you want to see some template code and working demos, if you really prefer to start "from scratch")
    2. Change to the new directory to compile, deploy, and test your application: cd /

    If you need more information about this topic, refer to the following manual:

  • Step 4. Start coding your application, compile and deploy it!

    Make the desired changes to the following files:

    • Webapp screenflows: ipl/ecf.ipl
    • Database logic: ipl/db.ipl
    • Static content: resources/*.*
    • Property files (internationalization messages) and Java source files: src/*.*

    If you want to deploy an expanded webapp on Tomcat, use "ant"; if you prefer to create the war file use "ant package".

    Please, refer to the following tutorials if you want to learn more about how to program with ECF:

  • Step 5. Test your application!

    Deploy your application, start up your java web server, and point your browser to http://localhost:8080/project.name

  • Step 6. Learn more about ECF.

    Obtain more benefits from the ECF technology. Lear more about it and increment your productivity. Look at the following tutorials:

Other Stuff

This software is distributed under the terms of the GNU General Public License (see License.txt).

If you want to contribute, go to http://sourceforge.net/projects/ecforms/

For documentation and tutorials, go to http://www.ec-forms.net