From a027cd43c351a71064f1763b795abc7c598643b4 Mon Sep 17 00:00:00 2001 From: Kenneth Russel Date: Thu, 5 Jul 2007 16:06:47 +0000 Subject: Added documentation and usage of codebase_lookup=false --- .../jdesktop/applet/util/JNLPAppletLauncher.java | 30 +++++++++++++++++++--- www/index.html | 26 ++++++++++++++++++- 2 files changed, 52 insertions(+), 4 deletions(-) diff --git a/src/org/jdesktop/applet/util/JNLPAppletLauncher.java b/src/org/jdesktop/applet/util/JNLPAppletLauncher.java index 283d2c8..bbb8372 100644 --- a/src/org/jdesktop/applet/util/JNLPAppletLauncher.java +++ b/src/org/jdesktop/applet/util/JNLPAppletLauncher.java @@ -37,8 +37,8 @@ * intended for use in the design, construction, operation or * maintenance of any nuclear facility. * - * $Revision: 1.12 $ - * $Date: 2007/07/04 20:45:31 $ + * $Revision: 1.13 $ + * $Date: 2007/07/05 16:06:47 $ * $State: Exp $ */ @@ -239,6 +239,27 @@ import org.xml.sax.helpers.DefaultHandler; * The examples show how to use the * JNLPAppletLauncher in a few different scenarios. * + *

The codebase_lookup parameter

+ * + *

+ * + * This applet parameter is not currently well documented, but it + * disables certain legacy behavior of the Java Plug-In. Before the + * introduction of jar files, applets used to host their class files + * and resources as flat files on the web server. Once jar files were + * introduced, it was possible to improve the efficiency of resource + * loading for applets, but (apparently) not without breaking + * compatibility. An applet can specify the parameter + * + *

+ * <param name="codebase_lookup" value="false">
+ * 
+ * + *

+ * + * to improve efficiency of its loading if it does not rely on + * fetching flat files from the web server off the codebase. + * *

Applets using the OpenGL(r) 3D API

* *

@@ -301,6 +322,7 @@ import org.xml.sax.helpers.DefaultHandler; * height=480 * codebase="http://download.java.net/media/java3d/applets/applet-test/" * archive="applet-launcher.jar,j3d-examples.jar,j3dcore.jar,j3dutils.jar,vecmath.jar"> + * <param name="codebase_lookup" value="false"> * <param name="subapplet.classname" value="org.jdesktop.j3d.examples.four_by_four.FourByFour"> * <param name="subapplet.displayname" value="Java 3D Four by Four Applet"> * <param name="jnlpNumExtensions" value="1"> @@ -327,6 +349,7 @@ import org.xml.sax.helpers.DefaultHandler; * http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl.jar, * http://download.java.net/media/gluegen/webstart/gluegen-rt.jar, * http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar"> + * <param name="codebase_lookup" value="false"> * <param name="subapplet.classname" value="demos.applets.GearsApplet"> * <param name="subapplet.displayname" value="JOGL Gears Applet"> * <param name="noddraw.check" value="true"> @@ -355,6 +378,7 @@ import org.xml.sax.helpers.DefaultHandler; * http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar, * http://download.java.net/media/joal/webstart/joal.jar, * http://download.java.net/media/joal/webstart/joal-demos.jar"> + * <param name="codebase_lookup" value="false"> * <param name="subapplet.classname" VALUE="demos.applets.GearsJOALApplet"> * <param name="subapplet.displayname" VALUE="JOGL / JOAL Gears Applet"> * <param name="noddraw.check" value="true"> @@ -537,7 +561,7 @@ import org.xml.sax.helpers.DefaultHandler; *

* * The JNLPAppletLauncher was developed by Kevin Rushforth, Kenneth - * Russell, and Chien Yang. It is based on the former + * Russell, and Chien Yang. It is based on the earlier * JOGLAppletLauncher developed by Lilian Chamontin. */ diff --git a/www/index.html b/www/index.html index f86cf22..a2f2ef3 100644 --- a/www/index.html +++ b/www/index.html @@ -162,6 +162,27 @@ The examples show how to use the JNLPAppletLauncher in a few different scenarios. +

The codebase_lookup parameter

+ +

+ + This applet parameter is not currently well documented, but it + disables certain legacy behavior of the Java Plug-In. Before the + introduction of jar files, applets used to host their class files + and resources as flat files on the web server. Once jar files were + introduced, it was possible to improve the efficiency of resource + loading for applets, but (apparently) not without breaking + compatibility. An applet can specify the parameter + +

+ <param name="codebase_lookup" value="false">
+ 
+ +

+ + to improve efficiency of its loading if it does not rely on + fetching flat files from the web server off the codebase. +

Applets using the OpenGL(r) 3D API

@@ -224,6 +245,7 @@ height=480 codebase="http://download.java.net/media/java3d/applets/applet-test/" archive="applet-launcher.jar,j3d-examples.jar,j3dcore.jar,j3dutils.jar,vecmath.jar"> + <param name="codebase_lookup" value="false"> <param name="subapplet.classname" value="org.jdesktop.j3d.examples.four_by_four.FourByFour"> <param name="subapplet.displayname" value="Java 3D Four by Four Applet"> <param name="jnlpNumExtensions" value="1"> @@ -250,6 +272,7 @@ http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl.jar, http://download.java.net/media/gluegen/webstart/gluegen-rt.jar, http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar"> + <param name="codebase_lookup" value="false"> <param name="subapplet.classname" value="demos.applets.GearsApplet"> <param name="subapplet.displayname" value="JOGL Gears Applet"> <param name="noddraw.check" value="true"> @@ -278,6 +301,7 @@ http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar, http://download.java.net/media/joal/webstart/joal.jar, http://download.java.net/media/joal/webstart/joal-demos.jar"> + <param name="codebase_lookup" value="false"> <param name="subapplet.classname" VALUE="demos.applets.GearsJOALApplet"> <param name="subapplet.displayname" VALUE="JOGL / JOAL Gears Applet"> <param name="noddraw.check" value="true"> @@ -460,7 +484,7 @@

The JNLPAppletLauncher was developed by Kevin Rushforth, Kenneth - Russell, and Chien Yang. It is based on the former + Russell, and Chien Yang. It is based on the earlier JOGLAppletLauncher developed by Lilian Chamontin. -- cgit v1.2.3