Java Client and Direct To Java Client Example Project using WebStart
Version 25.1 by David Avendasora on 2008/06/25 10:06
- Create a new WebObjects Application
- Name it "WebStartJNLPTest" in Eclipse with a package of "your.app" The [note] macro is a standalone macro and it cannot be used inline. Click on this message for details.
- Modify the Main.html by adding:
Main.html Changes
<WEBOBJECT NAME=JavaClientLink>click here</WEBOBJECT>
- Modify the Main.wod file by adding:
Main.wod Changes
JavaClientLink: WOHyperlink {
href = javaClientLink;
}
href = javaClientLink;
}
- Modify the Main.java file by adding:
Main.java Changes
public String javaClientLink() {
return WOJavaClientComponent.webStartActionURL(context(), "JavaClient");
}
- Create a WOComponent named "JavaClient".
This WOComponent will be what passes the specifics about your client-side application to WebObjects. - Modify the JavaClient.html replacing the contents with:
JavaClient.html Contents
<WEBOBJECT NAME=JavaClientComponent></WEBOBJECT>
- 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.
JavaClient.wod Contents
JavaClientComponent: WOJavaClientComponent {
applicationClassName = "com.webobjects.eogeneration.EODynamicApplication";
applicationName = "D2JC WebStart Test";
applicationDescription = "D2JC WebStart Test";
downloadClientClasses = "noDownloadClientClasses";
vendor = "My Company";
}
- 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.
- Add the following frameworks to the project build path:
JavaDirectToWeb
JavaDTWGeneration
JavaEOApplication
JavaEOControl
JavaEODistribution
JavaEOGeneration
JavaEOInterface
JavaEOInterfaceSwing
JavaEOProject
JavaEORuleSystem
JavaFoundation
JavaJDBCAdaptor
JavaWebObjects
JavaWOExtensions
- Create a ClasspathClient.txt file in the root of the project and paste the following as contents:The [note] macro is a standalone macro and it cannot be used inline. Click on this message for details.
ClasspathClient.txt File
# ApplicationClass == com.webobjects.eoapplication.client.EOClientApplicationSupport
# JDB == jdb
# JDBOptions ==
# JVM == java
# JVMOptions ==
APPROOT/WebServerResources/Java/WebStartJNLPTest.jar
/System/Library/Frameworks/JavaFoundation.framework/WebServerResources/Java/JavaFoundation.jar
WOROOT/Library/Frameworks/JavaEOControl.framework/WebServerResources/Java/JavaEOControl.jar
WOROOT/Library/Frameworks/JavaXML.framework/WebServerResources/Java/JavaXML.jar
WOROOT/Library/Frameworks/JavaDirectToWeb.framework/WebServerResources/Java/JavaDirectToWeb.jar
WOROOT/Library/Frameworks/JavaEOApplication.framework/WebServerResources/Java/JavaEOApplication.jar
WOROOT/Library/Frameworks/JavaEODistribution.framework/WebServerResources/Java/JavaEODistribution.jar
WOROOT/Library/Frameworks/JavaEOGeneration.framework/WebServerResources/Java/JavaEOGeneration.jar
WOROOT/Library/Frameworks/JavaEOInterface.framework/WebServerResources/Java/JavaEOInterface.jar
WOROOT/Library/Frameworks/JavaEOInterfaceSwing.framework/WebServerResources/Java/JavaEOInterfaceSwing.jar
WOROOT/Library/Frameworks/JavaEORuleSystem.framework/WebServerResources/Java/JavaEORuleSystem.jar
WOROOT/Library/Frameworks/JavaWOJSPServlet.framework/WebServerResources/Java/JavaWOJSPServlet_client.jar
HOMEROOT/Library/Java
LOCALROOT/Library/Java
WOROOT/Library/Java
/Network/Library/Java
WOROOT/Library/Frameworks/JavaVM.framework/Classes/classes.jar
WOROOT/Library/Frameworks/JavaVM.framework/Classes/ui.jar
- Create a javaclientbuild.xml file in root of the project and paste the follwing as contents:
javaclientbuild.xml
<project name="javaclient" default="javaclient" basedir=".">
<target name="setProps">
<property file="${user.home}${file.separator}build.properties"/>
<property file="build.properties"/>
<property file="${user.home}${file.separator}Library${file.separator}wobuild.properties"/>
<condition property="wo.properties.check.failed">
<not>
<and>
<isset property="wo.wosystemroot"/>
<isset property="wo.wolocalroot"/>
</and>
</not>
</condition>
<fail message="Could not find ${user.home}${file.separator}Library${file.separator}wobuild.properties." if="wo.properties.check.failed"/>
</target>
<target name="javaclient" depends="setProps">
<mkdir dir="build/${project.name}.woa/Contents/WebServerResources/Java"/>
<!-- project client-side classes -->
<copy todir="build/${project.name}.woa/Contents/WebServerResources/Java/">
<fileset dir="${classes.dir}">
<include name="**/client/**/*.class,**/common/**/*.class,**/BMGenericRecord.class"/>
<exclude name="**/server/**/*.class"/>
</fileset>
</copy>
<jar basedir="${classes.dir}"
includes="**/client/**/*.class,**/common/**/*.class,**/BMGenericRecord.class"
excludes="**/server/**/*.class"
jarfile="build/${project.name}.woa/Contents/WebServerResources/Java/${project.name}.jar">
</jar>
<!-- Launch Scripts and WOBootstrap.jar-->
<mkdir dir="build/${project.name}.woa/Contents/MacOS"/>
<mkdir dir="build/${project.name}.woa/Contents/UNIX"/>
<mkdir dir="build/${project.name}.woa/Contents/Windows"/>
<copy file="/Library/Application Support/Apple/Developer Tools/WebObjects Support/UnixLaunch.sh"
tofile="build/${project.name}.woa/Contents/${project.name}"/>
<chmod file="build/${project.name}.woa/Contents/${project.name}" perm="ugo+rx"/>
<copy file="/Library/Application Support/Apple/Developer Tools/WebObjects Support/WinLaunch.CMD"
tofile="build/${project.name}.woa/Contents/${project.name}.CMD"/>
<copy file="/Library/Application Support/Apple/Developer Tools/WebObjects Support/WOBootstrap.jar"
tofile="build/${project.name}.woa/Contents/WOBootstrap.jar"/>
<copy file="/Library/Application Support/Apple/Developer Tools/WebObjects Support/UnixLaunchClient.sh"
tofile="build/${project.name}.woa/Contents/MacOS/${project.name}_Client"/>
<chmod file="build/${project.name}.woa/Contents/MacOS/${project.name}_Client" perm="ugo+rx"/>
<copy file="ClasspathClient.txt" tofile="build/${project.name}.woa/Contents/MacOS/ClasspathClient.txt"/>
<copy file="/Library/Application Support/Apple/Developer Tools/WebObjects Support/WinLaunch.CMD"
tofile="build/${project.name}.woa/Contents/Windows/${project.name}.CMD"/>
</target>
</project>
This file is needed to make up for the lack of Java Client application building by the WOLips Incremental Builder. Please follow the instructions for how to create the Java Client Incremental Builder.
- If you did not setup the Java Client Incremental Builder, then right-click on the javaclientbuild.xml file and select "Run As -> Ant Build"
- Right-click on the project and select "Run As -> WebObjects Application"
- Select your.app.Application as the Application class
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:
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