AndroMDA would be very difficult to grasp without at least one sample application. Therefore, the distribution includes several:
The models and source code of each sample are located within the samples directory of the AndroMDA binary and source distributions.
The src directory of each module described below (excluding the mda module which is a special case) contains the sources that have been hand coded, most of them were generated by AndroMDA the first run and then they had business or custom logic hand-coded in.
Each sample is made up of the modules explained here:
This is the most important module, as it contains the project's model. This module is used by AndroMDA to generate code into all other modules.
What happens within this module is this:
Contains files required to create the ear bundle. Typically you will find application deployment descriptors in this directory, as well as DDL scripts to initialize/drop your schema (if you're using hibernate/spring).
Contains common sources that can be shared between the different modules in the project. Typically you will find utility classes in this directory.
Contains the persistence and business/transaction management layer. This contains generated source from either the hibernate, spring, or ejb cartridges.
Contains sources required to build the presentation layer.
Contains any source, descriptors, or other necessary files required for webservice support.
Its very easy to build all samples or just one at a time. First of all you MUST install Maven2. To build all, just change to the samples directory, and type mvn. To build a single sample (i.e. animal-quiz), just change to the samples/animal-quiz directory and again type maven. That's all there is too it!
After the build of a sample completes, you'll notice each module contains a target directory, this target directory contains all generated source, any class files, any generated descriptors, etc. (i.e. anything that has been generated/created during the build process which will NOT be checked into source control).
Once built, you'll find each deployable ear file located in the /app/target directory. Each ear can deployed by dropping it in the deploy directory of a JBoss application server instance.
In case of difficulties, please view the forum at http://forum.andromda.org and post your questions there.