You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- 0.2 Updating instructions to use custom property to specify lib locations instead of adding libs manually
9
9
- 0.3 Adding Maven
10
10
11
-
## Prerequisites
11
+
## Installation
12
12
13
-
This assumes you have Eclipse 3.6+, m2e Maven plugin, and Maven installed and configured
14
-
for your development environment
13
+
### In Eclipse
14
+
15
+
This assumes you have Eclipse 3.6+, m2e Maven plugin, Maven, and Git installed.
15
16
16
17
- Eclipse can be downloaded at: http://download.eclipse.org
17
18
- Maven can be downloaded at: http://maven.apache.org/download.html
18
19
- m2e Maven plugin comes with Eclipse 3.7+ and can be installed for older versions by going to Help > Eclipse Marketplace and typing 'm2e'
19
-
20
-
### Mac OS X
21
-
22
-
23
-
## Environment
20
+
- Git can be downloaded at: http://git-scm.com/download
24
21
25
22
It is recommended you set up your environment in the following manner:
26
23
@@ -36,26 +33,37 @@ It is recommended you set up your environment in the following manner:
36
33
37
34
3. Create a "workspace" folder in your java folder. This will be the root of your Eclipse workspace.
38
35
When you start Eclipse for the first time, tell it to use this folder as the workspace folder. If
39
-
you are already using Eclipse and have already designated a workspace folder, you can continue using
40
-
that folder.
41
-
42
-
Next we will bring the project into Eclipse. To do this:
36
+
you are already using Eclipse and have already designated a workspace folder, you can continue using that folder.
37
+
38
+
Then you need to install 2 additional connectors from the m2e Marketplace in Eclipse:
39
+
40
+
1. File > Import > Check out Maven Projects from SCM > Next
41
+
2. Click "m2e Marketplace" link
42
+
3. Select the de.theit.m2e.axistools and m2e-egit connectors from the m2e Marketplace
43
+
4. Click Finish
44
+
5. Follow the prompts to install these connectors
45
+
6. Restart Eclipse once these are done installing
46
+
47
+
Once Eclipse restarts:
48
+
49
+
1. File > Import > Check out Maven Projects from SCM > Next
50
+
2. Select "git" from the dropdown
51
+
3. Enter git://github.com/hannonhill/Webservices-Java-Sample-Project.git into the Git URL field
52
+
4. Click Next
53
+
5. Click Finish
43
54
44
-
1. Unzip/move the contents of this zip file to your Eclipse workspace directory.
45
-
2. Import the project into Eclipse by choosing File -> Import -> General -> Existing Projects into Workspace
46
-
and choosing the "Cascade Webservices" folder (this is the root of the project).
55
+
This will import and build the project in Eclipse.
47
56
48
-
After this you should see the Cascade Webservices project show up in your Eclipse window. Do not be alarmed if
49
-
there are compilation errors, this is because you still need to generate the Java client stubs for interacting
50
-
with the web services layer.
57
+
Once built, use Git to checkout the appropriate branch of this project for your Cascade installation. For example, if you're running Cascade version 6.8.3, checkout 6.8.x: `git checkout 6.8.x`
51
58
52
-
To do this:
59
+
To update the generated Web Services stubs to correspond to your version of Cascade:
53
60
54
61
1. Open the WSDL from your Cascade Server instance by going to: http://<your-cascade-url>/ws/services/AssetOperationService?wsdl
55
62
2. Save this as a file "asset-operation.wsdl".
56
63
3. Replace the "asset-operation.wsdl" file in src/java/wsdl inside the eclipse project with your own file.
57
-
4. Open a command-line/terminal window to run maven.
58
-
5. Navigate to to the base directory where the project was unzipped to (e.g. java/workspace/Cascade Webservices) and type the command "maven generate-sources"
64
+
4. In Eclipse, right-click the project and click Refresh. Maven should run and regenerate your stubs based on this updated WSDL file.
65
+
5. If for some reason it doesn't, open a command-line/terminal window to run maven.
66
+
6. Navigate to to the base directory where the project was created to (e.g. java/workspace/Cascade Webservices) and type the command "maven generate-sources"
59
67
You should see a successful ant build similar to:
60
68
61
69
$ maven generate-sources
@@ -77,14 +85,113 @@ You should see a successful ant build similar to:
6. Refresh the project by right clicking on the project and selecting "Refresh".
88
+
89
+
7. Then, refresh Eclipse and your project should be built.
90
+
91
+
### With Git and Maven only
92
+
93
+
This assumes you have Maven 3+ and Git installed.
94
+
95
+
- Maven can be downloaded at: http://maven.apache.org/download.html
96
+
- Git can be downloaded at: http://git-scm.com/download
97
+
98
+
Clone the project:
99
+
100
+
1. Clone this repository: git clone [email protected]:hannonhill/Webservices-Java-Sample-Project.git
101
+
2. Change into the directory for the newly created project
102
+
3. Use Git to checkout the appropriate branch of this project for your Cascade installation. For example, if you're running Cascade version 6.8.3, checkout 6.8.x: `git checkout 6.8.x`
82
103
83
-
At this point Eclipse will re-build the project for you. You should not see any red x's
84
-
on any files (which indicate java compilation errors).
104
+
Update the Web Services stubs:
105
+
106
+
1. Open the WSDL from your Cascade Server instance by going to: http://<your-cascade-url>/ws/services/AssetOperationService?wsdl
107
+
2. Save this as a file "asset-operation.wsdl".
108
+
3. Replace the "asset-operation.wsdl" file in src/java/wsdl inside the eclipse project with your own file.
109
+
4. Open a command-line/terminal window to run maven.
110
+
5. Navigate to to the base directory where the project was unzipped to (e.g. java/workspace/Cascade Webservices) and type the command "mvn generate-sources"
0 commit comments