Skip to Content
Last modified by David Avendasora on 2008/07/01 16:52
From version 5.1
edited by David Avendasora
on 2008/06/25 09:29
Change comment: There is no comment for this version
To version 14.1
edited by David Avendasora
on 2008/06/25 10:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,3 +1,5 @@
1 +This tutorial will help you get a new Java Client or Direct To Java Client Application setup in Eclipse/WOLips and get it building properly.
2 +
1 1  1. Create a new WebObjects Application
2 2  [[image:Picture 9.png]]
3 3  1. Name it "WebStartJNLPTest" in Eclipse with a package of "your.app" {{note title="Note!"}}If you change the Project name or packages, then you'll need to make additional changes in the subsequent steps.{{/note}}
... ... @@ -25,7 +25,9 @@
25 25  
26 26  {{/code}}
27 27  
28 -1. Create a WOComponent named JavaClient
30 +1. Create a WOComponent named "JavaClient".
31 +[[image:Picture 11.png]][[image:Picture 10.png]]
32 +This WOComponent will be what passes the specifics about your client-side application to WebObjects.
29 29  1. Modify the JavaClient.html replacing the contents with:
30 30  
31 31  {{code title="JavaClient.html Contents"}}
... ... @@ -32,14 +32,14 @@
32 32  <WEBOBJECT NAME=JavaClientComponent></WEBOBJECT>
33 33  {{/code}}
34 34  
35 -1. Modify the JavaClient.wod file by adding:
39 +1. Paste the following as the contents of the JavaClient.wod file. Feel free to change the applicationName, applicationDescription and vendor parameters to anything you wish.
36 36  
37 37  {{code title="JavaClient.wod Contents"}}
38 38  
39 39  JavaClientComponent: WOJavaClientComponent {
40 40   applicationClassName = "com.webobjects.eogeneration.EODynamicApplication";
41 - applicationName = "WebStartJBNDTest";
42 - applicationDescription = "WebStartJBNDTest";
45 + applicationName = "D2JC WebStart Test";
46 + applicationDescription = "D2JC WebStart Test";
43 43   downloadClientClasses = "noDownloadClientClasses";
44 44   vendor = "My Company";
45 45  }
... ... @@ -46,9 +46,10 @@
46 46  
47 47  {{/code}}
48 48  
49 -1. Add the following frameworks to the project build path:
53 +{{note title="Note!"}}If you are not creating a Direct To Java Client (D2JC) application, then you will need to replace the applicationClassName parameter (com.webobjects.eogeneration.EODynamicApplication) with the name of your client-side application class. Your non-D2JC client-side Application class *must* subclass EOApplication.{{/note}}
50 50  
51 -{{code}}
55 +1. If you didn't add an EOModel file to the project when you created it, do it now. Drop any existing EOModel in the Resources directory, or create one from scratch.
56 +1. Add the following frameworks to the project build path:
52 52  JavaDirectToWeb
53 53  JavaDTWGeneration
54 54  JavaEOApplication
... ... @@ -63,10 +63,13 @@
63 63  JavaJDBCAdaptor
64 64  JavaWebObjects
65 65  JavaWOExtensions
66 -{{/code}}
67 67  
68 -1. Create a ClasspathClient.txt file in the root of the project and paste the following as contents:
72 +{{note title="Note!"}}
73 + If you are not creating a D2JC application, then you won't need all of these, but they won't hurt anything either.
74 +{{/note}}
69 69  
76 +1. Create a ClasspathClient.txt file in the root of the project and paste the following as contents:{{note title="Note!"}}If you changed the applicaton name in Step 2 above, make sure you change the name of the Client-Side .jar file in the first classpath line below (WebStartJNLPTest.jar). Also be sure to match the case of the project. Client-Side .jar filenames are CamelCase instead of all lowercase as server-side .jar filenames are.{{/note}}
77 +
70 70  {{code title="ClasspathClient.txt File"}}
71 71  
72 72  # ApplicationClass == com.webobjects.eoapplication.client.EOClientApplicationSupport
... ... @@ -95,6 +95,8 @@
95 95  
96 96  {{/code}}
97 97  
106 +This file is only required by the application when it is being launched from within Eclipse.
107 +
98 98  1. Create a javaclientbuild.xml file in root of the project and paste the follwing as contents:
99 99  
100 100  {{code title="javaclientbuild.xml"}}
... ... @@ -157,8 +157,15 @@
157 157  
158 158  {{/code}}
159 159  
160 -1. Right-click on the javaclientbuild.xml file and select "Run As -> Ant Build"
170 +This file is needed to make up for the lack of Java Client application building by the WOLips Incremental Builder. It also copies the client launch scripts into the project so that the application will auto-launch when you run it from within Eclipse. Please follow the [[instructions>>Java Client-WebStart Incremental Build]] for how to create the Java Client Incremental Builder.
171 +
172 +1. If you did not setup the Java Client Incremental Builder, then right-click on the javaclientbuild.xml file and select "Run As -> Ant Build"
173 +[[image:Picture 12.png]]
161 161  1. Right-click on the project and select "Run As -> WebObjects Application"
175 +[[image:Picture 13.png]]
162 162  1. Select your.app.Application as the Application class
163 -1. Copy the Direct Connect URL from the Eclipse console and paste it into your browser. You should get a "click here" link.
164 -1. Click it.
177 +[[image:Picture 14.png]]
178 +1. If you want to actually deploy this application, then you will also need to [[modify the build.xml file>>Java Client-Building]].
179 +This is it. WebStart should automatically download your client application and launch it. If you are creating a D2JC application and did not put an EOModel file in the Resources directory of your project, then you'll see something like this:
180 +[[image:Picture 15.png]]
181 +If you don't want a D2JC application, then you are on your own for creating the user interface for it. Your client-side application can be a command-line or GUI application. If you want a Swing GUI, then I **highly** recommend Florijan Stamenkovic's [[JBND Framework>>http://web.mac.com/flor385/JBND/]]