Java Web Start 入门基础教程

Java Web Start 入门基础教程 

关于Web Start的JNLP Specification可以到sun网站http://java.sun.com/products/javawebstart/download-spec.html下载。 
下面是用最简单的HelloWorld方法实现一个Java Web Start的例子，工程webstart目录结构如下： 


目录说明如下： 
images ：存放*.jnlp文件中定义的图标文件 
jar ：存放classes打包后的jar文件 
jnlp ：存放*.jnlp描述文件 
src ：java源码 
WEB-INF/classes ：java编译后的class文件 

webatart 建立步骤如下： 
1 ．在webstart/src/jws下新建一HelloWorld.java文件： 
package jws; 
import javax.swing.*; 
public class HelloWorld { 
    private JFrame jFrame; 
    private JPanel jPanel; 
    private JLabel label; 

    public HelloWorld(){ 
        jFrame = new JFrame("HelloWorld Test Frame"); 
        label = new JLabel("Hello, world!"); 
        jPanel = new JPanel(); 
        jPanel.add(label); 
        jFrame.add(jPanel); 

        jFrame.pack(); 
        jFrame.setSize(400, 150); 
        jFrame.setLocation(400, 300); 
        jFrame.setVisible(true); 
        jFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 
    } 

// webstart 启动时执行的主方法 
    public static void main(String args[]){ 
        new HelloWorld(); 
    } 

} 

注： 在main方法中完全可以不用写new HelloWorld();，而只在main方法中输出一条测试语句 
System.out.println("This is test!"); 
进行简单测试，打印结果会出现在步骤7java控制台中 

2 ．编译HelloWorld.java，在WEB-INF/classes目录下执行命令： 
jar cvf helloworld.jar jws/*.class 
执行后把生成的helloworld.jar包拷贝到webstart/jar/jws目录下。 
（在IDEA中打包使用Jar Tool插件比较方便，eclipse中可以使用Fatjar） 

3 ．从helloworld.jar/META-INF中解压出MNIFEST.MF，更改MNIFEST.MF内容： 
Manifest-Version: 1.0 
Created-By: 1.5.0_01 (Sun Microsystems Inc.) 
为： 
Manifest-Version: 1.0 
Created-By: 1.5.0_01 (Sun Microsystems Inc.) 
Main-Class: jws.HelloWorld 
然后在WEB-INF/classes目录下执行命令： 
jar umf MANIFEST.MF helloworld.jar 
把新的MNIFEST.MF更新到helloworld.jar包中， 

注： 如果在下面步骤4中的<application-desc main-class="jws.HelloWorld"/>指定了Main-Class方法，此步骤可以省略。 

4 ．webstart/jnlp目录下新建一HelloWorld.jnlp文件： 
<?xml version="1.0" encoding="UTF-8"?> 
<!--codebase 属性指出搜索应用程序资源的顶级URL,下面的icon/jar元素都是以这个URL为基本.--> 
<jnlp codebase="http://127.0.0.1:8081/webstart"> 
    <information> 
        <!-- 在"开始"-"运行"菜单中输入"javaws"或"javaws -viewer"启动Web Start,会看到客户端已经安装的webstart应用程序--> 
        <!--title ：应用程序标题 vendor：供应商 
        title/vendor 元素必须，会显示在用"javaws -viewer"命令 
        打开的应用程序缓存查看器（Java Application Cache Viewer）中--> 
        <title>HelloWorld</title> 
        <vendor>Lively Corporation</vendor> 
        <description>HelloWorld Test Example for WebStart.</description> 
        <!--homepage ：存放有关应用程序的相关文档的URL，如help文件等，仅仅是description作用--> 
        <homepage href="http://127.0.0.1:8081/webstart/index.html"/> 
        <!--icon 指定图标会显示在应用程序缓存查看器中， 
        在查看器中新建webstart快捷方式到桌面时也会显示为快捷方式图标， 
        只支持GIF/JPEG格式，其它格式无效--> 
        <icon href="./images/logo.jpg"/> 
        <!--splash 在sun的文档中提到会出现在webstart启动时的闪屏中，不过可能由于速度问题，我没有观察到--> 
        <icon kind="splash" href="./images/logo.jpg"/> 
         <!-- 允许离线启动，可以使用javaws -offline命令--> 
        <offline-allowed/> 
    </information> 
    <resources> 
        <!-- 指定客户端需要安装的j2se版本，下面指定为1.5+， 
        如果版本是1.4，在链接此jnlp文件时会提示更新j2se版本--> 
        <j2se version="1.5+"/> 
        <!-- 指定要下载到本地的jar文件(注意，所有的文件都需要打包才能够下载)， 
        可以包含一些资源文件，如icons/configuration files，可以使用getResource方法取得--> 
        <jar href="./jar/jws/helloworld.jar"/> 
    </resources> 
    <!--application-desc 必须，指定webstart启动时执行jar文件中的哪个类--> 
    <application-desc main-class="jws.HelloWorld"/> 
</jnlp> 

注： 
其中*.jnlp文件的语法的详细信息可以在sun网站上查询http://java.sun.com/j2se/1.5.0/docs/guide/javaws/developersguide/syntax.html 
其中javaws命令行的详细参数可以在sun网站上查询http://java.sun.com/j2se/1.5.0/docs/guide/javaws/developersguide/javaws.html#options 

5 ．webstart目录下建一index.html 
内容如下 
<a href="jnlp/HelloWorld.jnlp">HelloWorld</a> 
  
6 ．因为是web应用，所以webstart/WEB-INF建一web.xml文件， 
内容为： 
<web-app> 
</web-app> 
即可，启动tomcat时默认会去找index.html文件 
  
7 ．webstart工程放入tomcat/webapps，启动tomcat即可。 
启动后会看到helloworld的swing弹出窗口，还有如下图会有一个java控制台（如果没有出现，可在"控制面板"——"java控制面板"——"高级"——"Java控制台"中勾选"显示控制台"单选框）： 
   
  
  
如果要在HelloWorld.java中对本地文件进行操作，就必须对jar文件进行签名，具体步骤如下: 
1.     在HelloWorld.java的main方法中对文件进行操作， 
File file = new File("E:" + "/test.txt"); 
        try { 
            System.out.println(file.createNewFile()); 
        } catch (IOException e) { 
            e.printStackTrace(); 
        } 
  
2 ．用keytool -genkey产生一个私钥（使用keytool –help命令可查看keytool命令参数） 
keytool -genkey -alias mykey -keystore mykeystore -keypass mypass -storepass mykeystorepass -validity 80 
参数说明如下： 
-alias mykey ：指定密钥的别名，不指定的话默认为 "mykey" 
-keystore mykeystore ：指定密钥数据库名,不指定则默认在Documents and Settings\Administrator下生成一个名称为 .keystore的文件。 
-keypass mypass ：指定密钥密码，用jarsigner签名时需要。 
-storepass mykeystorepass ：指定密钥数据库密码，用jarsigner签名时需要。 
-validity 80 ：密钥有效时间为80天，不指定的话默认为90天 
  
3 ．在WEB-INF/classes目录下运行keytool命令，会提示输入一些姓名/公司/国家之类的信息： 
   
如果不想一步步输入上面信息，可以直接输入下面命令执行： 
keytool -genkey -alias mykey -keystore mykeystore -keypass mypass -storepass mykeystorepass -validity 80  -dname "cn=Henry Zhou, ou=JavaSoft, l=SZ, S=JS, o=Lively, c=CN" 
-dname 参数说明如下： 
CN=commonName 
OU=organizationUnit 
O=organizationName 
L=localityName 
S=stateName 
C =country 
4 ．执行完毕在WEB-INF/classes目录下生成一个名mykeystore的密钥文件，下面要用此密钥文件对jar文件进行加密： 
jarsigner -keystore mykeystore helloworld.jar mykey 
helloworld.jar mykey ：指定要签名的jar文件和密钥的别名 
运行命令后会提示输入密钥密码和密钥数据库密码： 
   
签名者证书将在六个月内过期。 
  
由于安全原因，在上面的命令中无法指定密钥密码和密钥数据库密码，即使运行： 
jarsigner -keystore mykeystore helloworld.jar mykey -keypass mypass -storepass mykeystorepass 
仍然会提示输入密钥密码和密钥数据库密码。 
  
注： 
其中keytool的详细参数说明可以在sun网站上查询 
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/keytool.html 
其中jarsigner命令行的详细参数可以在sun网站上查询http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/jarsigner.html 
  
5. 执行后在helloworld.jar/META-INF中可以看到生成MYKEY.DSA和MYKEY.SF文件（可以通过-sigFile MKSIGN指定生成 "MKSIGN.SF"和"MKSIGN.DSA"）。 
其中SF文件包含了JAR中所有类的一个列表，保存了签名过程中使用的摘要算法。DSA文件是一个二进制密匙文件。扩展名是DSA还是RSA取决你使用的签名算法，默认是DSA，可以在keytool参数中指定RSA算法。 
  
6 ．把生成的helloworld.jar包拷贝到webstart/jar/jws目录下。 
  
7 ．在webstart/jnlp/HelloWorld.jnlp中添加： 
<security> 
   <all-permissions/> 
</security> 
增加了签名后，如果缺少<security><all-permissions/></security>会报错： 
启动/运行应用程序时发生错误。 
  
标题：JNLP Argument Solution 
供应商：Lively 
类别：安全错误 
  
access denied (java.io.FilePermission E:\test.txt write) 
  
8. webstart 工程放入tomcat/webapps，启动tomcat即可，链接jnlp后发现E盘新建一test.txt文件，测试成功。 
注： 网上介绍有时候需要在webstart/WEB-INF/web.xml文件中配置： 
<mime-mapping> 
      <extension>jnlp</extension> 
       <mime-type>application/x-java-jnlp-file</mime-type> 
  </mime-mapping> 
  
在tomcat5.5.20中测试发现不需要在web.xml中添加此代码。