-- Java Applet 基础

-- Java 文档注释

Java Applet 基础

Applet 是一种 Java 程序。它一般运行在支持 Java 的 Web 浏览器内。因为它有完整的 Java API支持,所以Applet 是一个全功能的 Java 应用程序。

如下所示是独立的 Java 应用程序和 applet 程序之间重要的不同：

Java 中 Applet 类继承了 java.applet.Applet 类。
Applet 类没有定义 main()，所以一个 Applet 程序不会调用 main() 方法。
Applet 被设计为嵌入在一个 HTML 页面。
当用户浏览包含 Applet 的 HTML 页面，Applet 的代码就被下载到用户的机器上。
要查看一个 Applet 需要 JVM。 JVM 可以是 Web 浏览器的一个插件，或一个独立的运行时环境。
用户机器上的 JVM 创建一个 Applet 类的实例，并调用 Applet 生命周期过程中的各种方法。
Applet 有 Web 浏览器强制执行的严格的安全规则，Applet 的安全机制被称为沙箱安全。
Applet 需要的其他类可以用 Java 归档（JAR）文件的形式下载下来。

Applet的生命周期

Applet 类中的四个方法给你提供了一个框架，你可以在该框架上开发小程序：

init: 该方法的目的是为你的 Applet 提供所需的任何初始化。在 Applet 标记内的 param 标签被处理后调用该方法。
start: 浏览器调用 init 方法后，该方法被自动调用。每当用户从其他页面返回到包含 Applet 的页面时，则调用该方法。
stop: 当用户从包含 Applet 的页面移除的时候，该方法自动被调用。因此，可以在相同的 Applet 中反复调用该方法。
destroy: 此方法仅当浏览器正常关闭时调用。因为 Applet 只有在 HTML 网页上有效，所以你不应该在用户离开包含 Applet 的页面后遗漏任何资源。
paint: 该方法在 start() 方法之后立即被调用，或者在 Applet 需要重绘在浏览器的时候调用。paint() 方法实际上继承于 java.awt。

"Hello, World" Applet:

下面是一个简单的 Applet 程序 HelloWorldApplet.java:

HelloWorldApplet.java 文件代码：

import java.applet.*;

import java.awt.*;

public class HelloWorldApplet extends Applet{

   public void paint (Graphics g){

      g.drawString ("Hello World", , );

   }

}

这些 import 语句将以下类导入到我们的 Applet 类中：

java.applet.Applet.

java.awt.Graphics.

没有这些 import 语句，Java 编译器就识别不了 Applet 和 Graphics 类。

Applet 类

每一个 Applet 都是 java.applet.Applet 类的子类，基础的 Applet 类提供了供衍生类调用的方法,以此来得到浏览器上下文的信息和服务。

这些方法做了如下事情：

得到 Applet 的参数
得到包含 Applet 的 HTML 文件的网络位置
得到 Applet 类目录的网络位置
打印浏览器的状态信息
获取一张图片
获取一个音频片段
播放一个音频片段
调整此 Applet 的大小

除此之外，Applet 类还提供了一个接口，该接口供 Viewer 或浏览器来获取 Applet 的信息，并且来控制 Applet 的执行。

Viewer 可能是：

请求 Applet 作者、版本和版权的信息
请求 Applet 识别的参数的描述
初始化 Applet
销毁 Applet
开始执行 Applet
结束执行 Applet

Applet 类提供了对这些方法的默认实现，这些方法可以在需要的时候重写。

"Hello，World"applet 都是按标准编写的。唯一被重写的方法是 paint 方法。

Applet 的调用

Applet 是一种 Java 程序。它一般运行在支持 Java 的 Web 浏览器内。因为它有完整的 Java API 支持,所以 Applet 是一个全功能的 Java 应用程序。

<applet> 标签是在HTML文件中嵌入 Applet 的基础。以下是一个调用"Hello World"applet的例子：

<html>

<title>The Hello, World Applet</title>

<hr>

<applet code="HelloWorldApplet.class" width="" height="">

If your browser was Java-enabled, a "Hello, World"

message would appear here.

</applet>

<hr>

</html>

Applet 的调用 - 嵌入 HTML

注意: 你可以参照 HTML Applet 标签来更多的了解从 HTML 中调用 applet 的方法。

<applet> 标签的属性指定了要运行的 Applet 类。width 和 height 用来指定 Applet 运行面板的初始大小。Applet 必须使用 </applet> 标签来关闭。

如果 Applet 接受参数，那么参数的值需要在 <param> 标签里添加，该标签位于 <applet> 和 </applet> 之间。浏览器忽略了 applet 标签之间的文本和其他标签。

不支持 Java 的浏览器不能执行 <applet> 和 </applet>。因此，在标签之间显示并且和 applet 没有关系的任何东西，在不支持的 Java 的浏览器里是可见的。

Viewer 或者浏览器在文档的位置寻找编译过的 Java 代码，要指定文档的路径，得使用 <applet> 标签的 codebase 属性指定。

如下所示：

<applet codebase="http://amrood.com/applets"

code="HelloWorldApplet.class" width="" height="">

如果 Applet 所在一个包中而不是默认包，那么所在的包必须在 code 属性里指定，例如：

<applet code="mypackage.subpackage.TestApplet.class"

           width="" height="">

获得applet参数

下面的例子演示了如何使用一个 Applet 响应来设置文件中指定的参数。该 Applet 显示了一个黑色棋盘图案和第二种颜色。

第二种颜色和每一列的大小通过文档中的 Applet 的参数指定。

CheckerApplet 在 init() 方法里得到它的参数。也可以在 paint() 方法里得到它的参数。然而，在 Applet 开始得到值并保存了设置，而不是每一次刷新的时候都得到值，这样是很方便，并且高效的。

Applet viewer 或者浏览器在 Applet 每次运行的时候调用 init() 方法。在加载 Applet 之后，Viewer 立即调用 init() 方法（Applet.init()什么也没做），重写该方法的默认实现，添加一些自定义的初始化代码。

Applet.getParameter() 方法通过给出参数名称得到参数值。如果得到的值是数字或者其他非字符数据，那么必须解析为字符串类型。

下例是 CheckerApplet.java 的修改：

import java.applet.*;

import java.awt.*;

public class CheckerApplet extends Applet

{

   int squareSize = ;// 初始化默认大小

   public void init () {}

   private void parseSquareSize (String param) {}

   private Color parseColor (String param) {}

   public void paint (Graphics g) {}

}

CheckerApplet.java 文件代码

下面是 CheckerApplet 类的 init() 方法和私有的 parseSquareSize() 方法：

public void init ()

{

   String squareSizeParam = getParameter ("squareSize");

   parseSquareSize (squareSizeParam);

   String colorParam = getParameter ("color");

   Color fg = parseColor (colorParam);

   setBackground (Color.black);

   setForeground (fg);

}

private void parseSquareSize (String param)

{

   if (param == null) return;

   try {

      squareSize = Integer.parseInt (param);

   }

   catch (Exception e) {

     // 保留默认值

   }

}

该 Applet 调用 parseSquareSize()，来解析 squareSize 参数。parseSquareSize() 调用了库方法 Integer. parseInt() 该方法将一个字符串解析为一个整数，当参数无效的时候，Integer.parseInt() 抛出异常。

因此，parseSquareSize() 方法也是捕获异常的，并不允许 Applet 接受无效的输入。

Applet 调用 parseColor()方法将颜色参数解析为一个 Color 值。parseColor() 方法做了一系列字符串的比较，来匹配参数的值和预定义颜色的名字。你需要实现这些方法来使 Applet 工作。

指定 applet 参数

如下的例子是一个HTML文件，其中嵌入了 CheckerApplet 类。HTML文件通过使用 <param> 标签的方法给 applet 指定了两个参数。

<html>

<title>Checkerboard Applet</title>

<hr>

<applet code="CheckerApplet.class" width="" height="">

<param name="color" value="blue">

<param name="squaresize" value="">

</applet>

<hr>

</html>

指定 applet 参数 - 嵌入HTML

注意: 参数名字大小写不敏感。

应用程序转换成 Applet

将图形化的 Java 应用程序（是指，使用AWT的应用程序和使用 java 程序启动器启动的程序）转换成嵌入在web页面里的applet是很简单的。

下面是将应用程序转换成 Applet 的几个步骤：

编写一个 HTML 页面，该页面带有能加载 applet 代码的标签。
编写一个 JApplet 类的子类，将该类设置为 public。否则，Applet 不能被加载。
消除应用程序的 main()方法。不要为应用程序构造框架窗口，因为你的应用程序要显示在浏览器中。
将应用程序中框架窗口的构造方法里的初始化代码移到 Applet 的 init() 方法中，你不必显示的构造 Applet 对象，浏览器将通过调用 init() 方法来实例化一个对象。
移除对 setSize() 方法的调用，对于 Applet 来讲，大小已经通过 HTML 文件里的 width 和 height 参数设定好了。
移除对 setDefaultCloseOperation() 方法的调用。Applet 不能被关闭，它随着浏览器的退出而终止。
如果应用程序调用了 setTitle() 方法，消除对该方法的调用。applet 不能有标题栏。（当然你可以给通过 html 的 title 标签给网页自身命名）
不要调用 setVisible(true),Applet 是自动显示的。

事件处理

Applet 类从 Container 类继承了许多事件处理方法。Container 类定义了几个方法，例如：processKeyEvent() 和processMouseEvent()，用来处理特别类型的事件，还有一个捕获所有事件的方法叫做 processEvent。

为了响应一个事件，Applet 必须重写合适的事件处理方法。

import java.awt.event.MouseListener;

import java.awt.event.MouseEvent;

import java.applet.Applet;

import java.awt.Graphics;

public class ExampleEventHandling extends Applet

                             implements MouseListener {

    StringBuffer strBuffer;

    public void init() {

         addMouseListener(this);

         strBuffer = new StringBuffer();

        addItem("initializing the apple ");

    }

    public void start() {

        addItem("starting the applet ");

    }

    public void stop() {

        addItem("stopping the applet ");

    }

    public void destroy() {

        addItem("unloading the applet");

    }

    void addItem(String word) {

        System.out.println(word);

        strBuffer.append(word);

        repaint();

    }

    public void paint(Graphics g) {

         //Draw a Rectangle around the applet's display area.

        g.drawRect(, ,

                      getWidth() - ,

                      getHeight() - );

         //display the string inside the rectangle.

        g.drawString(strBuffer.toString(), , );

    }

    public void mouseEntered(MouseEvent event) {

    }

    public void mouseExited(MouseEvent event) {

    }

    public void mousePressed(MouseEvent event) {

    }

    public void mouseReleased(MouseEvent event) {

    }

    public void mouseClicked(MouseEvent event) {

         addItem("mouse clicked! ");

    }

}

如下调用该 Applet：

<html>

<title>Event Handling</title>

<hr>

<applet code="ExampleEventHandling.class"

width="" height="">

</applet>

<hr>

</html>

/* 最开始运行，Applet 显示 "initializing the applet. Starting the applet."，然后你一点击矩形框，就会显示 "mouse clicked" 。  */

ExampleEventHandling.java 文件代码

显示图片

Applet 能显示 GIF,JPEG,BMP 等其他格式的图片。为了在 Applet 中显示图片，你需要使用 java.awt.Graphics 类的drawImage()方法。

如下实例演示了显示图片的所有步骤：

import java.applet.*;

import java.awt.*;

import java.net.*;

public class ImageDemo extends Applet

{

  private Image image;

  private AppletContext context;

  public void init()

  {

      context = this.getAppletContext();

      String imageURL = this.getParameter("image");

      if(imageURL == null)

      {

         imageURL = "java.jpg";

      }

      try

      {

         URL url = new URL(this.getDocumentBase(), imageURL);

         image = context.getImage(url);

      }catch(MalformedURLException e)

      {

         e.printStackTrace();

         // Display in browser status bar

         context.showStatus("Could not load image!");

      }

   }

   public void paint(Graphics g)

   {

      context.showStatus("Displaying image");

      g.drawImage(image, , , , , null);

      g.drawString("www.javalicense.com", , );

   }

}

如下调用该applet：

<html>

<title>The ImageDemo applet</title>

<hr>

<applet code="ImageDemo.class" width="" height="">

<param name="image" value="java.jpg">

</applet>

<hr>

</html>

ImageDemo.java 文件代码

播放音频

Applet 能通过使用 java.applet 包中的 AudioClip 接口播放音频。AudioClip 接口定义了三个方法：

public void play(): 从一开始播放音频片段一次。
public void loop(): 循环播放音频片段
public void stop(): 停止播放音频片段

为了得到 AudioClip 对象，你必须调用 Applet 类的 getAudioClip() 方法。无论 URL 指向的是否是一个真实的音频文件，该方法都会立即返回结果。

直到要播放音频文件时，该文件才会下载下来。

如下实例演示了播放音频的所有步骤：

import java.applet.*;

import java.awt.*;

import java.net.*;

public class AudioDemo extends Applet

{

   private AudioClip clip;

   private AppletContext context;

   public void init()

   {

      context = this.getAppletContext();

      String audioURL = this.getParameter("audio");

      if(audioURL == null)

      {

         audioURL = "default.au";

      }

      try

      {

         URL url = new URL(this.getDocumentBase(), audioURL);

         clip = context.getAudioClip(url);

      }catch(MalformedURLException e)

      {

         e.printStackTrace();

         context.showStatus("Could not load audio file!");

      }

   }

   public void start()

   {

      if(clip != null)

      {

         clip.loop();

      }

   }

   public void stop()

   {

      if(clip != null)

      {

         clip.stop();

      }

   }

}

如下调用applet：

<html>

<title>The ImageDemo applet</title>

<hr>

<applet code="ImageDemo.class" width="" height="">

<param name="audio" value="test.wav">

</applet>

<hr>

/* 你可以使用你电脑上的 test.wav 来测试上面的实例。 */

AudioDemo.java 文件代码

Java 文档注释

Java 只是三种注释方式。前两种分别是 // 和 /* */，第三种被称作说明注释，它以 /** 开始，以 */结束。

说明注释允许你在程序中嵌入关于程序的信息。你可以使用 javadoc 工具软件来生成信息，并输出到HTML文件中。

说明注释，使你更加方面的记录你的程序信息。

javadoc 标签

javadoc 工具软件识别以下标签：

标签	描述	示例
@author	标识一个类的作者	@author description
@deprecated	指名一个过期的类或成员	@deprecated description
{@docRoot}	指明当前文档根目录的路径	Directory Path
@exception	标志一个类抛出的异常	@exception exception-name explanation
{@inheritDoc}	从直接父类继承的注释	Inherits a comment from the immediate surperclass.
{@link}	插入一个到另一个主题的链接	{@link name text}
{@linkplain}	插入一个到另一个主题的链接，但是该链接显示纯文本字体	Inserts an in-line link to another topic.
@param	说明一个方法的参数	@param parameter-name explanation
@return	说明返回值类型	@return explanation
@see	指定一个到另一个主题的链接	@see anchor
@serial	说明一个序列化属性	@serial description
@serialData	说明通过writeObject( ) 和 writeExternal( )方法写的数据	@serialData description
@serialField	说明一个ObjectStreamField组件	@serialField name type description
@since	标记当引入一个特定的变化时	@since release
@throws	和 @exception标签一样.	The @throws tag has the same meaning as the @exception tag.
{@value}	显示常量的值，该常量必须是static属性。	Displays the value of a constant, which must be a static field.
@version	指定类的版本	@version info

文档注释

在开始的 /** 之后，第一行或几行是关于类、变量和方法的主要描述。

之后，你可以包含一个或多个何种各样的 @ 标签。每一个 @ 标签必须在一个新行的开始或者在一行的开始紧跟星号(*).

多个相同类型的标签应该放成一组。例如，如果你有三个 @see 标签，可以将它们一个接一个的放在一起。

下面是一个类的说明注释的实例：

/*** 这个类绘制一个条形图

* @author noob

* @version 1.2

*/

javadoc 输出什么

javadoc 工具将你 Java 程序的源代码作为输入，输出一些包含你程序注释的HTML文件。

每一个类的信息将在独自的HTML文件里。javadoc 也可以输出继承的树形结构和索引。

由于 javadoc 的实现不同，工作也可能不同，你需要检查你的 Java 开发系统的版本等细节，选择合适的 Javadoc 版本。

实例

下面是一个使用说明注释的简单实例。注意每一个注释都在它描述的项目的前面。

在经过 javadoc 处理之后，SquareNum 类的注释将在 SquareNum.html 中找到。

import java.io.*;

/**

* 这个类演示了文档注释

* @author Ayan Amhed

* @version 1.2

*/

public class SquareNum {

   /**

   * This method returns the square of num.

   * This is a multiline description. You can use

   * as many lines as you like.

   * @param num The value to be squared.

   * @return num squared.

   */

   public double square(double num) {

      return num * num;

   }

   /**

   * This method inputs a number from the user.

   * @return The value input as a double.

   * @exception IOException On input error.

   * @see IOException

   */

   public double getNumber() throws IOException {

      InputStreamReader isr = new InputStreamReader(System.in);

      BufferedReader inData = new BufferedReader(isr);

      String str;

      str = inData.readLine();

      return (new Double(str)).doubleValue();

   }

   /**

   * This method demonstrates square().

   * @param args Unused.

   * @return Nothing.

   * @exception IOException On input error.

   * @see IOException

   */

   public static void main(String args[]) throws IOException

   {

      SquareNum ob = new SquareNum();

      double val;

      System.out.println("Enter value to be squared: ");

      val = ob.getNumber();

      val = ob.square(val);

      System.out.println("Squared value is " + val);

   }

}

SquareNum.java 文件代码

如下，使用 javadoc 工具处理 SquareNum.java 文件：

$ javadoc SquareNum.java

Loading source file SquareNum.java...

Constructing Javadoc information...

Standard Doclet version 1.5.0_13

Building tree for all the packages and classes...

Generating SquareNum.html...

SquareNum.java:: warning - @return tag cannot be used\

                      in method with void return type.

Generating package-frame.html...

Generating package-summary.html...

Generating package-tree.html...

Generating constant-values.html...

Building index for all the packages and classes...

Generating overview-tree.html...

Generating index-all.html...

Generating deprecated-list.html...

Building index for all classes...

Generating allclasses-frame.html...

Generating allclasses-noframe.html...

Generating index.html...

Generating help-doc.html...

Generating stylesheet.css...

 warning

结果如下

上一篇：Java 学习（19）：Java 多线程编程

下一篇：Java 学习（21）：Java 实例

Java 学习（20）：Java Applet 基础 & Java 文档注释的更多相关文章

Java学习总结（二）----Java语言基础
1. Java语言基础 2.1 关键字定义:被java语言赋予特殊含义的单词特点:关键字中的字母都为小写用于定义数据类型的关键字 class,interface,byte,short,i ...
Java文档注释导出帮助文档和项目的jar包导入和导出。
1.1 文档注释导出帮助文档在eclipse使用时,可以配合文档注释,导出对类的说明文档,从而供其他人阅读学习与使用. 通过使用文档注释,将类或者方法进行注释用@简单标注基本信息.如@au ...
Java基础学习总结（48）——Java 文档注释
Java只是三种注释方式.前两种分别是// 和/* */,第三种被称作说明注释,它以/** 开始,以 */结束. 说明注释允许你在程序中嵌入关于程序的信息.你可以使用javadoc工具软件来生成信息, ...
Java学习笔记：语言基础
Java学习笔记:语言基础 2014-1-31 最近开始学习Java,目的倒不在于想深入的掌握Java开发,而是想了解Java的基本语法,可以阅读Java源代码,从而拓展一些知识面.同时为学习An ...
Java 学习（2）：java 基础概念
Java作为一种面向对象语言.支持以下基本概念: 多态继承封装抽象类对象实例方法重载基础语法: 一个Java程序可以认为是一系列对象的集合,而这些对象通过调用彼此的方法来协同工作.以 ...
[java基础]文档注释
转载自:http://blog.163.com/hui_san/blog/static/5710286720104191100389/ 前言 Java 的语法与 C++ 及为相似,那么,你知道 Jav ...
Java学习个人备忘录之文档注释
文档注释单行注释用 // 多行注释有两种,第一种是 /* 内容 */,第二种是/** 内容 */. 这两种多行注释的区别是/** 内容 */这种注释可以生成一个该文件的注释文档,下面是演示代码. A ...
Java基础入门 - 三种注释及文档注释详解
类似C/C++,Java也支持单行和多行注释注释中的字符在编译时会被忽略注释通常为类.变量和方法的主要描述单行注释 // 注释内容多行注释 /* 注释内容 */ /* * 注释内容 */ 文档 ...
Java 基础入门随笔（9） JavaSE版——文档注释
上节中写了一些static变量以及静态的方法的定义使用以及与非静态的差别,这节补充下: 如果在一个类中所有方法都为静态的,且无成员变量,这时候需要对对应的类进行限制该类无法创建对象,具体操作如下: p ...

随机推荐

搭建 GIT 服务器教程
Android-CheckBox 实现计算器
源码下载地址:http://download.csdn.net/detail/wu20093346/7718055 使用CheckBox的OnCheckedChangeListener做事件触发,效果 ...
js03 数组
变量的自动转换=== 等同符:不会发生类型的自动转化! == 等值符:会发生类型自动转化.自动匹配!判断相等没有equals()方法,只有2个等号3个等号. <!DOCTYPE HTML PUB ...
sql查看依赖关系
select OBJECT_NAME(object_id) as name,object_NAME(referenced_major_id) as ref from sys.sql_dependenc ...
Elasticsearch之插件扩展
Elasticsearch之插件介绍及安装 Elasticsearch之head插件安装之后的浏览详解 Elasticsearch之kopf插件安装之后的浏览详解 Elasticsearch-2.4. ...
实际感受美丽的Linux（多组视频）
1.Fedora 上使用google earth 2.体验桌面-GNOME 2.2.9 3.体验桌面-KDE4.4 永中Office使用演示(和MS Office 2003很相似哦) 4.在Fedor ...
新手前端笔记之--初识css
css样式表是为了容纳与html文档分离出来的样式属性而产生的,所以她理所当然的包含两个部分:1.样式的表示,使用{属性1:属性值:属性2:属性值:...},2.样式与标签的对应(如何找的对应标签), ...
Large Division (大数求余）
Given two integers, a and b, you should check whether a is divisible by b or not. We know that an in ...
MFC CListctr显示缩略图
我们知道通过CImageList可以让listctr显示出图片,但是添加的图片大小必须和要CImageList 创建的图片大小一致,才能显示出来.最近遇到一个需求,需要把很多大小不一的jpeg图片通过 ...
ImportError: No module named tornado.ioloop 记录过程
ImportError: No module named tornado.ioloop 记录过程安装 pycurl pip install pycurl 报错 'curl-config' no ...

Java 学习（20）：Java Applet 基础 & Java 文档注释