DeployJava.js uses doc.write() - why?

Question

I'm probably asking in the wrong place, but why does deployJava.js use doc.write() to create the applet tag?
I don't know what authority iof any w3schools.com may have for example, but it states that "the entire HTML page will be overwritten if document.write() is used inside a function, or after the page is loaded."
This means for example that a JSF page that conditionally displays a call to runApplet(), e.g. as the result of an Ajax transaction, will not work: the entire page content is indeed overwritten and my poor users are getting a blank page instead of a rather heavily populated page containing a new applet after pushing a certain button.
I'm reluctant to deploy my own version of deployJava.js but in the presence of this problem I may have to. Surely there is a better technique available? JQuery has innerHTMLI() for example, that must map to something in the Javascript space.

Answer 1

Comments so far:
1. I am embedding the applet in a page served via HTTPS. I therefore need to load java.com/js/dtjava.js via HTTPS to avoid mixed-content warnings. When I do that I get a browser intervention because the site's certificate isn't valid for java.com, only for *.java.com. Fixing the URL to https://www.java.com/js/dtjava.js avoids that. However the dtjava.js file has internal references to http://java.com which need the same treatment.
2. The variable 'platform' is mis-spelt in the link provided.
3. FireFox Error Console reports the following:
Warning: function aj does not always return a value
Source File: https://www.java.com/js/dtjava.js
Line: 1, Column: 11305
Warning: redeclaration of function ap
Source File: https://www.java.com/js/dtjava.js
Line: 1, Column: 18985
Warning: reference to undefined property at.url
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property at.url
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property top.execScript
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: assignment to undeclared variable v
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: assignment to undeclared variable v
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: assignment to undeclared variable c
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: assignment to undeclared variable p
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: reference to undefined property az[ay]
Source File: https://www.java.com/js/dtjava.js
Line: 1
Warning: assignment to undeclared variable p
Source File: https://www.java.com/js/dtjava.js
Line: 14. Example 5.1 appears to be incorrect or incomplete, and no other specification of how to construct a dtjava.App object is provided. I get error messages like
Warning: Error in parsing value for 'width'.  Declaration dropped.
Source File: https://localhost:8443/vContent/test/applet/ssh.jsf?tag=dtjava
Line: 0
Warning: Error in parsing value for 'height'.  Declaration dropped.
Source File: https://localhost:8443/vContent/test/applet/ssh.jsf?tag=dtjava
Line: 0using width and height as per that example. I looked in the source code to establish that there are two parameters: a URL and a set of properties. A 'placeholder' property is mandatory when using embed(), although not specified.
5. The documentation for onGetSplash() fails to mention that the 'HTML snippet' must have width and height attributes.
If this is the reference material it is entirely inadequate. If it isn't the reference material, it MUST contain a link to the reference material, using MUST in the same way as in RFCs.
It really astonishes me that Sun/Oracle is still dithering about how best to deploy applets after fourteen years.
I attach my entire Javascript:
<div id="SSH_applet_container">
     <script type="text/javascript" src="#{request.scheme}://www.java.com/js/dtjava.js"></script>
     <script>
          function deployIt()
               var platform = new dtjava.Platform({ jvm: "1.5+" });
               var event = dtjava.validate(platform);
               if (event != null)
                    alert("Java Platform problem: "+event+". Your browser support="+!event.isUnsupportedBrowser());
               // Undocumented, but first param is URL, 2nd is a set of properties that must include width, height, and placeholder for embed().
               var app = new dtjava.App(
                    'ssh.jnlp',
                         id: 'SSH',
                         width: 100,
                         height: 25,
                         placeholder: 'SSH_applet_container',
                         params:
                              config: 'ssh_applet.conf',
               dtjava.embed
                    app,
                    platform,
          dtjava.addOnloadCallback(deployIt);
     </script>
</div>