Java Web Start (Jnlp) Hello World Example

this tutorial shows you how to create a java web start (jnlp) file for user download.  when the user clicks on the downloaded jnlp file, it launches a simple awt program. here's the summary steps :

1. create a simple awt program and jar it as testjnlp.jar
2. add keystore into testjnlp.jar
3. create a jnlp file
4. put it all into the tomcat folder
5. access testjnlp.jar from web through http://localhost:8080/test.jnlp

before starting this tutorial, lets read this brief java web start explanation from oracle.

java web start is a mechanism for program delivery through a standard web server. typically initiated through the browser, these programs are deployed to the client and executed outside the scope of the browser. once deployed, the programs do not need to be downloaded again, and they can automatically download updates on startup without requiring the user to go through the whole installation process again.

ok, let's go ~

1. install jdk and tomcat

install java jdk/jre version above 1.5 and tomcat.

2. directory structure

directory structure of this example.

3. awt + jnlp

see the content of testjnlp.java, it's just a simple awt program with jnlp supported.

package com.mkyong;import java.awt.*;import javax.swing.*;import java.net.*;import javax.jnlp.*;import java.awt.event.actionlistener;import java.awt.event.actionevent;public class testjnlp {  static basicservice basicservice = null;  public static void main(string args[]) {    jframe frame = new jframe("mkyong jnlp unofficial guide");    frame.setdefaultcloseoperation(jframe.exit_on_close);    jlabel label = new jlabel();    container content = frame.getcontentpane();    content.add(label, borderlayout.center);    string message = "jnln hello word";        label.settext(message);    try {      basicservice = (basicservice)        servicemanager.lookup("javax.jnlp.basicservice");    } catch (unavailableserviceexception e) {      system.err.println("lookup failed: " + e);    }    jbutton button = new jbutton("http://www.mkyong.com");    actionlistener listener = new actionlistener() {      public void actionperformed(actionevent actionevent) {        try {          url url = new url(actionevent.getactioncommand());          basicservice.showdocument(url);        } catch (malformedurlexception ignored) {        }      }    };    button.addactionlistener(listener);    content.add(button, borderlayout.south);    frame.pack();    frame.show();  }}

p.s if "import javax.jnlp.*;" is not found, please include the jnlp library which islocated at jre/lib/javaws.jar.

4. jar it

located your java classes folder.  jar it with following command in command prompt

jar -cf testjnlp.jar *.*

this will package all the java's classes into a new jar file, named " testjnlp.jar ".

5. create keystore

add a new keystore named " testkeys "

keytool -genkey -keystore testkeys -alias jdc

it will ask for a keystore password, first name, last name , organization's unit...etc..just fill them all.

6. assign keystore to jar file

attached newly generated keystore " testkeys " to your " testjnlp.jar " file

jarsigner -keystore testkeys testjnlp.jar jdc

it will ask password for your newly created keystore

7. deploy jar it

copy " testjnlp.jar " to tomcat's default web server folder, for example, in widnows - c:\program files\apache\tomcat 6.0\webapps\root

8. create jnlp file

create a new test.jnlp file, content put this

<?xml version="1.0" encoding="utf-8"?><jnlp spec="1.0+" codebase="http://localhost:8080/" href="test.jnlp">    <information>        <title>jnlp testing</title>        <vendor>yong mook kim</vendor>        <homepage href="http://localhost:8080/" />        <description>testing testing</description>    </information>    <security>        <all-permissions/>    </security>    <resources>        <j2se version="1.6+" />        <jar href="testjnlp.jar" />    </resources>    <application-desc main-class="com.mkyong.testjnlp" /></jnlp>

9. deploy jnlp file

copy test.jnlp to your tomcat default web server folder also. c:\program files\apache\tomcat 6.0\webapps\root

10. start tomcat

start tomcat , c:\tomcat folder\bin\tomcat6.exe
 

11. test it

access url http://localhost:8080/test.jnlp , it will prompt you to download the test.jnlp file, just accept and double click on it.

if everything went fine, you should see the following output

click on the "run" button to lauch the awt program.

note

if jnlp has no response, put the following code in your web.xml , which is located in the tomcat conf folder.

<mime-mapping>   <extension>jnlp</extension>   <mime-type>application/x-java-jnlp-file</mime-type></mime-mapping>