Frames | No Frames |
1: /* =========================================================== 2: * JFreeChart : a free chart library for the Java(tm) platform 3: * =========================================================== 4: * 5: * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 6: * 7: * Project Info: http://www.jfree.org/jfreechart/index.html 8: * 9: * This library is free software; you can redistribute it and/or modify it 10: * under the terms of the GNU Lesser General Public License as published by 11: * the Free Software Foundation; either version 2.1 of the License, or 12: * (at your option) any later version. 13: * 14: * This library is distributed in the hope that it will be useful, but 15: * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 16: * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 17: * License for more details. 18: * 19: * You should have received a copy of the GNU Lesser General Public 20: * License along with this library; if not, write to the Free Software 21: * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 22: * USA. 23: * 24: * [Java is a trademark or registered trademark of Sun Microsystems, Inc. 25: * in the United States and other countries.] 26: * 27: * --------------------------- 28: * StandardXYURLGenerator.java 29: * --------------------------- 30: * (C) Copyright 2002-2005, by Richard Atkinson and Contributors. 31: * 32: * Original Author: Richard Atkinson; 33: * Contributors: David Gilbert (for Object Refinery Limited); 34: * 35: * $Id: StandardXYURLGenerator.java,v 1.6.2.1 2005/10/25 20:59:31 mungady Exp $ 36: * 37: * Changes: 38: * -------- 39: * 05-Aug-2002 : Version 1, contributed by Richard Atkinson; 40: * 29-Aug-2002 : New constructor and member variables to customise series and 41: * item parameter names (RA); 42: * 09-Oct-2002 : Fixed errors reported by Checkstyle (DG); 43: * 23-Mar-2003 : Implemented Serializable (DG); 44: * 01-Mar-2004 : Added equals() method (DG); 45: * 13-Jan-2005 : Modified for XHTML 1.0 compliance (DG); 46: * 47: */ 48: 49: package org.jfree.chart.urls; 50: 51: import java.io.Serializable; 52: 53: import org.jfree.data.xy.XYDataset; 54: import org.jfree.util.ObjectUtilities; 55: 56: /** 57: * A URL generator. 58: * 59: * @author Richard Atkinson 60: */ 61: public class StandardXYURLGenerator implements XYURLGenerator, Serializable { 62: 63: /** For serialization. */ 64: private static final long serialVersionUID = -1771624523496595382L; 65: 66: /** The default prefix. */ 67: public static final String DEFAULT_PREFIX = "index.html"; 68: 69: /** The default series parameter. */ 70: public static final String DEFAULT_SERIES_PARAMETER = "series"; 71: 72: /** The default item parameter. */ 73: public static final String DEFAULT_ITEM_PARAMETER = "item"; 74: 75: /** Prefix to the URL */ 76: private String prefix; 77: 78: /** Series parameter name to go in each URL */ 79: private String seriesParameterName; 80: 81: /** Item parameter name to go in each URL */ 82: private String itemParameterName; 83: 84: /** 85: * Creates a new default generator. This constructor is equivalent to 86: * calling <code>StandardXYURLGenerator("index.html", "series", "item"); 87: * </code>. 88: */ 89: public StandardXYURLGenerator() { 90: this(DEFAULT_PREFIX, DEFAULT_SERIES_PARAMETER, DEFAULT_ITEM_PARAMETER); 91: } 92: 93: /** 94: * Creates a new generator with the specified prefix. This constructor 95: * is equivalent to calling 96: * <code>StandardXYURLGenerator(prefix, "series", "item");</code>. 97: * 98: * @param prefix the prefix to the URL (<code>null</code> not permitted). 99: */ 100: public StandardXYURLGenerator(String prefix) { 101: this(prefix, DEFAULT_SERIES_PARAMETER, DEFAULT_ITEM_PARAMETER); 102: } 103: 104: /** 105: * Constructor that overrides all the defaults 106: * 107: * @param prefix the prefix to the URL (<code>null</code> not permitted). 108: * @param seriesParameterName the name of the series parameter to go in 109: * each URL (<code>null</code> not permitted). 110: * @param itemParameterName the name of the item parameter to go in each 111: * URL (<code>null</code> not permitted). 112: */ 113: public StandardXYURLGenerator(String prefix, 114: String seriesParameterName, 115: String itemParameterName) { 116: if (prefix == null) { 117: throw new IllegalArgumentException("Null 'prefix' argument."); 118: } 119: if (seriesParameterName == null) { 120: throw new IllegalArgumentException( 121: "Null 'seriesParameterName' argument." 122: ); 123: } 124: if (itemParameterName == null) { 125: throw new IllegalArgumentException( 126: "Null 'itemParameterName' argument." 127: ); 128: } 129: this.prefix = prefix; 130: this.seriesParameterName = seriesParameterName; 131: this.itemParameterName = itemParameterName; 132: } 133: 134: /** 135: * Generates a URL for a particular item within a series. 136: * 137: * @param dataset the dataset. 138: * @param series the series number (zero-based index). 139: * @param item the item number (zero-based index). 140: * 141: * @return The generated URL. 142: */ 143: public String generateURL(XYDataset dataset, int series, int item) { 144: String url = this.prefix; 145: boolean firstParameter = url.indexOf("?") == -1; 146: url += firstParameter ? "?" : "&"; 147: url += this.seriesParameterName + "=" + series 148: + "&" + this.itemParameterName + "=" + item; 149: return url; 150: } 151: 152: /** 153: * Tests this generator for equality with an arbitrary object. 154: * 155: * @param obj the object (<code>null</code> permitted). 156: * 157: * @return A boolean. 158: */ 159: public boolean equals(Object obj) { 160: if (obj == this) { 161: return true; 162: } 163: if (!(obj instanceof StandardXYURLGenerator)) { 164: return false; 165: } 166: StandardXYURLGenerator that = (StandardXYURLGenerator) obj; 167: if (!ObjectUtilities.equal(that.prefix, this.prefix)) { 168: return false; 169: } 170: if (!ObjectUtilities.equal(that.seriesParameterName, 171: this.seriesParameterName)) { 172: return false; 173: } 174: if (!ObjectUtilities.equal(that.itemParameterName, 175: this.itemParameterName)) { 176: return false; 177: } 178: return true; 179: } 180: 181: }