core代码分析1--Coord

core.Coord.java

/**

 * Class to hold 2D coordinates and perform simple arithmetics and

 * transformations

 */

//A class implements the Cloneable interface to indicate to the java.lang.Object.clone() method that it is legal for that method to make a field-for-field copy of instances of that class.

public class Coord   implements  Cloneable, Comparable<Coord> {

private double x;

private double y;

/**

 *  Constructor.

 * @param x Initial X-coordinate

 * @param y Initial Y-coordinate

 */

public Coord(double x, double y) {

setLocation(x,y);

}

/**

 *  Sets the location of this coordinate object

 * @param x The x coordinate to set

 * @param y The y coordinate to set

 */

public void  setLocation(double x, double y) {

this.x = x;

this.y = y;

}

/**

 *  Sets this coordinate's location to be equal to other

 * coordinates location

 * @param c The other coordinate

 */

public void setLocation(Coord c) {

this.x = c.x;

this.y = c.y;

}

/**

 *  Moves the point by dx and dy

 * @param dx How much to move the point in X-direction

 * @param dy How much to move the point in Y-direction

 */

public void translate(double dx, double dy) {

this.x += dx;

this.y += dy;

}

/**

 *  Returns the distance to another coordinate

 * @param other The other coordinate

 * @return The distance between this and another coordinate

 */

public double distance(Coord other) {

double dx = this.x - other.x;

double dy = this.y - other.y;

return Math.sqrt(dx*dx + dy*dy);

}

/**

 *  Returns the x coordinate

 * @return x coordinate

 */

public double getX() {

return this.x;

}

/**

 *  Returns the y coordinate

 * @return y coordinate

 */

public double getY() {

return this.y;

}

/**

 *  Returns a text representation of the coordinate (rounded to 2 decimals)

 * @return a text representation of the coordinate

 */

public String toString() {

return String.format("(%.2f,%.2f)",x,y);

}

/**

 *  Returns a clone of this coordinate(不太懂)

 */

public Coord clone() {

Coord clone = null;

try {

clone = (Coord) super.clone();

} catch (CloneNotSupportedException e) {

e.printStackTrace();

System.exit(-1);

}

return clone;

}

/**

 *  Checks if this coordinate's location is equal to other coordinate's

 * @param c The other coordinate

 * @return True if locations are the same

 */

public boolean equals(Coord c) {

if (c == this) {

return true;

}

else {

return (x == c.x && y == c.y);

}

}

@Override

public boolean equals(Object o) {

return equals((Coord) o);

}

/**

 *  Returns a hash code for this coordinate

 *  (actually a hash of the String made of the coordinates)（再看）

 */

public int hashCode() {

return (x+","+y).hashCode();

}

/**

 *  Compares this coordinate to other coordinate. Coordinate whose y

 * value is smaller comes first and if y values are equal, the one with

 * smaller x value comes first.

 * @return -1, 0 or 1 if this node is before, in the same place or

 * after the other coordinate

 */

public int compareTo(Coord other) {

if (this.y < other.y) {

return -1;

}

else if (this.y > other.y) {

return 1;

}

else if (this.x < other.x) {

return -1;

}

else if (this.x > other.x) {

return 1;

}

else {

return 0;

}

}

}

hashCode（）

public int hashCode() {

    int h = hash;

    if (h == 0 && count > 0) {

        int off = offset;

        char val[] = value;

        int len = count;

        for (int i = 0; i < len; i++) {

            h = 31*h + val[off++];

        }

        hash = h;

    }

    return h;

}