com.orsoncharts.data.KeyedValues3DItemKeys Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of orsoncharts Show documentation
Show all versions of orsoncharts Show documentation
Orson Charts is a 3D chart library for the Java platform.
The newest version!
/* ===========================================================
* Orson Charts : a 3D chart library for the Java(tm) platform
* ===========================================================
*
* (C)opyright 2013-2016, by Object Refinery Limited. All rights reserved.
*
* http://www.object-refinery.com/orsoncharts/index.html
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*
* [Oracle and Java are registered trademarks of Oracle and/or its affiliates.
* Other names may be trademarks of their respective owners.]
*
* If you do not wish to be bound by the terms of the GPL, an alternative
* commercial license can be purchased. For details, please see visit the
* Orson Charts home page:
*
* http://www.object-refinery.com/orsoncharts/index.html
*
*/
package com.orsoncharts.data;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import com.orsoncharts.util.ArgChecks;
/**
* Utility methods related to the {@link KeyedValues3DItemKey} class.
*
* @since 1.3
*/
public class KeyedValues3DItemKeys {
private KeyedValues3DItemKeys() {
// no need to instantiate this
}
/**
* Returns a collection containing all the item keys for the specified
* series.
*
* @param data the data ({@code null} not permitted).
* @param seriesKey the series key ({@code null} not permitted).
*
* @param the series key type
* @param the row key type
* @param the column key type
* @param the value type
*
* @return A collection of item keys (never {@code null}).
*/
public static , R extends Comparable,
C extends Comparable, T>
Collection itemKeysForSeries(
KeyedValues3D data, S seriesKey) {
ArgChecks.nullNotPermitted(data, "data");
ArgChecks.nullNotPermitted(seriesKey, "seriesKey");
Collection result
= new ArrayList();
if (!data.getSeriesKeys().contains(seriesKey)) {
return result;
}
for (R rowKey: data.getRowKeys()) {
for (C columnKey: data.getColumnKeys()) {
KeyedValues3DItemKey key
= new KeyedValues3DItemKey(seriesKey, rowKey,
columnKey);
result.add(key);
}
}
return result;
}
/**
* Returns a collection containing all the item keys for the specified
* row.
*
* @param the series key type
* @param the row key type
* @param the column key type
* @param the value type
*
* @param data the data ({@code null} not permitted).
* @param rowKey the row key ({@code null} not permitted).
*
* @return A collection of item keys (never {@code null}).
*/
public static , R extends Comparable,
C extends Comparable, T> Collection
itemKeysForRow(KeyedValues3D data, R rowKey) {
ArgChecks.nullNotPermitted(data, "data");
ArgChecks.nullNotPermitted(rowKey, "rowKey");
Collection result
= new ArrayList();
if (!data.getRowKeys().contains(rowKey)) {
return result;
}
for (S seriesKey: data.getSeriesKeys()) {
for (C columnKey: data.getColumnKeys()) {
KeyedValues3DItemKey key
= new KeyedValues3DItemKey(seriesKey,
rowKey, columnKey);
result.add(key);
}
}
return result;
}
/**
* Returns a collection containing all the item keys for the specified
* column.
*
* @param the series key type
* @param the row key type
* @param the column key type.
* @param the value type.
*
* @param data the data ({@code null} not permitted).
* @param columnKey the column key ({@code null} not permitted).
*
* @return A collection of item keys (never {@code null}).
*/
public static , R extends Comparable,
C extends Comparable, T>
Collection itemKeysForColumn(
KeyedValues3D data, C columnKey) {
ArgChecks.nullNotPermitted(data, "data");
ArgChecks.nullNotPermitted(columnKey, "columnKey");
Collection result
= new ArrayList();
if (!data.getColumnKeys().contains(columnKey)) {
return result;
}
for (S seriesKey: data.getSeriesKeys()) {
for (R rowKey: data.getRowKeys()) {
KeyedValues3DItemKey key
= new KeyedValues3DItemKey(seriesKey,
rowKey, columnKey);
result.add(key);
}
}
return result;
}
}