001/* ======================================
002 * JFreeChart : a free Java chart library
003 * ======================================
004 *
005 * (C) Copyright 2000-2013, 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 * [Oracle and Java are registered trademarks of Oracle and/or its affiliates. 
025 * Other names may be trademarks of their respective owners.]
026 *
027 * --------------------------
028 * CustomPieURLGenerator.java
029 * --------------------------
030 * (C) Copyright 2004-2008, by David Basten and Contributors.
031 *
032 * Original Author:  David Basten;
033 * Contributors:     -;
034 *
035 * Changes:
036 * --------
037 * 04-Feb-2004 : Version 1, contributed by David Basten based on
038 *               CustomXYURLGenerator by Richard Atkinson (added to main source
039 *               tree on 25-May-2004);
040 *
041 */
042
043package org.jfree.chart.urls;
044
045import java.io.Serializable;
046import java.util.ArrayList;
047import java.util.HashMap;
048import java.util.Iterator;
049import java.util.Map;
050import java.util.Set;
051
052import org.jfree.chart.plot.MultiplePiePlot;
053import org.jfree.data.general.PieDataset;
054import org.jfree.util.PublicCloneable;
055
056/**
057 * A custom URL generator for pie charts.
058 */
059public class CustomPieURLGenerator implements PieURLGenerator,
060        Cloneable, PublicCloneable, Serializable {
061
062    /** For serialization. */
063    private static final long serialVersionUID = 7100607670144900503L;
064
065    /** Storage for the URLs. */
066    private ArrayList urls;
067
068    /**
069     * Creates a new <code>CustomPieURLGenerator</code> instance, initially
070     * empty.  Call {@link #addURLs(Map)} to specify the URL fragments to be
071     * used.
072     */
073    public CustomPieURLGenerator() {
074        this.urls = new ArrayList();
075    }
076
077    /**
078     * Generates a URL fragment.
079     *
080     * @param dataset  the dataset (ignored).
081     * @param key  the item key.
082     * @param pieIndex  the pie index.
083     *
084     * @return A string containing the generated URL.
085     *
086     * @see #getURL(Comparable, int)
087     */
088    @Override
089    public String generateURL(PieDataset dataset, Comparable key,
090                              int pieIndex) {
091        return getURL(key, pieIndex);
092    }
093
094    /**
095     * Returns the number of URL maps stored by the renderer.
096     *
097     * @return The list count.
098     *
099     * @see #addURLs(Map)
100     */
101    public int getListCount() {
102        return this.urls.size();
103    }
104
105    /**
106     * Returns the number of URLs in a given map (specified by its position
107     * in the map list).
108     *
109     * @param list  the list index (zero based).
110     *
111     * @return The URL count.
112     *
113     * @see #getListCount()
114     */
115    public int getURLCount(int list) {
116        int result = 0;
117        Map urlMap = (Map) this.urls.get(list);
118        if (urlMap != null) {
119            result = urlMap.size();
120        }
121        return result;
122    }
123
124    /**
125     * Returns the URL for a section in the specified map.
126     *
127     * @param key  the key.
128     * @param mapIndex  the map index.
129     *
130     * @return The URL.
131     */
132    public String getURL(Comparable key, int mapIndex) {
133        String result = null;
134        if (mapIndex < getListCount()) {
135            Map urlMap = (Map) this.urls.get(mapIndex);
136            if (urlMap != null) {
137                result = (String) urlMap.get(key);
138            }
139        }
140        return result;
141    }
142
143    /**
144     * Adds a map containing <code>(key, URL)</code> mappings where each
145     * <code>key</code> is an instance of <code>Comparable</code>
146     * (corresponding to the key for an item in a pie dataset) and each
147     * <code>URL</code> is a <code>String</code> representing a URL fragment.
148     * <br><br>
149     * The map is appended to an internal list...you can add multiple maps
150     * if you are working with, say, a {@link MultiplePiePlot}.
151     *
152     * @param urlMap  the URLs (<code>null</code> permitted).
153     */
154    public void addURLs(Map urlMap) {
155        this.urls.add(urlMap);
156    }
157
158    /**
159     * Tests if this object is equal to another.
160     *
161     * @param o  the other object.
162     *
163     * @return A boolean.
164     */
165    @Override
166    public boolean equals(Object o) {
167
168        if (o == this) {
169            return true;
170        }
171
172        if (o instanceof CustomPieURLGenerator) {
173            CustomPieURLGenerator generator = (CustomPieURLGenerator) o;
174            if (getListCount() != generator.getListCount()) {
175                return false;
176            }
177            Set keySet;
178            for (int pieItem = 0; pieItem < getListCount(); pieItem++) {
179                if (getURLCount(pieItem) != generator.getURLCount(pieItem)) {
180                    return false;
181                }
182                keySet = ((HashMap) this.urls.get(pieItem)).keySet();
183                String key;
184                for (Iterator i = keySet.iterator(); i.hasNext();) {
185                key = (String) i.next();
186                    if (!getURL(key, pieItem).equals(
187                            generator.getURL(key, pieItem))) {
188                        return false;
189                    }
190                }
191            }
192            return true;
193        }
194        return false;
195    }
196
197    /**
198     * Returns a clone of the generator.
199     *
200     * @return A clone.
201     *
202     * @throws CloneNotSupportedException if cloning is not supported.
203     */
204    @Override
205    public Object clone() throws CloneNotSupportedException {
206        CustomPieURLGenerator urlGen = new CustomPieURLGenerator();
207        Map map;
208        Map newMap;
209        String key;
210
211        for (Iterator i = this.urls.iterator(); i.hasNext();) {
212            map = (Map) i.next();
213
214            newMap = new HashMap();
215            for (Iterator j = map.keySet().iterator(); j.hasNext();) {
216                key = (String) j.next();
217                newMap.put(key, map.get(key));
218            }
219
220            urlGen.addURLs(newMap);
221        }
222
223        return urlGen;
224    }
225
226}