Chapter 2. Download and Installing

JBoss Microcontainer 2.0.0 is currently only available as a beta release via Maven2. This means that you need to install and configure Maven before you can begin development. Once this is done then you can create a maven project that depends on the JBoss Microcontainer JARs in order to download and install them into your local maven repository. You can then create an assembly for your final application in order to package the relevant JARs into a distributable format.

The examples created for this User Guide use Maven2 to achieve exactly this so it is highly recommended that you download these first and take a look at how they work.

Note

To build and run the examples you first need to install and configure Maven 2.0.7 available from http://maven.apache.org/

Installation is performed by downloading and unzipping the maven-2.0.7-bin.zip file to a convenient location on your local disk. Configuration consists of adding $MAVEN_HOME/bin to your path and adding the following profile to your ~/.m2/settings.xml file:


<settings>

  <profiles>

    <profile>

      <id>jboss.repository</id>

      <activation>

        <property>          

          <name>!jboss.repository.off</name>

        </property>

      </activation>

      <repositories>

        <repository>

          <id>snapshots.jboss.org</id>

          <url>http://snapshots.jboss.org/maven2</url>

          <snapshots>

            <enabled>true</enabled>

          </snapshots>

        </repository>

        <repository>

          <id>repository.jboss.org</id>

          <url>http://repository.jboss.org/maven2</url>

          <snapshots>

            <enabled>false</enabled>

          </snapshots>

        </repository>

      </repositories>

      <pluginRepositories>

        <pluginRepository>

          <id>repository.jboss.org</id>

          <url>http://repository.jboss.org/maven2</url>

          <snapshots>

            <enabled>false</enabled>

          </snapshots>

        </pluginRepository>

        <pluginRepository>

          <id>snapshots.jboss.org</id>

          <url>http://snapshots.jboss.org/maven2</url>

          <snapshots>

            <enabled>true</enabled>

          </snapshots>

        </pluginRepository>

      </pluginRepositories>

    </profile>

  </profiles>

</settings>

This profile informs maven of the two JBoss repositories (snapshots and releases) that are needed to download the JBoss Microcontainer and dependant JARs.

Once you have configured Maven and downloaded the examples then you can go to one of the following subdirectories in the examples/User_Guide directory and enter mvn install to perform a build:

gettingStarted - projects for creating and using a service together with AOP
pojoDevelopment - examples of creating and configuring POJOs using XML and annotations
aopDevelopment - examples of using AOP to add behaviour to POJOs
extending - examples of how we created various extensions to the microcontainer by creating new dependencies

Instructions on how to run the individual examples can be found in the corresponding parts of this guide.