基于 Java 语言编制一个魔板游戏【100011242】

> ## 开发文档 > > ## 使用文档 > > ## 测试文档 # 开发文档 ## 1、设计目的 本次课程设计是通过 Java 语言编制一个魔板游戏，它是一款经典的智力游戏。而 Java 语言是当今较为流行的网络编程语言，它具有面向对象、跨平台、分布应用等特点。这次课程设计，还有利于加深对 Java 课程的进一步了解，也可以巩固所学 Java 语言基本知识，增进 Java 语言编辑基本功，掌握 JDK、Editplus、Eclipse、JCreator 等开发工具的运用，拓宽常用类库的应用。使学生通过该教学环节与手段，把所学课程及相关知识加以融会贯通，全面掌握 Java 语言的编程思想及面向对象程序设计的方法。 利用所学高级语言的语法特性，结合数据结构算法、网络知识、文件处理和数据库等知识完成综合题目的设计和代码实现，并培养锻炼分析程序、撰写报告等能力。 ## 2、总体设计 在设计魔板游戏时，要编写 8 个 Java 源文件：AppWindow.java、PuzzlePad.java、Point.java、Block.java、HandleImage.java、VerifySuccess.java、AppTest.java 和 HandleMove.java。(其中 AppTest.java 为测试代码) 魔板游戏除了需要编写的上述 8 个 Java 源文件所给出的类外，还需要 Java 系统提供的一些重要的类，如 JMenuItem、JButton 和 JRadioButton 等类。魔板游戏所用到的一些重要的类以及之间的组合关系如图 1 所示。  ## 3、关键技术 ### 3.1 系统的功能模块划分 在设计魔板游戏时，需要编写 8 个 Java 源文件：AppWindow.java、PuzzlePad.java、Point.java、Block.java、HandleImage.java、VerifySuccess.java、AppTest.java 和 HandleMove.java。 魔板游戏除了需要编写的上述 8 个 Java 源文件所给出的类外，还需要 Java 系统提供的一些重要的类，如 JMenuItem、JButton 和 JRadioButton 等类。 以下着重介绍一下本次设计中重要的几个模块： #### 3.1.1 AppWindow.java 类模块 AppWindow 类负责创建魔板游戏的主窗口，该类含有 main 方法，程序从该类开始。AppWindow 类的成员变量中有 5 种重要类型的对象：PuzzlePad、JMenuItem、JRadioButton、JMenu 和 JButton。AppWindow 类的主要成员的作用将在后面的详细设计中阐述，AppWindow 类主要成员变量（属性）和主要方法如表 3-1、3-2 所示。 | 成员变量描述 | 变量类型 | 名称 | | -------------- | ------------ | ------------------ | | 魔板 | PuzzlePad | PuzzlePad | | 开始游戏的按钮 | JButton | 开始 | | 选择玩法 | JRadioButton | 数字玩法，图像玩法 | ``` 表2AppWindow.java主要成员变量（属性） ``` | 名称 | 功能 | 备注 | | --------------- | --------------------- | -------- | | AppWindow | 创建程序主窗口 | 构造方法 | | actionPerformed | 处理 ActionEvent 事件 | 接口方法 | | main | 程序开始运行的方法 | | ``` 表3AppWindow.java主要方法 ``` #### 3.1.2 PuzzlePad.java 类模块 PuzzlePad 类创建的对象是 AppWindow 类最重要的成员之一，代表“魔板”。该类的成员变量中有 5 种重要类型的对象：Point、Block 和 Image。PuzzlePad 类类主要成员变量（属性）和主要方法如表 3-3、3-4 所示。 | 描述 | 变量类型 | 名称 | | ------------------ | --------------- | ------------ | | 魔板中的行数和列数 | int | rows,colums | | 魔板中方块的宽和高 | int | width,height | | 魔板中二维点数组 | SquarePoint[][] | point | | 魔板中而为方块数组 | JButton | block | | 模板可能用到的图像 | Image | image | ``` 表4PuzzlePad.java主要成员变量（属性） ``` | 名称 | 功能 | 备注 | | --------------- | -------------------------- | -------- | | PuzzlePad | 创建魔板对象 | 构造方法 | | 随机排列数字 | 随机排列魔板中方块上的数字 | | | 随机排列图像 | 随机排列魔板中方块上的图像 | | | paintComponent | 绘制图像 | | | actionPerformed | 处理 ActionEvent 事件 | 接口方法 | ``` 表5PuzzlePad.java主要方法 ``` #### 3.1.3 Point.java 类模块 Point 类负责创建确定位置的对象，使用 Point 对象可以确定 Block 对象在 PuzzlePad 对象中的位置，即确定“方块”在“魔板”中的位置。Point.java 类主要成员变量（属性）和主要方法如表 3-5、3-6 所示。 | 描述 | 变量类型 | 名称 | | ------------------ | -------- | ------ | | 判断点上是否有方块 | boolean | 有方块 | | 点上的方块对象 | JButton | block | ``` 表6Point.java主要成员变量（属性） ``` | 名称 | 功能 | 备注 | | ----------- | ------------------ | -------- | | SquarePoint | 创建“点”对象 | 构造方法 | | get 有方块 | 判断点上是否有方块 | | | get 有方块 | 设置点上是否有方块 | | | setBlock | 在点上放置方块 | | | getBlock | 获取点上的方块 | | ``` 表 7Pont.java主要方法 ``` 3.1.4 HandleImage.java 类模块 HandleImage 类的实例负责分解图像，可以将一副图像分解成为若干幅小的图像，并将这些小图像存放在 Image 类型的数组中。 ★ 为丰富该游戏的功能，经过改善后，增加了可以弹出、查看英雄榜和拼图移动时可以播放声音的功能。 #### 3.1.5.RecordOrShowRecord.java 类模块 RecordOrShowRecord 类的实例可以向英雄榜插入记录或查看英雄榜。当用户成功排列魔板中的方块后，如果成绩能排进前三名就弹出一个对话框，将用户的成绩保存到“英雄榜”。 #### 3.1.6. Record.java 类模块 Record 类是 javax.swing.JDialog 的子类，其实例是对话框，提供用户输入姓名的界面。用户输入姓名后对话框自动获得用户的成绩，然后委托 RecordOrShowRecord 的实例检查用户是否可上英雄榜。如果可以上英雄榜，就将用户姓名和成绩录入英雄榜，否则提示用户不能上榜。 #### 3.1.7.ShowRecord.java 类模块 ShowRecord 类是 javax.swing.JDialog 的子类，其实例是对话框，提供显示英雄榜的界面，可以按成绩从高到低显示曾经登上过英雄榜的英雄们。 ## 4、程序流程 根据对模板游戏的功能分析，设计得到魔板游戏总流程，如图 4-1 所示：  ``` 图1系统流程图 ``` 流程解释：程序分为两种玩法，数字玩法和图片玩法，又分为初级和高级两种模式，进入游戏选择游戏难度，后选择玩法，数字或图片玩法，系统将各切片顺序打乱，移动切片，判断顺序是否正确，正确游戏结束，不正确继续移动，程序结束。 # 使用文档 ## 1、用户使用说明 （1）在 JCreater 平台下编译并运行源程序，界面显示如下图所示。  （2） 单击 JMenu 中的“选择级别”，可供用户根据个人需要