Models in Apollo for Eclipse

Apollo stores the UML 2 models in files named 'model.auml'; for reverse-engineered source code, these are located by default in the source folder of the corresponding Java package. For referenced types, i.e. types not contained in the project, for example in a JAR in the classpath, the UML2 mols are stored in a folder named .model in the root directory of the project by default.

Canonical package diagrams are stored in 'model.auml_diagram'; non-canonical class diagrams are stored in '<packagename>.class_diagram'.

The model files of classes contained in the Java Runtime Environment version 1.4 and 1.5 are delivered with Apollo. If you are using another JRE version, you can generate the corresponding model files using the "Reverse engineer Java Runtime" action from the context menu of the project.

By default, this will generate a new project named com.gentleware.uml2.jre<version> containing the model files. The location of the JRE models can be configured in Window->Preferences->Apollo->JRE models.


Apollo does not store the IDs of the UML2 elements in source codes as other tools do. If you are working in a team using a versioning system, we strongly recommend committing all UML2 model files in order to keep the IDs betweeen the different team members in sync.

Model File Storage

The location of the model file storage can be set at the workspace or at the project level.

Workspace Level - The location specified for the workspace is applied to all projects within that workspace. The settings may be changed from Window->Preferences->Apollo->Model location. The new location will automatically be created in each project of the workspace.

Project Level - To specify the storage location of a single project, right-click on the root of the package in the Package Explorer and select Properties->Model location. Enable the project setting to activate the text fields. A location set at the project level overrides the workspace level setting.