JOSIF Project Creator

JOSIF Main Page | Getting Started | JOSIF Project Creator

Project Creator / installer

Overview

The TIP Project Creator automatically generates archetype maven projects for implementors of the TIP framework. The created projects will have the full build system set up to download the correct model dependencies and Tigerstripe dependencies (generators and profiles) from maven.

Downloading

JOSIF release 1.1.1

  • The JOSIF release 1.1.1 Project Creator is available from the Sourceforge file downloads page or for direct download click JOSIF Rel 1.1.1 TIP Project Creator (3.4 MB). Use this to create new projects which use JOSIF Release 1.1.1 generators. It can also help to generate build files which will help you update previous projects

JOSIF release 1.1.2 Snapshot

Old Releases

The released 1.0.0 project creator is downloadable from the sourceforge openoss file releases ( front page of the project).

  • The JOSIF release 1.1.0 Project Creator is available from the Sourceforge file downloads page or for direct download click JOSIF Rel 1.1.0 TIP Project Creator (3.4 MB). Use this to create new projects which use JOSIF Release 1.1.0 generators. It can also help to generate build files which will help you update previous projects

Usage

1. Place the installer into the workspace where you want to create a new project

2. Open terminal in the workspace and run the installer using java -jar TIP_Project_Creator-standard.jar and work through the wizard setting project details for the project you want to be created. After reaching the end of the project creator wizard, several project will be created in your workspace

3. Open Tigerstripe for this workspace. No project will show up which is normal.

4. In the Windows/ Preferences of Tigerstripe, go to Java / Installed JREs and validate that it points to the jdk installed. If not, change it to point to the java jdk installed on the machine.

5. In the Windows/ Preferences of Togerstripe, go to Java/ Build Path/ Classpath Variables. Add the variable M2_REPO pointing the directory .m2/repository under your username, e.g. C:\Users\cgallen\.m2\repository

6. Close Tigerstipe.

7. Open a terminal in the folder named <PROJECT NAME>_BaseProject in the newly populated workspace

8. Run eclipse:eclipse - this will probably only partly complete and will fail due to missing profles, plugins and generated dependencies etc. This is OK.

9. Open eclipse in the workspace and import the new projects which eclipse:eclipse was able to create using the 'import existing projects into the workspace' dialogue. Eclipse should find the BaseProject and Model project.

10. Shutdown eclipse and return to the terminal window you opened in <PROJECT NAME>_BaseProject

11. Run mvn clean install - after a while the project should complete successfully.

12. Run mvn eclipse:eclipse again to make the remaining modules into eclipse projects. This should now complete successfully.

13. Import all of the remaining projects into the workspace.

Notes
1. - sometimes if you have Eclipse running, you will get an error 'could not delete directory' or such like when you run the maven build. If this happens, shutdown/restart Eclipse and run mvn clean install again.

2. - By default the Java implementation projects are disabled. To build and test these you should uncomment the implementation modules in the
<modules> section of the Base Project's pom.xml file.

3. - Generating code: Starting of the newly created empty projects, you can develop your the tigerstripe model. When ever you want to generate code from the model run mvn clean install in the <PROJECT NAME>_BaseProject. If after generating the code, you run mvn eclipse:eclipse again, this will import the newly generated jars into the workspace as referenced dependencies of the <PROJECT NAME>_EJBImpl_Project