001: /* ===========================================================
002: * JFreeChart : a free chart library for the Java(tm) platform
003: * ===========================================================
004: *
005: * (C) Copyright 2000-2007, by Object Refinery Limited and Contributors.
006: *
007: * Project Info: http://www.jfree.org/jfreechart/index.html
008: *
009: * This library is free software; you can redistribute it and/or modify it
010: * under the terms of the GNU Lesser General Public License as published by
011: * the Free Software Foundation; either version 2.1 of the License, or
012: * (at your option) any later version.
013: *
014: * This library is distributed in the hope that it will be useful, but
015: * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
016: * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
017: * License for more details.
018: *
019: * You should have received a copy of the GNU Lesser General Public
020: * License along with this library; if not, write to the Free Software
021: * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
022: * USA.
023: *
024: * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
025: * in the United States and other countries.]
026: *
027: * ---------------------
028: * XYCoordinateType.java
029: * ---------------------
030: * (C) Copyright 2007, by Object Refinery Limited and Contributors.
031: *
032: * Original Author: David Gilbert (for Object Refinery Limited);
033: * Contributor(s): -;
034: *
035: * $Id: XYCoordinateType.java,v 1.1.2.1 2007/02/02 13:26:35 mungady Exp $
036: *
037: * Changes
038: * -------
039: * 02-Feb-2007 : Version 1 (DG);
040: *
041: */
042:
043: package org.jfree.experimental.chart.util;
044:
045: import java.io.ObjectStreamException;
046: import java.io.Serializable;
047:
048: /**
049: * Represents several possible interpretations for an (x, y) coordinate.
050: */
051: public final class XYCoordinateType implements Serializable {
052:
053: /** The (x, y) coordinates represent a point in the data space. */
054: public static final XYCoordinateType DATA = new XYCoordinateType(
055: "XYCoordinateType.DATA");
056:
057: /**
058: * The (x, y) coordinates represent a relative position in the data space.
059: * In this case, the values should be in the range (0.0 to 1.0).
060: */
061: public static final XYCoordinateType RELATIVE = new XYCoordinateType(
062: "XYCoordinateType.RELATIVE");
063:
064: /**
065: * The (x, y) coordinates represent indices in a dataset.
066: * In this case, the values should be in the range (0.0 to 1.0).
067: */
068: public static final XYCoordinateType INDEX = new XYCoordinateType(
069: "XYCoordinateType.INDEX");
070:
071: /** The name. */
072: private String name;
073:
074: /**
075: * Private constructor.
076: *
077: * @param name the name.
078: */
079: private XYCoordinateType(String name) {
080: this .name = name;
081: }
082:
083: /**
084: * Returns a string representing the object.
085: *
086: * @return The string.
087: */
088: public String toString() {
089: return this .name;
090: }
091:
092: /**
093: * Returns <code>true</code> if this object is equal to the specified
094: * object, and <code>false</code> otherwise.
095: *
096: * @param obj the other object.
097: *
098: * @return A boolean.
099: */
100: public boolean equals(Object obj) {
101: if (this == obj) {
102: return true;
103: }
104: if (!(obj instanceof XYCoordinateType)) {
105: return false;
106: }
107: XYCoordinateType order = (XYCoordinateType) obj;
108: if (!this .name.equals(order.toString())) {
109: return false;
110: }
111: return true;
112: }
113:
114: /**
115: * Ensures that serialization returns the unique instances.
116: *
117: * @return The object.
118: *
119: * @throws ObjectStreamException if there is a problem.
120: */
121: private Object readResolve() throws ObjectStreamException {
122: if (this.equals(XYCoordinateType.DATA)) {
123: return XYCoordinateType.DATA;
124: } else if (this.equals(XYCoordinateType.RELATIVE)) {
125: return XYCoordinateType.RELATIVE;
126: } else if (this.equals(XYCoordinateType.INDEX)) {
127: return XYCoordinateType.INDEX;
128: }
129: return null;
130: }
131:
132: }
|