Quick Start - XWiki

(% class="auto-cursor-target" %)

You should be able to get a "Hello, World!" Wonder application running using [[Maven>>https://maven.apache.org]] in about 10 minutes.

3

4

(% id="HAssumptions" class="auto-cursor-target" %)

5

= Assumptions =

6

7

We're going to make a few assumptions to keep this page brief:

8

9

1. You are running macOS X. You can probably get a WebObjects development environment up on a different OS, but we won't cover that here.

10

1. You have Java installed. Any version will do. People are running WebObjects on Java 21 in production.

11

1. You have Eclipse and WOLips installed. Install the [[latest version of Eclipse>>https://www.eclipse.org/downloads/packages/]], along with the [[latest WOLips>>https://github.com/wocommunity/wolips]] if you haven't already.

12

13

(% id="HSetup" class="auto-cursor-target" %)

14

= Setup =

15

16

(% class="auto-cursor-target" %)

17

You need to install Maven:

18

19

(% class="auto-cursor-target" %)

20

{{{$ cd ~/Applications

21

$ curl -O https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.zip

22

$ unzip apache-maven-3.9.9-bin.zip

23

$ ln -s apache-maven-3.9.9 apache-maven

24

}}}

25

26

Add ##bin## to your path in your shell's startup file, say ##~~/.zshrc##:

27

28

{{{PATH=$PATH:/Users/paulh/Applications/apache-maven-3.9.9/bin

29

}}}

30

31

(% class="auto-cursor-target" %)

32

Confirm you have it installed:

33

34

(% class="auto-cursor-target" %)

35

{{{$ mvn --version

36

Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)

37

}}}

38

39

(% class="auto-cursor-target" %)

40

Finally, add ##~~/.m2/settings.xml##:

41

42

(% class="auto-cursor-target" %)

43

{{{<settings xmlns="http://maven.apache.org/POM/4.0.0"

44

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

45

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

46

http://maven.apache.org/xsd/settings-1.0.0.xsd">

<id>wocommunity</id>

</activation>

<id>wocommunity</id>

<url>https://maven.wocommunity.org/content/groups/public/</url>

</releases>

</snapshots>

</repository>

</repositories>

<id>wocommunity</id>

<url>https://maven.wocommunity.org/content/groups/public/</url>

</releases>

<enabled>false</enabled>

74

</snapshots>

75

</pluginRepository>

76

</pluginRepositories>

</profile>

</profiles>

</settings>

}}}

(% id="HCreateanewapplicationproject" class="auto-cursor-target" %)

83

= Create a new application project =

84

85

(% class="auto-cursor-target" %)

86

Make a new directory somewhere, and run:

87

88

{{{$ mvn archetype:generate -DarchetypeArtifactId=erxapplication-archetype \

89

-DarchetypeGroupId=org.wocommunity \

90

-DarchetypeVersion=3.0 -DaskForDefaultPropertyValues=true}}}

91

92

(% class="auto-cursor-target" %)

93

After some downloading, Maven will prompt you:

94

95

(% class="auto-cursor-target" %)

96

{{{Define value for property 'JavaVersion' 1.8: : 1.8

97

Define value for property 'WonderVersion' 7.2: : 7.4

98

Define value for property 'groupId': example.app

99

Define value for property 'artifactId': Foo

100

Define value for property 'version' 1.0-SNAPSHOT: : 0.1-SNAPSHOT

101

Define value for property 'package' example.app: : example.app.foo}}}

102

103

104

You can enter any version of Java. You should definitely change ##WonderVersion## from 7.2 → 7.4. Hit 'Y' to confirm when requested.

105

106

(% class="box infomessage" %)

107

(((

108

If you enter a ##JavaVersion## greater than 1.8 (there are people using Java 21 in production, for example: enter ##21##), you need to add the following line to build.properties:

109

\\##jvmOptions=~-~-add-exports java.base/sun.security.action=ALL-UNNAMED ~-~-add-exports java.base/sun.util.calendar=ALL-UNNAMED##

)))

(% id="HBuildandlaunchtheapplication" class="auto-cursor-target" %)

114

= Build and launch the application =

115

116