本文展示了一个KT(Knight’s Tour)小程序， 用来演示一个限制版的骑士巡游问题。 骑士并不是从任何一个方格开始， 而是从角落上的四个方格之一开始。这个applet的界面如图1所示：
图1： KT的界面由一个棋盘， 一个选择开始方格的组合框和一个开始游历的按钮组成
在启动巡游之前， 先从组合框中选择骑士开始的角落。 程序响应会让骑士显示在正确的角落上(默认情况下骑士在最左上角)。 然后单击"Take the Tour"(开始巡游)按钮来开始整个巡游过程。 按钮和组合框在巡游过程中都将被禁止。巡游过程是怎么样的呢? 图2展现了一系列的线段(轨迹)， 每一个线段都是随着骑士在棋盘的行动从上一个方格的中心到当前方格的中心。
图2： 巡游从左上角开始
现在你已经看到了这个小程序的界面和巡游过程， 让我们开始学习它的源代码吧。
清单1. KT.java
// KT.java
import java.applet.Applet;
import java.awt.*;
import java.awt.event.*;
import java.net.URL;
import java.util.ArrayList;
public class KT extends Applet
{
// 线程延迟以毫秒为单位
public final static int DELAY = 500;
// 开始骑士巡游线程
PRivate Thread thd;
// 初始化小程序
public void init ()
{
// 创建一个标签对象来标明小程序的标题
Label lblTitle = new Label ("Knight's Tour", Label.CENTER);
lblTitle.setFont (new Font ("Arial", Font.BOLD, 18));
// 把标签对象加到小程序的面板容器
add (lblTitle);
// 创建一个ChessBoard对象,它具有显示一个棋盘、移动骑士到
// 任何方格并留下骑士巡游轨迹的能力.
final ChessBoard cb = new ChessBoard (this);
//把ChessBoard对象加入到小程序的面板容器
add (cb);
// 创建一个Panel对象来保存Label,Choice和按钮对象.
Panel pnl = new Panel ();
//创建一个标签来标明Choice对象并把它添加到Panel中
pnl.add (new Label ("Choose starting position:"));
//创建一个Choice对象,用来选择骑士的开始位置（棋盘的四个角落）
//并把它添加到Panel中.
final Choice c = new Choice ();
c.add ("Upperleft corner");
c.add ("Upperright corner");
//创建Choice的item listener,这个监听器按选择结果来重设骑士的开始位置.
c.addItemListener (new ItemListener ()
{
public void itemStateChanged (ItemEvent e)
{
Choice c = (Choice) e.getSource ();
if (c.getSelectedIndex () == 0)
cb.moveKnight (1);
else
cb.moveKnight (8);
cb.reset ();
}
});
pnl.add (c);
//把Panel加入到小程序的面板容器
add (pnl);
//创建一个按钮对象用来开始骑士巡游.
final Button BTn = new Button ("Take the Tour");
//创建按钮的Action listener(动作监听器),用来确定骑士巡游的位置.
//按照规则将骑士从一个位置移动到另一个位置.
ActionListener al;
al = new ActionListener ()
{
public void actionPerformed (ActionEvent e)
{
Runnable r;
r = new Runnable ()
{
int [] boardPositions1 =
{
1, 18, 33, 50, 60, 54, 64, 47,
32, 15, 5, 11, 17, 34, 49, 59,
53, 63, 48, 31, 16, 6, 12, 2,
19, 25, 42, 57, 51, 61, 55, 40,
23, 8, 14, 4, 10, 27, 44, 38,
21, 36, 46, 29, 35, 41, 58, 52,
62, 56, 39, 24, 7, 13, 3, 9,
26, 43, 37, 22, 28, 45, 30, 20
};
int [] boardPositions2 =
{
8, 23, 40, 55, 61, 51, 57, 42,
25, 10, 4, 14, 24, 39, 56, 62,
52, 58, 41, 26, 9, 3, 13, 7,
22, 32, 47, 64, 54, 60, 50, 33,
18, 1, 11, 5, 15, 30, 45, 35,
20, 37, 43, 28, 38, 48, 63, 53,
59, 49, 34, 17, 2, 12, 6, 16,
31, 46, 36, 19, 29, 44, 27, 21
};
public void run ()
{
cb.reset ();
// thd用来检查用户离开小程序网页
// 以便停止小程序的运行.
for (int i = 0; i < boardPositions1.length &&
thd != null; i++)
{
if (c.getSelectedIndex () == 0)
cb.moveKnight (boardPositions1 [i]);
else
cb.moveKnight (boardPositions2 [i]);
try
{
Thread.sleep (DELAY);
}
catch (InterruptedException e2)
{
}
}
c.setEnabled (true);
btn.setEnabled (true);
}
};
c.setEnabled (false);
btn.setEnabled (false);
thd = new Thread (r);
thd.start ();
}
};
btn.addActionListener (al);
//添加按钮到小程序面板容器
add (btn);
}
//停止小程序
public void stop ()
{
//用户离开网页时必须停止”骑士巡游”线程
thd = null;
}
}
final class ChessBoard extends Canvas
{
//非白色方格的颜色
private final static Color SQUARECOLOR = new Color (195, 214, 242);
//棋盘方格的尺寸
private final static int SQUAREDIM = 40;
//棋盘方格的尺寸（包括黑边框）
private final static int BOARDDIM = 8 * SQUAREDIM + 2;
//棋盘左上角的左坐标（X坐标）
private int boardx;
//棋盘左上角的顶坐标(Y坐标)
private int boardy;
//棋盘长度
private int width;
// 棋盘宽度
private int height;
// 图像缓冲
private Image imBuffer;
// Graphics context associated with image buffer.
private Graphics imG;
// 骑士图像
private Image imKnight;
// 骑士图像的长度
private int knightWidth;
// 骑士图像的宽度
private int knightHeight;
//骑士轨迹的坐标
private ArrayList trail;
// Left coordinate of knight rectangle origin (upper-left corner).
private int ox;
// Top coordinate of knight rectangle origin (upper-left corner).
private int oy;
// 创建ChessBoard的Applet--调用它的getImage()和getDocumentBase()方法,
// 并且我们将使用它作为drawImage()方法的image observer
Applet a;
// 构造棋盘
ChessBoard (Applet a)
{
// 确定部件的大小
width = BOARDDIM+1;
height = BOARDDIM+1;
// 初始化棋盘, 使它处于中心
boardx = (width - BOARDDIM) / 2 + 1;
boardy = (height - BOARDDIM) / 2 + 1;
//使用MediaTracker来确保骑士图像在我们获取它的长和宽之前被完全导入
MediaTracker mt = new MediaTracker (this);
// 导入骑士图像
imKnight = a.getImage (a.getDocumentBase (), "knight.gif");
mt.addImage (imKnight, 0);
try
{
mt.waitForID (0);
}
catch (InterruptedException e) {}
//获得骑士的长度和宽度, 帮助骑士定位于方格中心
knightWidth = imKnight.getWidth (a);
knightHeight = imKnight.getHeight (a);
//初始化骑士图像, 使骑士定位于左上角方格的中心
ox = boardx + (SQUAREDIM - knightWidth) / 2 + 1;
oy = boardy + (SQUAREDIM - knightHeight) / 2 + 1;
//创建一个数据结构, 用来保存骑士巡游时的轨迹
trail = new ArrayList ();
//保存applet引用以便后面调用drawImage()时使用.
this.a = a;
}
// This method is called when the ChessBoard component's peer is created.
// The code in this method cannot be called in the ChessBoard constrUCtor
// because the createImage() method returns null at that point. It doesn't
// return a meaningful value until the ChessBoard component has been added
// to its container. The addNotify() method is not called until the first
// time ChessBoard is added to a container.
public void addNotify ()
{
// Given this object's Canvas "layer" a chance to create a Canvas peer.
super.addNotify ();
//创建图像缓冲
imBuffer = createImage (width, height);
//得到图像缓冲的内容。
imG = imBuffer.getGraphics ();
}
//当小程序的布局治理器布置它的组件时，会调用这个方法。
//假如可能，组件会显示为首选大小。
public Dimension getPreferredSize ()
{
return new Dimension (width, height);
}
//移动骑士到指定的棋盘位置。假如位置小于1或大于64则抛出一个异常
public void moveKnight (int boardPosition)
{
if (boardPosition < 1 boardPosition > 64)
throw new IllegalArgumentException ("invalid board position: " +
boardPosition);
int rebasedBoardPosition = boardPosition-1;
int col = rebasedBoardPosition % 8;
int row = rebasedBoardPosition / 8;
ox = boardx + col * SQUAREDIM + (SQUAREDIM - knightWidth) / 2 + 1;
oy = boardy + row * SQUAREDIM + (SQUAREDIM - knightHeight) / 2 + 1;
trail.add (new Point (ox + knightWidth / 2, oy + knightHeight / 2));
repaint ();
}
//画出所有部件――先棋盘然后是骑士
public void paint (Graphics g)
{
//画出棋盘
paintChessBoard (imG, boardx, boardy);
//画出骑士
paintKnight (imG, ox, oy);
//画出骑士的轨迹
paintTrail (imG);
//画出图像缓冲的内容
g.drawImage (imBuffer, 0, 0, this);
}
//画出棋盘――（x, y）是左上角坐标
void paintChessBoard (Graphics g, int x, int y)
{
// 画出棋盘的边框
g.setColor (Color.black);
g.drawRect (x, y, 8 * SQUAREDIM + 1, 8 * SQUAREDIM + 1);
//画出棋盘
for (int row = 0; row < 8; row++)
{
g.setColor (((row & 1) != 0) ? SQUARECOLOR : Color.white);
for (int col = 0; col < 8; col++)
{
g.fillRect (x + 1 + col * SQUAREDIM, y + 1 + row * SQUAREDIM,
SQUAREDIM, SQUAREDIM);
g.setColor ((g.getColor () == SQUARECOLOR) ? Color.white :
SQUARECOLOR);
}
}
}
//画出骑士――（x, y）是图片左上角坐标
void paintKnight (Graphics g, int x, int y)
{
g.drawImage (imKnight, x, y, a);
}
//画出骑士的轨迹
void paintTrail (Graphics g)
{
g.setColor (Color.black);
int len = trail.size ();
if (len == 0)
return;
Point pt = (Point) trail.get (0);
int ox = pt.x;
int oy = pt.y;
for (int i = 1; i < len; i++)
{
pt = (Point) trail.get (i);
g.drawLine (ox, oy, pt.x, pt.y);
ox = pt.x;
oy = pt.y;
}
}
//清空ArrayList来重设棋盘
public void reset ()
{
trail.clear ();
}
// The AWT invokes the update() method in response to the repaint() method
// call that is made as a knight is moved. The default implementation of
// this method, which is inherited from the Container class, clears the
// applet's drawing area to the background color prior to calling paint().
// This clearing followed by drawing causes flicker. KT overrides
// update() to prevent the background from being cleared, which eliminates
// the flicker.
public void update (Graphics g)
{
paint (g);
}
}
清单1展示了基于抽象窗口工具集(AWT)的KT小程序。当然我并没有半点反对Swing的意思――我只是希望让KT集中于AWT。小程序的public void init()方法负责创建程序界面，包含一个ChessBoard类的实例用来描述一个棋盘。
ChessBoard继续自java.awt.Canvas，从定制的AWT组件中实例化ChessBoard。构造器负责决定各个部件的大小，导入骑士图片，安置左上角为骑士的初始位置和创建一个数据结构来保存骑士巡游的轨迹。程序覆盖了public Dimension getPreferredSize()方法，用来返回组件的大小，通知布局治理器ChessBoard希望在布局操作时维持这些尺寸为首选的大小。
我同样也覆盖了public void addNotify()方法，以便createImage()方法被调用时不返回null值。当Canvas（或许我应该说ChessBoard）创建完成时这个方法才返回null。在addNotify() 中调用super.addNotify()后，null不会被返回。
public void moveKnight(int boardPosition)方法移动骑士到boardPosition指定的位置上。这个参数必须在1-64的范围内，否则将抛出异常。除了将骑士的图像画在指定位置的中心外，这个方法还将图像的位置保存在前面创建的数据结构中（参看构造器）。public void reset()方法清除数据结构中的内容。假如没有这个方法，连续的巡游将会同时显示以前和新的巡游轨迹。此外，数据结构应该控制大小的增长，避免浪费内存和最终导致内存不足的错误。剩下的方法负责画出棋盘，画出骑士的图像和轨迹。同样，update()方法被覆盖来防止闪烁。
编译清单1以后，你应该想运行这个小程序。但是，在你能运行它之前，你必须通过Html来向小程序查看器（appletviewer）描述我们编写的小程序。清单2提供了所需的HTML
清单2. KT.html
