Skip to Content
Last modified by Lachlan Deck on 2009/03/24 19:05
Hide last authors
Lachlan Deck 60.1 1 Building instructions are in the file BUILD.txt at the top level of the svn checkout.
anjo 48.1 2
Lachlan Deck 60.1 3 [[https:~~/~~/wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder/BUILD.txt>>url:https://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder/BUILD.txt||rel="nofollow" shape="rect" class="external-link"]]
anjo 50.1 4
Lachlan Deck 60.1 5 {{note}}
6 These Maven built directory frameworks are slightly different than the ant built directory frameworks. For example, the Ajax framework has dependencies on json, and the ant built Ajax.framework includes a jabsorb-1.2.2.jar, whereas the Maven built Ajax.framework does not include this jabsorb-1.2.2.jar. This is, of course, because Maven dependencies are detailed in the pom.xml, and will be pulled in via standard Maven mechanisms. The frameworks are not interchangeable~-~-at least without manipulating dependencies. There are also a different number of frameworks.
7 {{/note}}
anjo 50.1 8
Lachlan Deck 60.1 9 Currently (February 2009) the wonder frameworks, applications, etc, can be built for WebObjects 5.3.x or 5.4.x; the choice is made by using a "profile" which has the value of wo53 or wo54, e.g.:
Ulrich Köster 54.1 10
Lachlan Deck 60.1 11 {{code}}
Ulrich Köster 54.1 12
Lachlan Deck 60.1 13 mvn clean install -P wo54
Ulrich Köster 54.1 14
Lachlan Deck 60.1 15 {{/code}}
Ulrich Köster 54.1 16
Lachlan Deck 60.1 17 This installs NSJarBundle frameworks for WebObjects 5.4.x into your ~~/.m2/repository. The frameworks for which the profile, or classifier, was relevant, will appear in your local repository with the profile suffix:
Ulrich Köster 54.1 18
Lachlan Deck 60.1 19 {{code}}
Ulrich Köster 54.1 20
Lachlan Deck 60.1 21 ./repository/wonder/core/ERExtensions/5.0.0-SNAPSHOT/ERExtensions-5.0.0-SNAPSHOT-wo54.jar
Ulrich Köster 54.1 22
Lachlan Deck 60.1 23 {{/code}}
anjo 50.1 24
Lachlan Deck 60.1 25 Note: currently the only frameworks that make use of the classifier, having differing classes and resources for them, are ERExtensions and WOOgnl.
26
27 So, in your project for both ERExtensions and WOOgnl you'll need to define these as dependencies in the following form:
28
29 {{code 0="xml"}}
30
31 <dependency>
32 <artifactId>Foo</artifactId>
33 <groupId>wonder.core</groupId>
34 <classifier>bar</classifier>
35 <version>baz</version>
36 </dependency>
37
38 {{/code}}
39
40 Where //Foo// is either ERExtensions or WOOgnl, //bar// is either wo53, wo54, or wo55 etc, and //baz// is either 5.0.0-SNAPSHOT or some fixed release version.
41
42 For all other wonder frameworks you either leave out the classifier definition or leave it blank. Here's a complete example showing the two frameworks that require a classifier in the dependency declaration together with another that doesn't.
43
44 {{code 0="xml"}}
45 <dependencies>
46 <dependency>
47 <artifactId>ERExtensions</artifactId>
48 <groupId>wonder.core</groupId>
49 <classifier>wo54</classifier>
50 <version>5.0.0-SNAPSHOT</version>
51 </dependency>
52 <dependency>
53 <artifactId>WOOgnl</artifactId>
54 <groupId>wonder.core</groupId>
55 <classifier>wo54</classifier>
56 <version>5.0.0-SNAPSHOT</version>
57 </dependency>
58 <dependency>
59 <artifactId>Ajax</artifactId>
60 <groupId>wonder.ajax</groupId>
61 <version>5.0.0-SNAPSHOT</version>
62 </dependency>
63 </dependencies>
64 {{/code}}
65
66 {{info title="Useful Information: declaring dependencies"}}
67 It is important to understand how dependencies are uniquely resolved when defining your dependencies.
68
69 If you've utilised a dependency management section in your pom (or uppermost parent pom) then, according to [[Maven's Dependency Management>>url:http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Dependency_Management||shape="rect"]], the minimal set of information for matching a dependency reference against a dependencyManagement section is actually **groupId, artifactId, type, classifier**. In many cases, these dependencies will refer to jar artifacts with no classifier. This allows us to shorthand the identity set to **groupId, artifactId**, since the default for the type field is jar, and the default classifier is null.
70
71 Thus, for those wonder dependencies that require a classifier, the set of information required is: **group, artifactId, classifier** which accepts the default type of jar. For those that have no need for a classifier, you'll only need **group, artifactId**.
72
73 (% style="color: red;" %)If you've not used a dependency management section then you'll additionally need to specify the **version** of the dependency in order for it to be resolved.
74
75 You'll notice that the qualifier / classifier is part of the basic artifact coordinate system that the wonder team has chosen to follow:
76 <major version>.<minor version>.<incremental version>-<qualifier>
77
78 For ERExtensions, this is: 5 . 0 . 0-SNAPSHOT - wo54;
79 {{/info}}
80
81 {{note title="Don't trip yourself up"}}
82 Java, of course, can work with anything you choose to place on your classpath. However, it's surely wise to avoid tripping yourself right?! If you're using maven to determine your classpath then I (ldeck) advise – though nothing will stop the unwilling – not additionally using the standard WOLips ant-based dependency management in conjunction with mavens.
83
84 That is to say, you need to understand why this would be a bad idea. Ant-based builds from wonder include their transitive dependencies in their final build; maven's do not because maven is able to resolve dependencies during your build whereas the ant-based builds won't (unless they add ivy or something similar to the mix). WOLips ant-based dependency management has quite entirely different means for resolving its dependencies and as such unless you know what your doing you should avoid mixing and matching systems.
85 {{/note}}
86
87 See the [[Quick Start Guide>>url:http://wiki.objectstyle.org/confluence/display/WOL/Quick+Start||shape="rect"]] for further information on setting up your environment and getting started. Also see [[WOLips Tutorials ~> Maven>>url:http://wiki.objectstyle.org/confluence/display/WOL/Tutorials||shape="rect"]] and other guides for creating applications and frameworks from within eclipse, with or without wonder support, utilizing the maven standard project layout
88
89 See also the [[WOProject-maven2>>url:http://wiki.objectstyle.org/confluence/display/WOL/WOProject-Maven2||shape="rect"]] for various other related wiki pages.