learntechnology.net

The final ear that is generated should run in most application servers. You might have to add a speicfic xxx-web.xml file for your particular server in the web module and if your underlying ORM framework is not hibernate, you'll need to modify the persistence.xml in the ejb module. This tutorial will describe the setup using JBoss5, but it shouldn't take much to have it working in Glassfish, OC4J, etc

1. Assumes jdk5 or greater is installed and your JAVA_HOME environment variable set.
2. Download and extract Maven2
3. Set an environment variable MAVEN_HOME that points to your installation directory. Also add MAVEN_HOME/bin to your path.
4. Download JBoss5 (at the time of this writing when you click on the Jboss5 download link you'll have an option of downloading a jdk6 version or a standard version. If you are using jdk6 you can use the jdk6 version, otherwise use the standard release. Code for this example was compiled with java5.)
5. Set an environment variable JBOSS_HOME to your installation directory.
6. Unzip the learntechnology-maven-jee source code (From now on this location will be refered to as the "project-dir")
7. In our project-dir/external-resources directory there is a jboss-log4j.xml file. Backup your JBOSS_HOME/server/default/conf/jboss-log4j.xml file and replace it with this one. (Or you can just use the new appender and category that you see in the provided file to your existing jboss-log4j.xml file.)
8. Set up HSQLDB.
   JBoss comes with its own version of HSQLDB, but I'll explain setting up hsqldb as an external db and we'll start it outside of JBoss as well. (Obviously you can use any other database you want, but you'll want to modify the learntechnology-ds.xml file accordingly and you'll need to take a look at the mydb.script to view the simple table created and the few inserts.)
   
   
   • Download HSQLDB and extract to your directory of choice.
   • Put the mysql.script (included in this project's external-resources directory) in the hsqldb/data directory.
   • From the commmand line move to the hsqldb/data directory and run the following command to start the db:

     java -cp ../lib/hsqldb.jar org.hsqldb.Server -database.0 file:mydb -dbname.0 learntechnology_db

9. Copy the project-dir/external-resources/learntechnology-ds.xml file to JBOSS_HOME/server/default/deploy
10. From the command line move to your project-dir and run "mvn clean install" (If you get some errors here make sure you installed maven and set you MAVEN_HOME and added MAVEN_HOME/bin to your environment path.)
11. The above mvn command will have created several target directories and files in the submodules beneath your project-dir. Copy the project-dir/lt-ear/target/learntechnology-maven-jee=1.0.ear to JBOSS_HOME/server/default/deploy
12. From the command line move to JBOSS_HOME/bin and run either the run.sh or run.bat file depending on your OS.
13. Point your browser to http://localhost:8080/lt-web/ and click on the 'view users' link. You should see few users displayed in the resulting jsp.

NOTE ABOUT TESTING: mvn install will run the simple unit test. It also uses a log4j.properties file in test/resources and will output a log file ejb-jar-testing.log inside the lt-ejb module root. The test results will show up in lt-ear/target/surefire-reports. If you want to generate a nicer report, type mvn surefire-report:report from the command line. This will generate an html report called surefire-report.html under lt-ejb/target/site directory. (Running mvn site should generate that file as well, including a larger more complete report. See mvn docs for more info.)

Here is how the project structure is laid out:
Basic:


Expanded:

project parent pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>net.learntechnology</groupId>
  <artifactId>learntechnology-maven-jee</artifactId> 
  <version>1.0</version>
  <packaging>pom</packaging>
  <name>Sample Maven2 JEE Project</name>
  <modules>
    <module>lt-ejb-jar</module>
    <module>lt-web</module>
    <module>lt-ear</module>
  </modules>
  <repositories>
    <repository>
      <id>maven2-repository.dev.java.net</id>
      <name>Java.net Repository for Maven</name>
      <url>http://download.java.net/maven/2/</url>
      <layout>default</layout>
    </repository> 
  </repositories>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>1.5</source>
          <target>1.5</target>
        </configuration>
      </plugin> 
    </plugins>
  </build> 
  <properties>
    <hibernate.show_sql>false</hibernate.show_sql>
    <logging-location>test.log</logging-location>
  </properties>
  <profiles>
    <profile>
      <id>debug</id>
      <properties>
        <hibernate.show_sql>true</hibernate.show_sql>
      </properties>
    </profile>
  </profiles>
  <dependencies>
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.13</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>commons-collections</groupId>
      <artifactId>commons-collections</artifactId>
      <version>3.2</version>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>2.3</version>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>commons-logging</groupId>
      <artifactId>commons-logging</artifactId>
      <version>1.1.1</version>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>javax.ejb</groupId>
      <artifactId>ejb-api</artifactId>
      <version>3.0</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.persistence</groupId>
      <artifactId>persistence-api</artifactId>
      <version>1.0</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>5.8</version>
        <scope>test</scope>
        <classifier>jdk15</classifier>
      </dependency> 
  </dependencies>
</project>

ear pom.xml

<?xml version="1.0"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>net.learntechnology</groupId>
    <artifactId>learntechnology-maven-jee</artifactId> 
    <version>1.0</version>
  </parent>
  <groupId>net.learntechnology</groupId>
  <artifactId>lt-ear</artifactId>
  <version>1.0</version>
  <packaging>ear</packaging>   
  <name>learntechnology-maven-jee :: lt-ear</name>
  <build>
    <finalName>learntechnology-maven-jee-${pom.version}</finalName>
    <plugins>
      <plugin>
        <artifactId>maven-ear-plugin</artifactId>
        <configuration>
          <generateApplicationXml>true</generateApplicationXml>
          <modules>
            <jarModule>
              <groupId>commons-collections</groupId>
              <artifactId>commons-collections</artifactId>
              <includeInApplicationXml>true</includeInApplicationXml>
            </jarModule>
            <jarModule>
              <groupId>commons-logging</groupId>
              <artifactId>commons-logging</artifactId>
              <includeInApplicationXml>true</includeInApplicationXml>
            </jarModule>
            <jarModule>
              <groupId>commons-lang</groupId>
              <artifactId>commons-lang</artifactId>
              <includeInApplicationXml>true</includeInApplicationXml>
            </jarModule>
            <ejbModule>
              <groupId>net.learntechnology</groupId>
              <artifactId>lt-ejb-jar</artifactId>
            </ejbModule>
            <webModule>
              <groupId>net.learntechnology</groupId>
              <artifactId>lt-web</artifactId>
              <contextRoot>/lt-web</contextRoot>
            </webModule>
          </modules> 
        </configuration>
      </plugin> 
    </plugins>
  </build> 
  <pluginRepositories>
    <pluginRepository>
      <id>codehaus snapshot repository</id>
      <url>http://snapshots.repository.codehaus.org/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
    </pluginRepository>
  </pluginRepositories>
  <dependencies>
    <dependency>
      <groupId>commons-collections</groupId>
      <artifactId>commons-collections</artifactId>
      <version>3.2</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>2.3</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>commons-logging</groupId>
      <artifactId>commons-logging</artifactId>
      <version>1.1.1</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>net.learntechnology</groupId>
      <artifactId>lt-ejb-jar</artifactId>
      <type>ejb</type>
      <version>1.0-SNAPSHOT</version>
    </