Deploying an Applet部署小程序

You can deploy applets by using the runApplet function of the Deployment Toolkit script. 可以使用部署工具包脚本的runApplet函数部署小程序。The runApplet function ensures that the required minimum version of the Java Runtime Environment (JRE) software exists on the client and then runs the applet. runApplet函数确保客户端上存在所需的Java运行时环境（JRE）软件的最低版本，然后运行小程序。The runApplet function generates an HTML <applet> tag with the information provided.runApplet函数生成一个带有所提供信息的HTML<applet>标记。

You can deploy applets by specifying the deployment options as attributes and parameters of the <applet> tag. 通过将部署选项指定为<applet>标记的属性和参数，可以部署applet。You can also specify deployment options in a Java Network Launch Protocol (JNLP) file to take advantage of advanced features. 您还可以在Java网络启动协议（JNLP）文件中指定部署选项，以利用高级功能。See the Java Network Launch Protocol topic for more information about this protocol.有关该协议的更多信息，请参阅Java网络启动协议主题。

The parameters to the runApplet function vary depending on whether you are using JNLP. runApplet函数的参数根据您是否使用JNLP而有所不同。Applets deployed by using JNLP can run only if the next generation Java Plug-in software exists on the client machine (the next generation Java Plug-in software was introduced in the Java Platform, Standard Edition 6 update 10 release).使用JNLP部署的小程序只有在客户机上存在下一代Java插件软件时才能运行（下一代Java插件软件是在Java平台的Standard Edition 6 update 10发行版中引入的）。

The next section shows how to use the runApplet function in the HTML page that will display the applet. 下一节将展示如何在显示小程序的HTML页面中使用runApplet函数。The following usage scenarios are described:描述了以下使用场景：

• Specifying deployment options as attribute and parameter name-value pairs将部署选项指定为属性和参数名称-值对
• Using the jnlp_href parameter to specify deployment options in a JNLP file使用jnlp_href参数在jnlp文件中指定部署选项
• Specifying attribute and parameter name-value pairs as well as a JNLP file指定属性和参数名称-值对以及JNLP文件 (enables applet to run on the old and next generation Java Plug-in software)（使小程序能够在旧的和下一代Java插件软件上运行）

Function signature:函数签名： runApplet: function(attributes, parameters, minimumVersion)

Parameters:参数：

• attributes – The names and values of the attributes of the generated <applet> tag生成的<applet>标记的属性的名称和值
• parameters – The names and values of the <param> tags in the generated <applet> tag生成的<applet>标记中<param>标记的名称和值
• minimumVersion – The minimum version of the JRE software that is required to run this applet运行此小程序所需的JRE软件的最低版本

Usage:用法：

• Specifying deployment options as attribute and parameter name-value pairs 将部署选项指定为属性和参数名称-值对

  The attributes and parameters passed as name-value pairs are written out as attributes and nested <param> tags in the generated <applet> tag. 作为名称-值对传递的属性和参数将作为属性和嵌套的<param>标记写入生成的<applet>标记中。Applets deployed in this manner can be run by the old Java Plug-in software.以这种方式部署的小程序可以由旧的Java插件软件运行。

  // launch the Java 2D applet on JRE version 1.6.0
  // or higher with one parameter (fontSize)
  <script src=
      "https://www.java.com/js/deployJava.js"></script>
  <script> var attributes = {code:'java2d.Java2DemoApplet.class',
          archive:'Java2Demo.jar', width:710, height:540};
      var parameters = { fontSize:16, permissions:'sandbox' };
      var version = '1.6';
      deployJava.runApplet(attributes, parameters, version);
  </script>

  Open DeployUsingNameValuePairs.html in a browser to view the Java2D applet.在浏览器中打开DeployUsingNameValuePairs.html以查看Java2D小程序。

  ---

  Note:  If you don't see the applet running, you need to install at least the Java SE Development Kit (JDK) 7 release.如果没有看到小程序运行，则至少需要安装Java SE开发工具包（JDK）7版本。

  ---

• Using the jnlp_href parameter to specify deployment options in a JNLP file 使用jnlp_href参数在jnlp文件中指定部署选项

  The attributes and parameters (jnlp_href in this case) passed as name-value pairs are written out as attributes and nested <param> tags in the generated <applet> tag. 作为名称-值对传递的属性和参数（本例中为jnlp_href）将作为属性和嵌套的<param>标记写入生成的<applet>标记中。Applets deployed in this manner can be run by the next generation Java Plug-in software only. 以这种方式部署的小程序只能由下一代Java插件软件运行。It is better to specify the applet's width and height as attributes as follows:最好将小程序的宽度和高度指定为以下属性：

  <script src="https://www.java.com/js/deployJava.js"></script>
  <script> var attributes = { code:'java2d.Java2DemoApplet', width:710, height:540 };
      var parameters = { jnlp_href: 'java2d.jnlp' }; 
      deployJava.runApplet(attributes, parameters, '1.6'); 
  </script>

  Open DeployUsingJNLP.html in a browser to view the Java2D applet.在浏览器中打开DeployUsingJNLP.html以查看Java2D小程序。

  ---

  Note:  If you don't see the applet running, you need to install at least the Java SE Development Kit (JDK) 6 update 10 release.如果看不到小程序正在运行，则至少需要安装JavaSE开发工具包（JDK）6 update 10发行版。

  ---

• Specifying attribute and parameter name-value pairs as well as a JNLP file 指定属性和参数名称-值对以及JNLP文件

  Applets deployed by using JNLP will run only if end users have the next generation Java Plug-in software running on their browsers. 使用JNLP部署的小程序只有在最终用户的浏览器上运行下一代Java插件软件时才会运行。If you would like your applet to run on the old Java Plug-in software also, specify deployment options using attribute and parameter name-value pairs as well as a JNLP file.如果希望小程序也在旧的Java插件软件上运行，请使用属性和参数名称-值对以及JNLP文件指定部署选项。

  <script src="https://www.java.com/js/deployJava.js"></script>
  <script> var attributes = {code:'java2d.Java2DemoApplet.class',
              archive:'Java2Demo.jar', width:710, height:540}; 
      var parameters = { fontSize:16, jnlp_href:'java2d.jnlp' }; 
      var version = '1.6' ; 
      deployJava.runApplet(attributes, parameters, version);      
  </script>

The following guidelines are helpful if some deployment options have different values in the attribute name-value pairs and in the JNLP file:如果某些部署选项在属性名称-值对和JNLP文件中具有不同的值，则以下指导原则非常有用：

• Specify width and height as attribute name-value pairs (not in the JNLP file).将width和height指定为属性名称-值对（不在JNLP文件中）。
• Specify parameters such as image and boxbgcolor as parameter name-value pairs (not in the JNLP file). 将image和boxbgcolor等参数指定为参数名称-值对（不在JNLP文件中）。These parameters are needed early on in the applet startup process.这些参数在小程序启动过程的早期就需要。
• In the JNLP file, leave the codebase attribute empty or specify an absolute URL. 在JNLP文件中，将codebase属性保留为空或指定一个绝对URL。When the codebase attribute is left empty, it defaults to the directory containing the JNLP file.当codebase属性为空时，它默认为包含JNLP文件的目录。
• If the applet is launched using a JNLP file, the values for the code, codebase, and archive attributes are taken from the JNLP file. 如果小程序是使用JNLP文件启动的，则code、codebase和archive属性的值取自JNLP文件。If these attributes are also specified separately as attribute name-value pairs, the attribute name-value pairs are ignored.如果这些属性也单独指定为属性名称-值对，则会忽略属性名称-值对。

Open DeployUsingNameValuePairsAndJNLP.html in a browser to view the Java2D applet.在浏览器中打开DeployUsingNameValuePairsAndJNLP.html以查看Java2D小程序。

Download source code for the Run Applet example to experiment further.下载Run Applet示例的源代码以进行进一步实验。