<?php
    require_once 'common.php'
?>
<html>
    <head>
        <title>J2EE Setup Tutorial</title>
    </head>
    <body>
        <?php homeLink(); ?>
        <h1>J2EE Setup Tutorial</h1>
        <h3>Version 1.5</h3>
        <h3>Last Updated: September 24, 2011</h3>
        <h2>Introduction</h2>
        <p>
            This tutorial documents the process of setting up a relatively simple J2EE application in Eclipse using the following technologies:
        </p>
        <ul>
            <li>Eclipse 3.7 (Indigo)</li>
            <li>JBoss AS 5.1</li>
            <li>Spring 3.0.6</li>
            <li>Hibernate (bundled with JBoss)</li>
        </ul>
        <p>
            The primary function for this tutorial is to serve as a starting point for small J2EE projects such as are found in academic environments.  The end goal is to permit students to focus more on application logic implementation and less on the nuances of configuration for each of these valuable technologies.
        </p>
        <p>
            Note that the screenshots accompanying these instructions were taken on a Debian Linux machine under KDE 4.4 in September 2011.  Depending on your operating system or the version of your software, these screenshots may look somewhat or very different when compared to your own experience.  It is also possible that pathnames may be in a different format; for instance, Windows users will need to use Windows-style pathnames.  Please adjust these steps according to your environment as necessary.
        </p>
        <h2>Update: August 2012</h2>
        <p>
            This tutorial was tested again with the following technologies:
        </p>
        <ul>
            <li>Eclipse 4.2 (Juno)</li>
            <li>JBoss AS 5.1</li>
            <li>Spring 3.1.2</li>
            <li>Hibernate</li>
        </ul>
        <p>
            The tests were successful with only one caveat.  When installing JBoss Tools, one should use the following update site: <tt>http://download.jboss.org/jbosstools/updates/development/juno</tt>  The software packages to be installed are JBoss Application Development and JBoss Web and Java EE Development.  Other than this adjustment, the remainder of the tutorial should work fine.
        </p>
        <p>
            It should be emphasized that this tutorial will <b>not</b> work with JBoss 7.0 or JBoss 7.1.  These JBoss versions have been tested; they fail to deploy the application and produce errors which are difficult to diagnose at best.
        </p>
        <hr/>
        <h2>Table of Contents</h2>
        <ol start="0">
            <?php
                require_once 'contents.php';
                for ($idx = getFirstEntryIndex(); $idx <= getLastEntryIndex(); $idx += 1)
                {
                    echo '<li><a href="page.php?p=' . strval($idx) . '">';
                    echo getEntryName($idx);
                    echo "</a></li>\n";
                }
            ?>
        </ol>
        <hr/>
        <?php footer(); ?>
    </body>
</html>
