 | Chapter 3 Project Creation |  |
|---|---|---|
| | Chapter 3 Project Creation | |
|---|---|---|
XMA projects are Java projects, which also contains a war
structure and a custom build script to support XMA development. To
create a new XMA project, the eclipse-plugin XMA Project Creation
Wizard should be used. If the plugin is installed correctly, a
special type of Java-Project is supported. You will find it in menu
File->New->Project->Java->New XMA
Project.
![[Tip]](images/tip.png) | |
You can customize the supplied entries for
|
To create a new XMA Project, use the project creation wizard.
The Wizard starts with this dialog, to create "yourProjectName"
Select a name (testapplication in our example) and a file location for your project.
Java Settings - Source
The next wizard page prepares the Java specific settings to
the project. It is highly recommended to keep the names of the
source and output folder as src/ and and
classes/ because the generated build script trust on
this structure.
Java Settings - Libraries
The pre-selected build path list use the variable definitions mentioned in the install topic. The list contains the minimal set of necessary jar files to run/debug a XMA project, whereas the 99er versions of the libraries are used. You may find more about 99er version also in the Install topic.
Custom XMA Project Settings
The next wizard page specifies custom input for the XMA project. Here you could define the name of the webapplication which is part of your application URL. Moreover the plugins.war can be selected which inter alia controls what authentification/authorisation plugin is used. Most often the dummy plugin is used during development, and will be replaced later with a real one. You may found more about XMA plugins in Accessing Plugins.
a new XMA project
The created project includes:
an empty src directory
a script directory, including a build file (ant)
a template for the web application including an basic application descriptor
a empty directory help->at->SPARDAT where you can place your help files (*.html)
The following figure shows the created project structure in eclipse where external libraries are filtered.
The project includes the src folder where 2 packages
are included:
testapplication.example: contains a simple runnable XMA component.
xma.security: in this package the authorisation mappings are defined. More infos about authorisation in XMA you will find in Permissions.
Furthermore the project includes the script folder
where targets for building and deploying the webapplication on the local
tomcat.
The testapplication folder contains the
webapplication and XMA descirptors.
More information about the project structure you will find in Build, Webapp and Deployment.
To start the project template:
Run the launch configuration "start_[projectname]XMAServer" by using the menu: Run/run -> start_[projectname]XMAServer -> Run
Wait until Tomcat is started (you can see it in the window "console"
Run target all for your build.xml. There are many ways to start this dialog:
Right Click on the build.xml file and then "Run Ant..."
Or you can set a View with "Windows/Show View/Ant" and then add the build.xml file from your project. Run the all target by simple double clicking the appropriate icon. Now the webapplication will be buildt.
To deploy the webapplication the first time to Tomcat run target tomcat-deploy. For every further deplyoment is sufficient to run the default target all-undeploy-deploy.
Run the client launch configuration start_[projectname]ExampleClient Run/run -> start_[projectname]ExampleClient
When you get the TestDlg window enter some letters in the textfield and press the ExecuteRPC button to perform your first XMA remote procedure call:
CONGRATULATIONS !!!!
If you can't see this window, please check all the steps explained in this topic. Probably you will see the cause of the problem in the console view or in the Tomcats log files.
| | | |
| 2.4 sIT Solutions Specifics for Core Development |  | Chapter 4 GUIDesigner |
