Directory Layout
This page describes the directory layout in each of the Subversion trunks (separate IDEA projects) that are part of the Subversion repository of the Sourceforge DOMS project.
Top level
The top level directory has the following:
<IDEAprojectname>.ipr - The IDEA project file
<IDEAprojectname>.iml - The IDEA virtual project module file
LICENSE - A text file containing the Apache License version 2.0
NOTICE - A text file containing attribution notices (see Apache 2.0 License)
README - A text file giving an overview of this IDEA project, including this directory explanation, as well as info on how the project is used and further developed by contributers.
qascan.xml - Configuration file for automated code QA checking
build.xml - Project ant targets
build.properties - Project ant target properties
build-includes.xml - Generally useful ant code. This should be the same for every sourceforge package.
build-rest-webservices.xml - Optional - webservice-related ant code. This should be the same for every sourceforge package.
build-soap-webservices.xml - Optional - webservice-related ant code. This should be the same for every sourceforge package.
docs/ - A folder for general project documentation - anarchy governs this directory
lib/ - A folder for project libraries (see the [#lib lib/] section below)
bin/ - Scripts for the project
modules/ - A folder containing any number of modules and/or module groups
And not in SVN:
<IDEAprojectname>.iws - IDEA workspace configuration file
Module groups
A module group is a directory with name <modulegroupname> in lower case, containing the following:
<modulegroupname>.iml - The IDEA module group file.
- A number of directories, each a module or module group.
Modules
Each module, with name <modulename>, is contained in a directory named after the module - module names are in lower case. This directory contains the following:
<modulename>.iml - The IDEA module file, module names are lower case
data/ - Optional - a folder for data belonging to the module - anarchy reigns
docs/ - A folder for module documentation - anarchy governs this directory
lib/ - A folder for module libraries (see the [#lib lib/] section below)
config/ - Folder with module configuration files
src/ - Module java source
test/ - Unit tests for java source
test/data - Data used by unit tests
bin/ - Scripts for the module
web/ - Contains a WEB-INF directory and potentially jsp- and html-files for the module
build.xml - Module ant targets
build.properties - Optional - module ant target properties
build-rest-webservices.xml - Optional - webservice-related ant code. This should be the same for every sourceforge package.
build-soap-webservices.xml - Optional - webservice-related ant code. This should be the same for every sourceforge package.
And not in SVN:
classes/ - Folder for generated class files
classes-test/ - Folder for generated class files for junit test cases
apidocs/ - Folder for generated javadoc
dist/ - Folder with generated Release packages (see the [#dist dist/] section below)
lib/
Contains a directory for each library-package we use, with directory name of the style <libraryname>-<version>, for example fedora-client-3.2.1. Each of these directories contain the following subdirectories:
jars/ - contains all jar-files in the package
apidocs/ - contains zipfiles with apidocs for the package itself, as well as potentially docs for the libraries the package depends on.
src/ - contains zipfiles with sources for the package itself, as well as potentially sources for the libraries the package depends on.
license/ - contains all license-information contained in the package
Each lib must be accompanied by license, and preferably includes apidocs and src for the package itself.
dist/
Contains generated zip-files (from ant target), see [:ModuleReleaseStructure: module release structure] and [:Ant: Ant] guidelines.