Summary: This section describes how to prepare and deliver the source code of your JEE application.
Discovery is a process that is actioned during the delivery process. CAST will attempt to automatically identify "projects" within your application using a set of predefined rules. This discovery process also allows CAST AIP to set the initial analysis configuration settings explained in JEE - Analysis configuration. Discoverers are:
You should read the relevant documentation for each discoverer (provided in the link above) to understand how the source code will be handled.
AIP Console expects either a ZIP/archive file or source code located in a folder configured in AIP Console. You should include in the ZIP/source code folder all JEE source code, including JAR files if necessary. CAST highly recommends placing the files in a folder dedicated to JEE and using sub-folders where necessary. If you are using a ZIP/archive file, zip the folders in the "temp" folder - but do not zip the "temp" folder itself, nor create any intermediary folders:
D:\temp |-----JEE-Java |-----OtherTechno1 |-----OtherTechno2
When adding a new version to analyze an Application that includes Maven based source code, you have several choices with regard to specifying where the required Maven repositories are located. The location of the repository is crucial to ensure that any associated JAR files can be automatically discovered and that POM dependencies can also be located. You can do as follows:
D:\temp |-----JEE-Java |-----MavenRepo |-----OtherTechno1
AIP Console will also use the above order to prioritise the various repositories. In other words, if you include a repository in the ZIP or in the designated source code folder this will be used instead of any local or remote repositories that have been defined.
See Configuring source code delivery for Maven for more information.
When adding a new version to analyze an Application that includes JEE based source code and this source code does not contain a .pom or .project file, AIP Console is currently unable to "discover" this code as JEE (AIP Console relies on the presence of the .pom / .project files). In this situation, the source code delivery will end in failure. In order to resolve this issue, you can manually configure AIP Console to install an extension called JEE File Discoverer whenever a .java file is encountered in your delivered source code. This extension will ensure that the required Analysis Units are created for your source code and that an analysis can proceed without issue.
See Configuring source code delivery for JEE without .pom file or .project file for more information.
See How do I add a source code package to my delivery.
When creating packages to discover and extract your JEE application you should create them as listed below:
Source code root folder
Use the "Files on your file system" / SVN / TFS options in the CAST Delivery Manager Tool:
Click to enlarge
|2||Internal/external JAR files||JAR file location|
Use the "Automated extraction of required jar files" options in the CAST Delivery Manager Tool:
This package is generally created after the initial packaging action when the CAST Delivery Manager Tool detects missing items and generates corresponding alerts.
The CAST Delivery Manager Tool offers various exclusion options for JEE applications so that certain projects that may be detected by a discoverer are ignored:
In these situations, CAST highly recommends that you tick the appropriate exclusion rules in the CAST Delivery Manager Tool:
See How do I package the Version for more information.
See How do I fine-tune my Version for more information.
See How do I deliver the Version for analysis for more information.
See Validate and Accept the Delivery for more information.