Java

Main topics:

GUIs

Program Specification:

You are to finish the following Graphical Mine Sweap program:

You are given the following Complete class MyJButton:

import javax.swing.*;

public class MyJButton extends JButton

{

private static final long serialVersionUID = 2L;

public final int row;

public final int col;

public MyJButton(String text, int row, int col)

{

super(text);

this.row = row;

this.col = col;

}

}

You are also given the following Partial class MineSweapPart:

import javax.swing.*;

import java.awt.*;

import java.awt.event.*;

public class MineSweapPart extends JFrame

{

private static final long serialVersionUID = 1L;

private static final int HEIGHT = 760;

private static final int WIDTH = 760;

private static final int ROWS = 16;

private static final int COLS = 16;

private static final int MINES = 16;

private static int minesLeft = MineSweapPart.MINES;

private static int actualMinesLeft = MineSweapPart.MINES;

private static final String FLAGGED = "@";

private static final String MINE = "M";

// visual indication of an exposed MyJButton

private static final Color expColor = Color.lightGray;

// colors used when displaying the getStateStr() String

private static final Color colorMap[] = {Color.lightGray, Color.blue, Color.green, Color.cyan, Color.yellow, Color.orange, Color.pink, Color.magenta, Color.red, Color.red};

private boolean running = true;

// holds the "number of mines in perimeter" value for each MyJButton

private int[][] sGrid = new int[ROWS][COLS];

public MineSweapPart()

{

this.setTitle("MineSweap " + MineSweapPart.minesLeft +" Mines left");

this.setSize(WIDTH, HEIGHT);

this.setResizable(false);

this.setLayout(new GridLayout(ROWS, COLS, 0, 0));

this.setDefaultCloseOperation(EXIT_ON_CLOSE);

this.createContents();

// place MINES number of mines in sGrid and adjust all of the "mines in perimeter" values

this.setMines();

this.setVisible(true);

}

public void createContents()

{

for (int br = 0; br < ROWS; ++br)

{

for (int bc = 0; bc < COLS; ++bc)

{

// set sGrid[br][bc] entry to 0 - no mines in its perimeter

sGrid[br][bc] = 0;

// create a MyJButton that will be at location (br, bc) in the GridLayout

MyJButton but = new MyJButton("", br, bc);

// register the event handler with this MyJbutton

but.addActionListener(new MyListener());

// add the MyJButton to the GridLayout collection

this.add(but);

}

}

}

// nested private class

private class MyListener implements ActionListener

{

public void actionPerformed(ActionEvent event)

{

if ( running )

{

// used to detrmine if ctrl or alt key was pressed at the time of mouse action

int mod = event.getModifiers();

MyJButton jb = (MyJButton)event.getSource();

// is the MyJbutton that the mouse action occurred in flagged

boolean flagged = jb.getText().equals(MineSweapPart.FLAGGED);

// is the MyJbutton that the mouse action occurred in already exposed

boolean exposed = jb.getBackground().equals(expColor);

// flag a cell : ctrl + left click

if ( !flagged && !exposed && (mod & ActionEvent.CTRL_MASK) != 0 )

{

jb.setText(MineSweapPart.FLAGGED);

--MineSweapPart.minesLeft;

// if the MyJbutton that the mouse action occurred in is a mine

if ( sGrid[jb.row][jb.col] == 9 )

{

// what else do you need to adjust?

// could the game be over?

}

setTitle("MineSweap " + MineSweapPart.minesLeft + " Mines left");

}

// un-flag a cell : alt + left click

else if ( flagged && !exposed && (mod & ActionEvent.ALT_MASK) != 0 )

{

jb.setText("");

++MineSweapPart.minesLeft;

// if the MyJbutton that the mouse action occurred in is a mine

if ( sGrid[jb.row][jb.col] == 9 )

{

// what else do you need to adjust?

// could the game be over?

}

setTitle("MineSweap " + MineSweapPart.minesLeft +" Mines left");

}

// expose a cell : left click else if ( !flagged && !exposed) { exposeCell(jb);

}

}

}

public void exposeCell(MyJButton jb)

{

if ( !running ) return;

// expose this MyJButton

jb.setBackground(expColor);

jb.setForeground(colorMap[sGrid[jb.row][jb.col]]);

jb.setText(getStateStr(jb.row, jb.col));

// if the MyJButton that was just exposed is a mine

if ( sGrid[jb.row][jb.col] == 9 )

{

// what else do you need to adjust?

// could the game be over?

return;

}

// if the MyJButton that was just exposed has no mines in its perimeter

if ( sGrid[jb.row][jb.col] == 0 )

{

// lots of work here - must expose all MyJButtons in its perimeter

// and so on

// and so on

// .

// .

// .

}

}

}

// nested private class

public static void main(String[] args)

{

new MineSweapPart();

}

//************************************************************************************************

// place MINES number of mines in sGrid and adjust all of the "mines in perimeter" values private void setMines()

{

// your code here ...

}

private String getStateStr(int row, int col)

{

// no mines in this MyJbuttons perimeter

if ( this.sGrid[row][col] == 0 )

return "";

// 1 to 8 mines in this MyJButtons perimeter

else if ( this.sGrid[row][col] > 0 && this.sGrid[row][col] < 9 )

return "" + this.sGrid[row][col];

// this MyJButton in a mine

else

return MineSweapPart.MINE;

}

}

Rules and Requirements:

Your game must play equivalently to the original Windows MineSweap game

You may NOT remove any of the supplied or implied (via the comment blocks) functionality in these classes.

You must implement ALL of the implied (via the comment blocks) functionality in these classes.

You MAY implement additional functionality / features in these classes.