java web start(1)

引用网址：http://sonichui.spaces.live.com/Blog/cns!E9BA55A754ADC96B!734.entry










编程平台：Ecplise3.4


关于JWS：

Sun的JWS技术可以用于以下方面：

1.可以很方便地部署客户端JAVA软件（包括Applet）

2.保证软件的版本保持最新

3.有安全需求，JWS程序默认运行在受限的沙箱（Sandbox）



开发步骤：

1.编写好要在客户端运行的软件。

2.编写.jnlp文件，它是JWS的核心，要正确部署应用程序，必须确保.jnlp编写正确不误。

3.编写调用页面，以方便用户通过浏览器运行软件。

4.服务器部署。

下面分步骤详细讲解：

准备工作：
先建立新的wed应用，如图：



假设名称为JWSTest，应用服务器为Tomcat5.5，并配置无误。

客户端应用程序：
近来我在开发JMF应用程序，这里我用一个媒体播放器来做实验，要运行其他应用程序，自己编写就行，不论是有网络连接的还是没网络连接的应用程序都可以，不过有网络连接的或者其他要调用客户端本地资源的程序就要涉及到.jar文件签名的问题，我下面这个程序要签名才可以正常运行，因为要调用本地类库，而关于部署Applet小程序应用，还有地方不理解，理解后在写。签名下面会讲解，先看源代码。

MediaPlayerTest.java

import java.awt.FileDialog;
import java.awt.Frame;
import java.awt.Menu;
import java.awt.MenuBar;
import java.awt.MenuItem;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;

import javax.media.ControllerEvent;
import javax.media.ControllerListener;
import javax.media.MediaLocator;
import javax.media.Manager;
import javax.media.bean.playerbean.MediaPlayer;
import javax.media.rtp.ReceiveStreamListener;
import javax.media.rtp.event.ReceiveStreamEvent;

/**
* @author 陈辉鸿
*/
public class MediaPlayerTest extends Frame {

    MediaPlayer player=null;

    public static void main(String[] args) {

        new MediaPlayerTest();

    }


    public MediaPlayerTest(){
        setSize(400,400);
        setTitle("MediaPlayerTest");
        this.addWindowListener(new
                WindowAdapter(){
                    public void windowClosing(WindowEvent e){
                        if(player!=null){
                            player.close();
                        }
                        System.exit(0);
                    }
                });
            Menu menu=new Menu("打开");
            MenuItem openItem=new MenuItem("打开");
            openItem.addActionListener(new
                java.awt.event.ActionListener(){
                    public void actionPerformed(java.awt.event.ActionEvent e){
                        openFile();
                    }
                });
            menu.add(openItem);
            MenuBar menuBar=new MenuBar();
            menuBar.add(menu);
            this.setMenuBar(menuBar);
            setVisible(true);
    }
    @SuppressWarnings("deprecation")
    protected void openFile(){
        FileDialog fd=new FileDialog(this, "选择文件", FileDialog.LOAD);
        fd.setVisible(true);
        String fileDirectory=fd.getDirectory();
        String fileName=fd.getFile();
        if(fileName==null) return;
        String mediaPath="file:///"+fileDirectory+fileName;
            if(player!=null){
                player.close();
                player=null;
            }
            player=new MediaPlayer();
            player.setMediaLocation(mediaPath);
            player.setCachingControlVisible(true);
            player.setPlaybackLoop(true);
            this.add(player);
            pack();
            player.start();
    }

}


文件目录如下：

├─\src
│      MediaPlayerTest.java
├─\build
│  └─\classes
└─\WebContent
    │  JMFPlayer.jnlp
    │  index.html
    │  indexwithjretest.html
    │  JMFPlayer.jar
    ├─\WEB-INF
    │  │  web.xml
    │  └─\lib
    │          jnlp-servlet.jar
    └─\META-INF
            MANIFEST.MF

假设在目录\src下，用下面的命令把MediaPlayerTest.java编译好：

javac MediaPlayerTest.java

打包成.jar文件，说明一下命令中的*是为把相关类都打包入JMFPlayer.jar文件，不然会产生NoClass-DefFoundError

jar cvf JMFPlayer.jar MediaPlayerTest*.class

产生密码，会出现如图选项，照着回答就是，不过要记住主密码，签名要用到：

keytool -genkey -alias secure



对JMFPlayer.jar文件进行签名：

jsigner JMFPlayer.jar secure

上面完成无误后，应用程序的编写算基本完成。

Jnlp文件：
先把jnlp-servlet.jar类库导入到\WebContent\WEB-INF\lib目录下，从jdk1.4开始，jws已经集成到开发包里面，在%JAVA_HOME%\sample\jnlp\servlet目录下可以找到这个jar。导入后修改wed.xml文件如下，这样就可以免去修改Tomcat的wed.xml配置文件以支持jnlp文件类型，更方便开发。

wed.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
    <display-name>JWSTest</display-name>
    <servlet>
         <servlet-name>JnlpDownloadServlet</servlet-name>
         <servlet-class>jnlp.sample.servlet.JnlpDownloadServlet</servlet-class>
         <load-on-startup>-1</load-on-startup>
    </servlet>
    <servlet-mapping>
         <servlet-name>JnlpDownloadServlet</servlet-name>
         <url-pattern>*.jnlp</url-pattern>
    </servlet-mapping>
    <mime-mapping>
         <extension>jnlp</extension>
         <mime-type>application/x-java-jnlp-file</mime-type>
    </mime-mapping>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>
</web-app>


在\Wed-Content目录下新建一个JMFPlayer.jnlp文件：



内容如下，本质上.jnlp文件就是一个Xml文件，要严格遵守xml语法。

JMFPlayer.jnlp
TS: 2008-1-2 10:48:54
<?xml spec="1.0+" version="1.0" encoding="utf-8"?>
<jnlp codebase=$$codebase href="JMFPlayer.jnlp">
<information>
         <title>JMFPlayer</title>
         <vendor>JWS example of JMFPlayer</vendor>
         <description>Example of JWS</description>
         <description kind="short">JWS example</description>
         <offline-allowed/>
</information>
<resources>
      <j2se version="1.5+"/>
      <jar href="JMFPlayer.jar"/>
</resources>
<application-desc main-class="MediaPlayerTest"/>
</jnlp>


1.TS:标签用于检测客户端的程序版本是否最新，它是通过对比客户端的程序的修改日期和这个日期来判断的，所以上面的软件发布时间要自己手动来更改。

2.codebase=$$codebase表示对文件地址进行软解码，要用到jnlp-servlet.jar类库才能正常运行。

3.<information>...</information>信息标记，包括运行程序名，出版商，描述。其中<offline-allowed/>标记表示是否允许客户端离线运行程序，而无须每次都重新下载，要关闭离线运行功能为<offline-allowed=false/>

4.<resources>...</resources>资源应用标记，里面的<jar href="这里写你打包好的jar文件">就是你要运行的程序，<jese version="1.5+"/>表示java运行平台的要求，这里为jdk1.5或更高。

5<application-desc main-class="MediaPlayerTest"/>表示你打包好的jar文件的程序入口。

调用页面：
主页如下，里面含有脚本用于检测客户是否已经安装有JWS运行环境，并检测运行的浏览器是IE还是Nescape，如果已经安装有jdk1.4或更高就已经集成JWS运行环境。

index.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
     <HEAD>
         <TITLE>Index testing JRE level</TITLE>
     </HEAD>
<BODY>
<SCRIPT LANGUAGE="JavaScript">
var javawsInstalled = 0;
var javaws12Installed = 0;
var javaws142Installed=0;
isIE = "false";
if (navigator.mimeTypes && navigator.mimeTypes.length) {
    x = navigator.mimeTypes['application/x-java-jnlp-file'];
    if (x) {
       javawsInstalled = 1;
       javaws12Installed=1;
       javaws142Installed=1;
    }
}
else {
    isIE = "true";
}
</SCRIPT>
<SCRIPT LANGUAGE="VBScript">
on error resume next
If isIE = "true" Then
   If Not(IsObject(CreateObject("JavaWebStart.isInstalled"))) Then
      javawsInstalled = 0
   Else
      javawsInstalled = 1
   End If
   If Not(IsObject(CreateObject("JavaWebStart.isInstalled.2"))) Then
      javaws12Installed = 0
   Else
      javaws12Installed = 1
   End If
   If Not(IsObject(CreateObject("JavaWebStart.isInstalled.1.4.2.0"))) Then
      javaws142Installed = 0
   Else
      javaws142Installed = 1
   End If
End If
</SCRIPT>
<SCRIPT LANGUAGE="JavaScript">
if (javawsInstalled || (navigator.userAgent.indexOf("Gecko") !=-1)) {
     document.write("<a href=JMFPlayer.jnlp>点击这里利用JWS运行软件</a>");
} else {
     document.write("WebStart is not Installed, Click ");
     document.write("<a href=http://java.sun.com/javase/downloads/index.jsp>here</a> ");
     document.write("to download and install JRE 1.5.0 and try to run the app again.");
}
</SCRIPT>
</BODY>
</HTML>




一切完成后，就可以进行测试，选择index.html按右键选择Run on Server:



运行画面：