Skip to Content

Java Client-WebStart Distribution Building

Version 25.1 by David Avendasora on 2008/07/17 07:59

Your deployed WebStart-distributed application must have a jar of all the client-side classes (and any subclasses of EOGenericRecord that your client-classes extend) in the Project.woa/Contents/WebServerResources/Java/ directory. If you don't include a jar of your client-side classes in this directory, WebObjects silently uses EOGenericRecord instead. This is made obvious by things like default values, client-side validation and other client-side logic not working in the deployed application.

The following are the instructions when using Ant to build:

  1. Add the following "javaclient" target to your build.xml file.

<target name="javaclient">
    <mkdir dir="${dest.dir}/${project.name}.woa/Contents/WebServerResources/Java"/>
    <jar basedir="${classes.dir}" includes="**/client/**/*.class,**/common/**/*.class"
         jarfile="${dest.dir}/${project.name}.woa/Contents/WebServerResources/Java/${project.name}.jar">
    </jar>

    <!-- project user.d2wmodel file (D2JC only) -->
    <copy file="user.d2wmodel" tofile="${dest.dir}/${project.name}.woa/Contents/Resources/user.d2wmodel"/>

</target>
  1. Make the "build" and "install" targets depend upon "javaclient" just prior to the "ssdd" target.

<target name="build" depends="setProps,init.build,build.woapp,javaclient,ssdd,war" />
<target name="install" depends="setProps,init.install,build.woapp,javaclient,ssdd,war" />
  1. If you are using any Frameworks that have client-side jars then you'll need to copy those jars over to the WebServerResources/Java directory as well. Because I don't want to go modifying any of the woproject files, I just copy the client-side jars of all my Local frameworks (Library/Frameworks/) into my app. Ideally it would only copy over the ones for the frameworks actually in the build path, but this works for now. I'll re-address it after the upcoming classpath changes to be rolled into WOLips.

Add the following code to your build.xml file, right at the end of the ssdd target, but before all the classpath fixes.


<!-- the Java Client Client-Side Classes  -->
<copy todir="${dest.dir}/${project.name}/WEB-INF/${project.name}.woa/Contents/WebServerResources/Java">
<fileset dir="${wo.wolocalroot}/Library/Frameworks">
<include name="**/WebServerResources/Java/*.jar"/>
</fileset>
<mapper type="flatten"/>
</copy>