001: /*
002: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
003: *
004: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * The contents of this file are subject to the terms of either the GNU
007: * General Public License Version 2 only ("GPL") or the Common
008: * Development and Distribution License("CDDL") (collectively, the
009: * "License"). You may not use this file except in compliance with the
010: * License. You can obtain a copy of the License at
011: * http://www.netbeans.org/cddl-gplv2.html
012: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
013: * specific language governing permissions and limitations under the
014: * License. When distributing the software, include this License Header
015: * Notice in each file and include the License file at
016: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
017: * particular file as subject to the "Classpath" exception as provided
018: * by Sun in the GPL Version 2 section of the License file that
019: * accompanied this code. If applicable, add the following below the
020: * License Header, with the fields enclosed by brackets [] replaced by
021: * your own identifying information:
022: * "Portions Copyrighted [year] [name of copyright owner]"
023: *
024: * Contributor(s):
025: * The Original Software is NetBeans. The Initial Developer of the Original
026: * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
027: * Microsystems, Inc. All Rights Reserved.
028: *
029: * If you wish your version of this file to be governed by only the CDDL
030: * or only the GPL Version 2, indicate your decision by adding
031: * "[Contributor] elects to include this software in this distribution
032: * under the [CDDL or GPL Version 2] license." If you do not indicate a
033: * single choice of license, a recipient has the option to distribute
034: * your version of this file under either the CDDL, the GPL Version 2 or
035: * to extend the choice of license to its licensees as provided above.
036: * However, if you add GPL Version 2 code and therefore, elected the GPL
037: * Version 2 license, then the option applies only if the new code is
038: * made subject to such option by the copyright holder.
039: */
040:
041: package org.netbeans.lib.profiler.ui.charts;
042:
043: import java.awt.Color;
044: import java.util.Iterator;
045: import java.util.Vector;
046:
047: /**
048: *
049: * @author Jiri Sedlacek
050: */
051: public abstract class AbstractSynchronousXYChartModel implements
052: SynchronousXYChartModel {
053: //~ Instance fields ----------------------------------------------------------------------------------------------------------
054:
055: private Vector listeners; // Data change listeners
056:
057: //~ Methods ------------------------------------------------------------------------------------------------------------------
058:
059: public abstract int getItemCount(); // number of collected items
060:
061: public abstract long getMaxXValue(); // maximum (last) value on the horizontal axis (valid for all series)
062:
063: public abstract long getMaxYValue(int seriesIndex); // maximum values on the vertical axis for one series
064:
065: public abstract long getMinXValue(); // minimum (first) value on the horizontal axis (valid for all series)
066:
067: public abstract long getMinYValue(int seriesIndex); // minimum values on the vertical axis for one series
068:
069: public abstract Color getSeriesColor(int seriesIndex); // color of data series
070:
071: // --- Abstract XYChartModel -------------------------------------------------
072: public abstract int getSeriesCount(); // number of tracked data series
073:
074: public abstract String getSeriesName(int seriesIndex); // name of data series
075:
076: public abstract long getXValue(int itemIndex); // x value of the item (valid for all series)
077:
078: public abstract long getYValue(int itemIndex, int seriesIndex); // y values of the item for one series
079:
080: public Color getLimitYColor() {
081: return Color.WHITE;
082: }
083:
084: public long getLimitYValue() {
085: return Long.MAX_VALUE;
086: }
087:
088: // TODO: will be moved to chart axis definition
089: public long getMaxDisplayYValue(int seriesIndex) {
090: return getMaxYValue(seriesIndex);
091: } // value to be displayed at the top of the chart
092:
093: // TODO: will be moved to chart axis definition
094: public long getMinDisplayYValue(int seriesIndex) {
095: return getMinYValue(seriesIndex);
096: } // value to be displayed at the bottom of the chart
097:
098: // --- Listeners -------------------------------------------------------------
099:
100: /**
101: * Adds new ChartModel listener.
102: * @param listener ChartModel listener to add
103: */
104: public synchronized void addChartModelListener(
105: ChartModelListener listener) {
106: if (listeners == null) {
107: listeners = new Vector();
108: }
109:
110: if (!listeners.contains(listener)) {
111: listeners.add(listener);
112: }
113: }
114:
115: /**
116: * Removes ChartModel listener.
117: * @param listener ChartModel listener to remove
118: */
119: public synchronized void removeChartModelListener(
120: ChartModelListener listener) {
121: if (listeners != null) {
122: listeners.remove(listener);
123: }
124: }
125:
126: /**
127: * Notifies all listeners about the data change.
128: */
129: protected void fireChartDataChanged() {
130: if (listeners == null) {
131: return;
132: }
133:
134: Vector toNotify;
135:
136: synchronized (this ) {
137: toNotify = ((Vector) listeners.clone());
138: }
139:
140: Iterator iterator = toNotify.iterator();
141:
142: while (iterator.hasNext()) {
143: ((ChartModelListener) iterator.next()).chartDataChanged();
144: }
145: }
146: }
|