Tutorial Example Directory Structure

To facilitate iterative development and keep application source separate from compiled files, the tutorial examples use the Java BluePrints application directory structure.

Each application module has the following structure:

• build.xml: Ant build file

• src/java: Java source files for the module

• src/conf: configuration files for the module, with the exception of web applications

• web: web pages, style sheets, tag files, and images (web applications only)

• web/WEB-INF: configuration files for web applications (web applications only)

• nbproject: NetBeans project files

When an example has multiple application modules packaged into an EAR file, its submodule directories use the following naming conventions:

• example-name-app-client: application clients

• example-name-ejb: enterprise bean JAR files

• example-name-war: web applications

The Ant build files (build.xml) distributed with the examples contain targets to create a build subdirectory and to copy and compile files into that directory; a dist subdirectory, which holds the packaged module file; and a client-jar directory, which holds the retrieved application client JAR.

The tut-install/examples/bp-project/ directory contains additional Ant targets called by the build.xml file targets.

For some web examples, an Ant target will open the example URL in a browser if one is available. This happens automatically on Windows systems. If you are running on a UNIX system, you may want to modify a line in the tut-install/examples/bp-project/build.properties file. Remove the comment character from the line specifying the default.browser property and specify the path to the command that invokes a browser. If you do not make the change, you can open the URL in the browser yourself.