Skip to Content

Changes for page WOApplication

Last modified by Andrew Lindesay on 2011/07/17 09:52
From version 21.1
edited by cmeyer
on 2007/11/07 20:32
Change comment: Documented default value for FrameworksBaseURL
To version 19.1
edited by pgr
on 2010/01/14 21:04
Change comment: typo

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.cmeyer
1 +XWiki.pgr
Content
... ... @@ -12,7 +12,7 @@
12 12  
13 13  |= Property from the wobuild.properties file |= Description |= Default
14 14  | wo.wosystemroot | Usually this is a WebObjects installation directory, like "C:pple". | NEXT//ROOT environment variable, or root directory "/". //
15 -| wo.localroot | Usually this is a "Local" directory under the directory specified by "wo.woroot". | $wo.woroot/Local
15 +| wo.wolocalroot | Usually this is a "Local" directory under the directory specified by "wo.woroot". | $wo.woroot/Local
16 16  | wo.homeroot | Usually this is a user home directory. | $user.home
17 17  
18 18  == Parameters ==
... ... @@ -65,14 +65,39 @@
65 65  
66 66  The nested ##frameworks## is a [[FrameworkSet>>WOProject-FrameworkSet]] structure that specifies the names of the WebObjects Frameworks that this application is dependant upon. The jar files from these frameworks will be referenced in varios platform-specific depoyment files (such as CLASSPATH.TXT), and specified in the web.xml classpath if an application is deployed as a servlet. When building a FileSet, path should match up to the "**.framework" directory (no need to match individual JAR files).**
67 67  
68 +To embed frameworks set embed to true.
69 +
70 +{{note title="Nov13/08 email from Kieran Kelleher" bgColor="#FFFFCE"}}
71 +
72 +Q: _Kieran Kelleher_
73 +With regards the woapplication task and nested elements, what does the eclipse="true" attribute of the 'frameworks' nested element do?
74 + {{<frameworks dir="ProjectLocal" embed="$\{embed.ProjectLocal}" eclipse="true" />}}
75 +
76 +A: _Mike Schrag_
77 +eclipse="true" makes the <frameworks> tag parse your .classpath file to determine framework dependencies.
78 +{{/note}}
79 +
68 68  === lib ===
69 69  
70 70  The nested lib element specifies a [[FileSet>>http://jakarta.apache.org/ant/manual/CoreTypes/fileset.html]]. This should be a fileset of jar libraries required by your application. All files in this fileset will end up in the ##Resources/Java## folder of the application, and will be included on the classpath for this application.
71 71  
84 +To embed jars set embed to true.
85 +
72 72  === otherclasspath ===
73 73  
74 -? What does this do ?
88 +This nested element is used to add an arbitrary directory or file path to the runtime classpath. For example on Mac OS X, the directory at APPROOT/Resources/SSLKeyStore/ can be added to the runtime classpath by doing something like this:
75 75  
90 +{{code}}
91 +
92 +<woapplication>
93 + [...]
94 + <otherclasspath dir="." embed="true">
95 + <include name="Resources/SSLKeyStore" />
96 + </otherclasspath>
97 +</woapplication>
98 +
99 +{{/code}}
100 +
76 76  == Examples ==
77 77  
78 78  Create an application "MyApp" with a set of standard frameworks:
... ... @@ -113,3 +113,16 @@
113 113  </woapplication>
114 114  
115 115  {{/noformat}}
141 +
142 +Create an application "MyApp" with embedded frameworks:
143 +
144 +{{noformat}}
145 +
146 +<woapplication name="MyApp" destDir="${dist}/WebObjects/Applications">
147 + ...
148 + <frameworks dir="../Frameworks"embed="true">
149 + <include name="**/*.framework"/>
150 + </frameworks>
151 +</woapplication>
152 +
153 +{{/noformat}}