Java Client-Additional Files and Settings

Version 10.1 by David Avendasora on 2009/01/22 08:11
Warning
For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Launching your WebStart-based client-side application from within Eclipse/WOLips

There are two key files that help with launching your WebStart-based Java Client application from within WOLips.

  1. The Client Launch Script. This script allows Eclipse to automatically lanuch the client-side application for you when you run the application from within Eclipse. Without this scrip you will get the following message in the console and the application will revert to launching the non-JC way of opening a web browser and loading the Main component. 

Unable to locate client launch script in your application,
using the Auto Open In Browser feature instead of the Auto Open Client Application feature.

Which means that you will still be able to launch your client-side application by clicking on the link for it in your web browser, it's just not as convenient as having the application launch immediately upon running.
Apple includes this script with WebObjects (/Library/Application Support/Apple/Developer Tools/WebObjects Support/UnixLaunch.sh). 

  1. The Client-Side Classpath File (ClasspathClient.txt). This file defines the classpath for all the .jars that need to be available for the client-side application to download from the server. Right now this file is not automatically created by the build process so you have to manually maintain it. If this file is not present or if there are errors in it, you will likely not be able to launch your client-side application using the Launch Script.

Both of these files need to be copied into your build directory as part of the incremental build process. This is already documented in the Java Client-WebStart Incremental Build page.

If everything is setup correctly, when you run your project in Eclipse/WOLips you will see the following in the console:

Unknown macro: noformat. Click on this message for details.