黑马Java拼图游戏需求文档和完整代码展示

需求文档

项目名称：拼图游戏

项目概述： 拼图游戏是一款基于Java基础语法开发的桌面游戏，通过拖动图片块来完成图片的拼图，游戏分为重新开始、重新登录、关闭游戏、更换图片等功能。

功能需求：

2.1 游戏界面：

• 游戏界面大小为603x680像素
• 界面标题为“拼图游戏单机版 V1.0
• 界面居中显示 - 界面关闭时退出程序

2.2 菜单功能：

• 功能菜单包括重新开始、重新登录、关闭游戏、更换图片功能 -
• 关于我们菜单包括赞助和版本号功能

2.3 图片功能：

• 可以更换不同类别的图片，包括美女、动物、运动等 - 每类图片包含多张图片可供选择

2.4 游戏操作：

• 键盘移动空白块完成拼图 - 计步器统计步数 - 提供作弊码快速通关

用户界面：

游戏界面包含图片拼图区域、计步器、胜利图片显示区域

数据需求：

二维数组存储图片数据

计数器记录步数

二维数据判断游戏胜利状态

非功能需求：

游戏界面美观、易操作

图片加载速度快

界面响应快速

其他需求：

提供作弊码快速通关

提供赞助和版本号信息

提供重新开始、重新登录、关闭游戏等功能

附加需求：

可以根据用户需求定制更多图片类别和图片数量

部分代码展示（提供详细解释）（完整代码在最下面）

创建初始窗口代码

//创建界面，初始化界面（单独一个方法）
public void init(){
   
	//创建初始窗口
	//Jframe类，界面，窗体（class类继承了JFrame父类）
	//1.设置界面的宽和高
	this.setSize(603,680);
	//2.设置界面标题为“拼图游戏单机版 V1.0”
	this.setTitle("拼图游戏单机版 V1.0");
	//3.设置界面一直处于置顶状态
	this.setAlwaysOnTop(true);//ps:true代表是一直置顶，如果是false就不是一直处于置顶状态
	//4.界面居中显示
	this.setLocationRelativeTo(null);
	//5.设置关闭模式，只要关闭游戏窗口就直接关闭虚拟机，防止关闭游戏后虚拟机持续运行
	this.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
	/*ps:还需要添加一个功能，就是取消添加图片是居中放置，只有取消了以后添加图片才是可以自己设置XY值来添加组件，不然就一直是居中放置*/
	this.setLayout(null);

	//为了游戏的操作，我们还需要设置键盘监听
	this.addKeyListener(this);
}

初始菜单（包括重新开始、重新登录、关闭游戏、更换图片功能 ，赞助和版本号功能）

public void initJMenuBar(){
   
	//JMenuBar就是标题下方的一个长条方框，方框里面的就是对象，对象里面的东西叫做条目
	//先创建一个大的JMenuBar对象
	JMenuBar jMenuBar = new JMenuBar();
	//再创建功能选项
	JMenu functionJMenu = new JMenu("功能");
    JMenu aboutJMenu = new JMenu("关于我们");
    JMenu changeImage = new JMenu("更换图片");//因为更换图片是再功能选项里面，所以我们需要将这个添加到功能对象中

	//创建JMenuItem对象
	//创建选项下面的条目对象，包含《功能》和《关于我们》还有《更换图片》
	//功能
    JMenuItem regainGameItem = new JMenuItem("重新开始");
    JMenuItem loginGameItem = new JMenuItem("重新登录");
    JMenuItem closeGameItem = new JMenuItem("关闭游戏");
    //关于我们
    JMenuItem accountItem = new JMenuItem("赞助");
    JMenuItem aboutGame = new JMenuItem("版本号");
    //更换图片
    JMenuItem girlP = new JMenuItem("换美女");
    JMenuItem animalP = new JMenuItem("换动物");
    JMenuItem sportP = new JMenuItem("换运动");
	
	//需要将创建的JMenuItem对象添加到JMenu对象中，这样可视化界面才会显现出这些条目
	//将JMenuItem条目归类到JMenu对象中
	//ps：将条目归类到对象中，将对象归类到菜单中，将菜单归类到JMenuBar中
    functionJMenu.add(changeImage);//更换图片
    functionJMenu.add(regainGameItem);//重新开始
    functionJMenu.add(loginGameItem);//重新登录
    functionJMenu.add(closeGameItem);//关闭游戏

	aboutJMenu.add(accountItem);//赞助
    aboutJMenu.add(aboutGame);//版本号
    
	changeImage.add(girlP);//换美女
    changeImage.add(animalP);//换动物
    changeImage.add(sportP);//换运动

	//将JMenu对象归类到Bar类
    jMenuBar.add(functionJMenu);
    jMenuBar.add(aboutJMenu);


 	//给条目绑定动作监听（鼠标点击）
        regainGameItem.addActionListener(this);//重新开始
        loginGameItem.addActionListener(this);//重新登录
        closeGameItem.addActionListener(this);//关闭游戏
        accountItem.addActionListener(this);//关于我们
        girlP.addActionListener(this);
        animalP.addActionListener(this);
        sportP.addActionListener(this);

//ps：现在已经将所有东西都归类到他的上一级，最后一步就是将可视化界面设置一下菜单
	this.setJMenuBar(jMenuBar);
}

打乱二维数组，将照片碎片按照打乱后的二维数组进行输出

public void swap(){
   
	Random rd = new Random();
	//图片碎片编号一共是1~15，0代表可移动空白块
    int[] arr = {
   0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15};
    for(int i =0;i<arr.length;i++){
   
    		//创建一个随机数
            int number = rd.nextInt(arr.length);
            int temp = arr[i];
            arr[i] = arr[number];
            arr[number] = temp;
        }
        //给二维数组添加数据
        for(int i =0;i<arr.length;i++){
   
            data[i/4][i%4] = arr[i];
            if(arr[i] == 0){
   
                x = i/4;
                y = i%4;
                //ps：一个小方法，可以将一维数组里的数据存储到二维数组中，只用一层for循环
            }
        }
    }

初始化图片（添加图片）

添加图片需要注意的小知识：先添加的图片显示在上层，后添加的图片显示在下层

 private void initImage(){
   
        //页面刷新
        this.getContentPane().removeAll();//ps：每次空白图片的更换都需要进行刷新界面的操作，不然界面无法更新

        //如果胜利则输出胜利的图标
        if(victory(