« Previous • Trail • Next »

Deploying an Applet

To deploy your Java applet, first compile the source code, package it as a JAR file, and sign the JAR file.

Java applets can be launched in two ways.

You can launch an applet by specifying the applet's launch properties directly in the applet tag. This old way of deploying applets imposes severe security restrictions on the applet.
Alternatively, you can launch your applet by using Java Network Launch Protocol (JNLP). Applets launched by using JNLP have access to powerful JNLP APIs and extensions.

The Deployment Toolkit script contains useful JavaScript functions that can be used to deploy applets in a web page.

If you are unfamiliar with these deployment technologies, review the Deployment In-Depth lesson before proceeding further.

Here are some step-by-step instructions to package and deploy your applet. The Dynamic Tree Demo applet is used to illustrate applet deployment. You might want to set up build scripts to execute some of the following steps.

Note: If you don't see the example running, you might need to enable the JavaScript interpreter in your browser so that the Deployment Toolkit script can function properly.

Compile your applet's Java code and make sure all class files and resources such as images are in a separate directory.
In the case of the DynamicTree Demo applet, the compiled classes are placed in the build/classes/appletComponentArch directory.
Create a text file that contains the Permissions and Codebase attributes for the JAR manifest.
For the DynamicTree Demo applet, create a file named mymanifest.txt in the build/classes directory. The applet does not require access to the user's system resources, so use sandbox for the permissions. Use the domain from which you will load the sample for the code base, for example, myserver.com. Add the following attributes to the mymanifest.txt file.
```
Permissions: sandbox
Codebase: myserver.com
```
See the Enhancing the Security of the JAR File lesson to learn more about these manifest attributes.
Create a JAR file containing your applet's class files and resources. Include the manifest attributes in the mymanifest.txt file that you created in the previous step.
For example, the following command creates a JAR file with the class files in the build/classes/appletComponentArch directory and the manifest file in the build/classes directory.
```
% cd build/classes
% jar cvfm DynamicTreeDemo.jar mymanifest.txt appletComponentArch
```
See the Packaging Programs in JAR Files lesson to learn more about creating and using JAR files.
Sign the JAR file for your applet. Signing your applet with a certificate issued by a recognized certificate authority provides your users with assurance that it is safe to run the applet. For testing purposes, you can self-sign the applet, which generates stronger security warnings when the applet is run. For production, use a valid, current code signing certificate issued by a trusted certificate authority.
See the Signing JAR Files lesson for more information.

Create a JNLP file that describes how your applet should be launched.

Here is the JNLP file used to launch the Dynamic Tree Demo applet.

The source for dynamictree_applet.jnlp follows:

    
<?xml version="1.0" encoding="UTF-8"?>
<jnlp spec="1.0+" codebase="" href="">
    <information>
        <title>Dynamic Tree Demo</title>
        <vendor>Dynamic Team</vendor>
    </information>
    <resources>
        <!-- Application Resources -->
        <j2se version="1.6+"
            href="http://java.sun.com/products/autodl/j2se" />
        <jar href="DynamicTreeDemo.jar" main="true" />

    </resources>
    <applet-desc 
         name="Dynamic Tree Demo Applet"
         main-class="components.DynamicTreeApplet"
         width="300"
         height="300">
     </applet-desc>
     <update check="background"/>
</jnlp>

Note that the security element for requesting additional permissions is not present in the JNLP file, therefore the applet runs only in the security sandbox.

The topic, Structure of the JNLP File, describes JNLP file syntax and options.

Create the HTML page that will display the applet. Invoke Deployment Toolkit functions to deploy the applet.

In our example, the Dynamic Tree Demo applet is deployed in AppletPage.html.

<body>
    <!-- ... -->
    <script src="http://www.java.com/js/deployJava.js"></script>
    <script> 
        var attributes = {
            code:'components.DynamicTreeApplet',  width:300, height:300} ; 
        var parameters = {jnlp_href: 'dynamictree_applet.jnlp'} ; 
        deployJava.runApplet(attributes, parameters, '1.6'); 
    </script>
    <!-- ... -->
</body>

Place the applet's JAR file, JNLP file and HTML page in the appropriate folder(s).
For this example, place DynamicTreeDemo.jar, dynamictree_applet.jnlp, and AppletPage.html in the same directory on the local machine or a web server. A web server is not required for testing this applet.
Open the applet's HTML page in a browser to view the applet. Agree to run the applet when prompted. Check the Java Console log for error and debugging messages.

Download source code for the Dynamic Tree Demo Applet example to experiment further.

« Previous • Trail • Next »