81JAVA课设报告书―扫雷游戏

课程设计说明书NO.1扫雷游戏1课程设计目的本次课程设计是用Java语言及相关知识设计一个扫雷游戏系统，完成扫雷游戏的基本功能，并在此基础上，自行完善和优化系统功能。理解掌握选择游戏级别，记录游戏时间和保存游戏成绩的方法，学习程序设计的基本思路和方法，培养计算机专业学生运用所学知识解决计算机应用领域内实际问题能力，进一步提高自身动手操作能力和用Java语言综合编程能力，程序调试技能。2功能描述2.1设计背景图形用户界面简称GUI，是用图形的方式，借助菜单、按钮等标准界面元素和鼠标操作，帮助用户方便地向计算机系统发出指令、启动操作，并将系统的运行结果同样以图形的方式显示给用户的技术。JAVA的图形用户界面技术即为使用java.awt包来创建图形界面的方法，包括AWT组件、窗口和菜单设计、布局管理期以及绘图操作等。AWT既抽象窗口工具集，用于图形用户界面的开发。AWT的功能包括以下方面：（1）丰富的图形界面组件。（2）强大的事件处理模型图形和图形工具，暴扣形状、颜色和字体。（3）布局管理器，可以进行灵活的窗口布局，设计特定窗口的尺寸和屏幕分率。（4）无关数据传送类，可以通过本地平台的剪贴板来进行剪切和粘贴操作。（5）打印和无鼠标操作。Java.awt是java基本包中最大的一个，其中定义了所有的GUI组件类，以及其他用于构造图形界面的类。2.2需求分析（1）扫雷游戏分为初级、中级和高级三个级别，扫雷英雄榜存储每个级别的最好成绩，即挖出全部的地雷且用时最少者。单击游戏菜单可以选择“初级”、“中级”和“高级”或查看“英雄榜”。（2）选择级别后将出现相应级别的扫雷区域，这时用户使用鼠标左键单击雷区中的任课程设计说明书NO.2何一个方块便启动计时器。（3）用户要揭开某个方块，可单击它。若所揭方块下有雷，用户便输了这一局，若所揭方块下无雷，则显示一个数字，该数字代表方块的周围的8个方块中共有多少颗雷。（4）如果用户认为某个方块下埋着雷，单击右键可以在方块上表示一个用户认为是雷的图标，即给出一个扫雷标记。用户每标记一个扫雷标记（无论用户的标记是否正确），程序将显示的剩余雷数减少一个。（5）扫雷胜利后（用时最少者），程序弹出保存成绩的对话框。3设计方案论证3.1概要设计在设计扫雷游戏时，需要编写7个Java源程序：MineGame.java、MineArea.java、Block.java、BlockView.java、LayMines.java、Record.java和ShowRecord.java。扫雷游戏除了需要编写上述7个Java源文件所给出的类外，还需要Java系统提供的一些重要的类，如File、JButton和JLabel等类。扫雷游戏所用到的一些重要的类以及之间的组合关系如图1所示。图1类之间的组和关系（1）MineGame.java(主类)MineGame类负责创建扫雷游戏机主窗口，该文件含有main方法，扫雷游戏从该类开始执行。MineGame类主要有三种类型的成员：File、MineArea和ShowRecord对象。MineGameFileMineAreaShowRecordLayMinesRecordBlockViewBlockJButtonJLabel课程设计说明书NO.3（2）MineArea.javaMineArea类创建的对象是MineArea类最重要的成员之一，代表“扫雷区域”。该类的成员变量中有5个重要类型的对象：Block、BlockView、LayMines和Record。（3）Block.javaBlock类是雷区中“方块”的类封装，含有关于“方块”的属性以及操作，即负责为雷区创建代表“方块”的Block对象。（4）BlockView.javaBlockView是JPanel容器的子类，BlockView创建的对象负责为Block对象提供视图，以便用户通过该视图与Block对象交互。BlockView对象使用一个标签和按钮为Block对象提供视图，标签和按钮按着卡片布局（CardLayout）层叠在一起，默认状态下按钮遮挡住标签。当用户单击按钮后，如果Block对象是雷，BlockView对象中的标签显示的是雷的图标；如果Block对象不是是雷，标签显示的是当前Block对象周围雷的总数。（5）LayMines.javaLayMines类对象不需要视图，在游戏中不需要看见该对象。LayMines对象使用随机算法指定MineArea对象中的哪些Block对象是雷，哪些Block对象不是雷。（6）Record.javaRecord类是JDialog对话框的子类，当用户扫雷成功时，Record对象负责保存用户的成绩到文件。（7）ShowRecord.javaShowRecord类是JDialog对话框的子类，当用户查看扫雷的最好成功时，ShowRecord对象负责读取文件数据的界面。该游戏的整体设计流程图如图2所示：课程设计说明书NO.4图2主要流程图3.2详细设计（1）MineGame类MineGame类是javax.swing包中JFrame的一个子类，并实现了ActionListener接口，该类的主要成员变量和方法：①成员变量开始左键点击扫雷该处是雷是数值表示周围雷数确定此处是雷右键标记所有雷都找出是优胜结束否否课程设计说明书NO.51）bar和fileMenu提供菜单操作，单击游戏菜单中的选项为“初级”、“中级”和“高级”或“扫雷英雄榜”。2）mineArea是扫雷区域，提供有关扫雷的主要功能。3）“英雄榜”负责存放三个级别的扫雷最好的成绩。4）showHeroRecord负责显示英雄榜中的数据。②方法1）MineGame()是构造方法，负责完成窗口的初始化。2）actionPerformed(ActionEvent)方法是MineGame类实现的ActionListener接口中的方法，该方法负责执行菜单发出的有关命令。用户选择菜单中项可触发ActionListener事件，导致actionPerformed(ActionEvent)方法执行相应的操作，例如将创建的雷区设置为初级、中级或高级等。3）main(String[])方法是程序运行的入口方法。（2）MineArea类MineArea类是javax.swing包中JPanel容器的子类，实现了ActionListener和MouseListener接口，所创建的对象：mineArea是MineArea类中最重要的成员之一，作为一个容器添加到窗口的中心。MineArea类的主要成员变量、方法：①成员变量1）block是Block类型的数组，用来确定雷区有多少需进行扫雷的方块。2）blockView是BlockView类型的数组，负责为block数组中的Block对象提供视图。3）lay是LayMines类型的对象，负责设置block数组中的哪些方块是雷或不是雷。4）record负责提供保存成绩的界面，是一个对话框，默认不可见。用户只有扫雷成功后（用时最少者），才可以看见该对话框。6）reStart是一个按钮对象，用户单击它重新开始游戏。7）time是计时器对象，负责计算用户的用时。②方法1）initMineArea(int,int,int,int)方法可根据参数提供的数据设置雷区的宽度、高度、雷的数量以及雷区的级别。2）actionPerformed(ActionEvent)是MineArea类实现的ActionListener接口中的方法。当用户单击blockView中的某个方块时，actionPerformed(ActionEvent)方法负责执行有课程设计说明书NO.6关算法，例如，当用鼠标左键单击方块上的按钮后，若方块下有雷，actionPerformed(ActionEvent)方法将使用户输掉本局，若该方块下无雷，actionPerformed(ActionEvent)方法将显示BlockView对象中的标签，该标签上是一个数字，该数字代表当前方块的周围的8个方块中共有多少颗雷。3）Show()方法是一个递归方法。actionPerformed(ActionEvent)方法执行时将调用方法进行扫雷。4）mousePressed(MouseEvent)方法是MineArea类实现的MouseListener接口中的方法，当用户按下鼠标右键时，actionPerformed(ActionEvent)方法负责让方块上线是一个探雷标记。5）inquireWin()方法用来判断用户是否扫雷成功，如果成功该方法负责让record对话框可见。所谓扫雷成功是指不仅找到全部的雷而且用时最少。（3）Block类Block类创建的对象是数组block的单元中的对象。Block型数组block是MineArea类的重要成员之一。Block类的主要成员变量和方法：①成员变量1)name是方块上的名字。2)aroundMineNumber是方块周围雷的数目。3)mineIcon是方块上雷的图标。4)isMine用来表示方块是否是雷。5)isMark用来表示方块是否被标记。6)isOpen用来表示方块是否被挖开。②方法1）setAroundMineNumber(int)方法用来设置aroundMineNumber的值。2）getAroundMineNumber()方法用来获取aroundMineNumber的值。（4）BlockView类BlockView类是javax.swing包中JPanel类的子类，创建的对象是数组blockView的单元中的对象。blockView是BlockView类的最重要的成员之一。BlockView类的主要成员变量和方法：①成员变量课程设计说明书NO.71）blockNameOrIcon用来显示Block对象的name、number和mineIcon属性。2）blockCover用来遮挡card卡片式布局。②方法1）giveView(Blockblock)方法给参数指定的Block对象提供视图，如果Block对象的isMine属性为true，即方块是雷，那么blockNameOrIcon标签上设置的文本就是Block对象的name属性的值，同时blockNameOrIcon标签上设置的图标就是Block对象的mineIcon制定的图标。如果Block对象的isMine属性为false，blockNameOrIcon标签上设置的文本是Block对象的aroundMineNumber属性的值，即周围雷的数目。2）seeBlockNameOrIcon()方法让用户看见视图中的标签，无法看见按钮。3）seeBlockCover()方法让用户看见视图中的按钮，无法看见标签。（5）LayMines类LayMines类创建的对象lay是MineArea中最重要的成员。该类的主要成员变量和方法：①成员变量mineIcon用来存放一个格式gif的图像。②方法layMinesForBlock(Block[][],int)方法对参数指定的Block数组进行设置，其中int参数制定雷的数目。当指定Block数组中某个单元中的方块是雷时，就将该方块上的图标设置为mineIcon。当指定Block数组中某个单元中的方块不是雷时，就将该方块上的名字设置为周围的雷的数目。（6）Record类Record是javax.swing包中JDialog对话框的子类，并实现了ActionListener接口。Record创建的对象：record是MineArea类的成员之一，当用户扫雷成功时，该对象提供了保存成绩到文件的界面。Record类的主要成员变量、方法：①成员变量1）textName提供用户扫雷优胜者输出姓名。2）用户单击“确定”按钮，可以保存成绩。②方法课程设计说明书NO.81）actionPerformed(ActionEvent)方法是Record类实现的ActionListener接口中的方法，当用户单击“确定”按钮后，该方法被执行，