WOApplication
WOApplication Task Manual
This has been transcribed by Andrew Lindesay from the old WOProject site.
Description
WOApplication is an Ant task to build WebObjects applications from a set of files. It does not enforce any particular project structure and can be used to create applications without using the ProjectBuilder or XCode.
Properties
WOApplication behavior depends on various properties in the wobuild.properties file that specify common locations of the frameworks used by the application. These properties can be initialized with the ant script woproperties.xml. Per default the woapplication task expects this file in $user.home/Library/wobuild.properties. If no file is found the woapplication task resolves the property WOBUILDPROPERTIES from the java properties and the environment(in this order) to find the file.
| Property from the wobuild.properties file | Description | Default |
|---|---|---|
| wo.wosystemroot | Usually this is a WebObjects installation directory, like "C:pple". | NEXTROOT environment variable, or root directory "/". |
| wo.localroot | Usually this is a "Local" directory under the directory specified by "wo.woroot". | $Unknown macro: wo.woroot. Click on this message for details. /Local |
| wo.homeroot | Usually this is a user home directory. | $Unknown macro: user.home. Click on this message for details. |
Parameters
| Attribute | Description | Required |
|---|---|---|
| name | Name of the application (without .woa extension). | Yes |
| chmod | Optional value for the chmod command executed by the WOApplication task. The default is "gu+x". The chmod command is only executed on the first build of the application and only on "Unix" platforms. The default is "750". | No |
| destDir | Destination directory where the application woa should be created. | Yes |
| wsDestDir | Destination directory where WebServerResorces should be copied during split install (presense of this parameter will trigger split install). WebServerResources will be created under wsDestDir/WebObjects/AppName.woa/Contents/. | No |
| principalClass | Subclass of WOApplication to use. | Application |
| customInfoPListContent | String to append to the Info.plist. | No |
| stdFrameworks | If set to true, a set of standard frameworks will be associated with the deployed application (default is true). "Standard" frameworks are: JavaWebObjects, JavaWOExtensions, JavaEOAccess, JavaEOControl, JavaFoundation, JavaJDBCAdaptor, JavaXML. | No |
| jvmOptions | String for the JVM options in the classpath. | No |
| webXML | Generate web.xml | No |
| webXMLWOROOT | Optional parameter for the web.xml | No |
| webXMLLOCALROOT | Optional parameter for the web.xml | No |
| webXMLWOAINSTALLROOT | Optional parameter for the web.xml | No |
| webXMLWOAppMode | Optional parameter for the web.xml | No |
| webXMLWOtaglib | Optional parameter for the web.xml | No |
| webXMLCustomContent | Optional parameter for the web.xml | No |
Nested Elements
classes
The nested classes element specifies a FileSet. All files included in this fileset will end up in the Contents/Resources/Java/.jar file of the application.
resources
The nested resources element specifies a FileSet. All files included in this fileset will end up in the Contents/Resources directory of the application. For the discussion of resource localization issues follow this link.