лабораторная 3 / Map2D

/** Этот класс представляет собой простую двумерную карту, состоящую из квадратных ячеек.
 * В каждой ячейке указывается стоимость обхода этой ячейки. **/
public class Map2D {
    /** Ширина и высота карты. **/
    private int width;
    private int height;
    /** Фактические картографические данные, необходимые алгоритму поиска пути для навигации. **/
    private int[][] cells;
    /** Начальное и конечное местоположение для выполнения поиска пути A*. **/
    private Location start;
    private Location finish;
    /** Создает новую 2D-карту с заданными шириной и высотой. **/
    public Map2D(int width, int height) {
        if (width <= 0 || height <= 0) {
            /** выдает исколючение IllegalArgumentException**/
            throw new IllegalArgumentException("ширина и высота должны быть положительными значениями; " +
                    "получено" + width + "x" + height);
        }
        this.width = width;
        this.height = height;
        cells = new int[width][height];

        // Составьте несколько координат для начала и конца.
        start = new Location(0,height / 2);
        finish = new Location(width - 1, height / 2);
    }
    /** Этот вспомогательный метод проверяет указанные координаты, чтобы увидеть, находятся ли они
     * в пределах границ карты. Если координаты отсутствуют на карте
     * затем метод выдает исключение <code>IllegalArgumentException</code>. **/
    private void checkCoords(int x, int y) {
        if (x < 0 || x > width) {
            /** выдает исколючение IllegalArgumentException**/
            throw new IllegalArgumentException("x должен быть в диапазоне [0, " +
                    width + "), got " + x);
        }
        if (y < 0 || y > height) {
            /** выдает исколючение IllegalArgumentException **/
            throw new IllegalArgumentException("y должен быть в диапазоне [0, " +
                    height + "), got " + y);
        }
    }
    /** Возвращает ширину и высоту карты. **/
    public int getWidth() {
        return width;
    }
    public int getHeight() {
        return height;
    }
    /** Возвращает значение true, если указанные координаты содержатся на карте площадь. **/
    public boolean contains(int x, int y) {
        return (x >= 0 && x < width && y >= 0 && y < height);
    }
    /** Возвращает значение true, если местоположение содержится в пределах области карты. **/
    public boolean contains(Location loc) {
        return contains(loc.xCoord, loc.yCoord);
    }
    /** Возвращает сохраненное значение стоимости для указанной ячейки. **/
    public int getCellValue(int x, int y) {
        checkCoords(x, y);
        return cells[x][y];
    }
    /** Возвращает сохраненное значение стоимости для указанной ячейки. **/
    public int getCellValue(Location loc) {
        return getCellValue(loc.xCoord, loc.yCoord);
    }
    /** Задает значение себестоимости для указанной ячейки. **/
    public void setCellValue(int x, int y, int value) {
        checkCoords(x, y);
        cells[x][y] = value;
    }
    /** Возвращает начальное местоположение для карты. Именно здесь сгенерированный путь начнется. **/
    public Location getStart() {
        return start;
    }
    /** Задает начальное местоположение для карты. Здесь находится сгенерированный путь начнется. **/
    public void setStart(Location loc) {
        if (loc == null)
            throw new NullPointerException("loc cannot be null");
        start = loc;
    }
    /** Возвращает конечное местоположение на карте. Именно здесь сгенерированный путь завершится. **/
    public Location getFinish() {
        return finish;
    }
    /** Задает конечное местоположение для карты. Здесь находится сгенерированный путь завершится. **/
    public void setFinish(Location loc) {
        if (loc == null)
            throw new NullPointerException("loc cannot be null");
        finish = loc;
    }
}