org.gephi.datalab.api.DataLaboratoryHelper Maven / Gradle / Ivy
/*
Copyright 2008-2010 Gephi
Authors : Eduardo Ramos
Website : http://www.gephi.org
This file is part of Gephi.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
Copyright 2011 Gephi Consortium. All rights reserved.
The contents of this file are subject to the terms of either the GNU
General Public License Version 3 only ("GPL") or the Common
Development and Distribution License("CDDL") (collectively, the
"License"). You may not use this file except in compliance with the
License. You can obtain a copy of the License at
http://gephi.org/about/legal/license-notice/
or /cddl-1.0.txt and /gpl-3.0.txt. See the License for the
specific language governing permissions and limitations under the
License. When distributing the software, include this License Header
Notice in each file and include the License files at
/cddl-1.0.txt and /gpl-3.0.txt. If applicable, add the following below the
License Header, with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"
If you wish your version of this file to be governed by only the CDDL
or only the GPL Version 3, indicate your decision by adding
"[Contributor] elects to include this software in this distribution
under the [CDDL or GPL Version 3] license." If you do not indicate a
single choice of license, a recipient has the option to distribute
your version of this file under either the CDDL, the GPL Version 3 or
to extend the choice of license to its licensees as provided above.
However, if you add GPL Version 3 code and therefore, elected the GPL
Version 3 license, then the option applies only if the new code is
made subject to such option by the copyright holder.
Contributor(s):
Portions Copyrighted 2011 Gephi Consortium.
*/
package org.gephi.datalab.api;
import java.awt.Dialog;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.swing.JButton;
import javax.swing.JComponent;
import javax.swing.JPanel;
import javax.swing.SwingUtilities;
import org.gephi.datalab.spi.DialogControls;
import org.gephi.datalab.spi.Manipulator;
import org.gephi.datalab.spi.ManipulatorUI;
import org.gephi.datalab.spi.columns.AttributeColumnsManipulator;
import org.gephi.datalab.spi.columns.AttributeColumnsManipulatorUI;
import org.gephi.datalab.spi.columns.merge.AttributeColumnsMergeStrategy;
import org.gephi.datalab.spi.columns.merge.AttributeColumnsMergeStrategyBuilder;
import org.gephi.datalab.spi.edges.EdgesManipulator;
import org.gephi.datalab.spi.edges.EdgesManipulatorBuilder;
import org.gephi.datalab.spi.general.GeneralActionsManipulator;
import org.gephi.datalab.spi.general.PluginGeneralActionsManipulator;
import org.gephi.datalab.spi.nodes.NodesManipulator;
import org.gephi.datalab.spi.nodes.NodesManipulatorBuilder;
import org.gephi.datalab.spi.rows.merge.AttributeRowsMergeStrategy;
import org.gephi.datalab.spi.rows.merge.AttributeRowsMergeStrategyBuilder;
import org.gephi.datalab.spi.values.AttributeValueManipulator;
import org.gephi.datalab.spi.values.AttributeValueManipulatorBuilder;
import org.gephi.graph.api.Column;
import org.gephi.graph.api.GraphModel;
import org.gephi.graph.api.Table;
import org.openide.DialogDescriptor;
import org.openide.DialogDisplayer;
import org.openide.util.Lookup;
import org.openide.util.NbBundle;
import org.openide.util.lookup.ServiceProvider;
/**
* Helper class for simplifying the use of Data Laboratory API and SPI.
*/
@ServiceProvider(service = DataLaboratoryHelper.class)
public class DataLaboratoryHelper {
/**
* Prepares an array with one new instance of every NodesManipulator
* that has a builder registered and returns it.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all NodesManipulator implementations
*/
public NodesManipulator[] getNodesManipulators() {
ArrayList nodesManipulators = new ArrayList<>();
for (NodesManipulatorBuilder nm : Lookup.getDefault().lookupAll(NodesManipulatorBuilder.class)) {
nodesManipulators.add(nm.getNodesManipulator());
}
sortManipulators(nodesManipulators);
return nodesManipulators.toArray(new NodesManipulator[0]);
}
/**
* Prepares an array with one new instance of every EdgesManipulator
* that has a builder registered and returns it.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all EdgesManipulator implementations
*/
public EdgesManipulator[] getEdgesManipulators() {
ArrayList edgesManipulators = new ArrayList<>();
for (EdgesManipulatorBuilder em : Lookup.getDefault().lookupAll(EdgesManipulatorBuilder.class)) {
edgesManipulators.add(em.getEdgesManipulator());
}
sortManipulators(edgesManipulators);
return edgesManipulators.toArray(new EdgesManipulator[0]);
}
/**
* Prepares an array with one instance of every GeneralActionsManipulator that is registered.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all GeneralActionsManipulator implementations
*/
public GeneralActionsManipulator[] getGeneralActionsManipulators() {
ArrayList generalActionsManipulators = new ArrayList<>();
generalActionsManipulators.addAll(Lookup.getDefault().lookupAll(GeneralActionsManipulator.class));
sortManipulators(generalActionsManipulators);
return generalActionsManipulators.toArray(new GeneralActionsManipulator[0]);
}
/**
* Prepares an array with one instance of every PluginGeneralActionsManipulator that is registered.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all PluginGeneralActionsManipulator implementations
*/
public PluginGeneralActionsManipulator[] getPluginGeneralActionsManipulators() {
ArrayList pluginGeneralActionsManipulators = new ArrayList<>();
pluginGeneralActionsManipulators.addAll(Lookup.getDefault().lookupAll(PluginGeneralActionsManipulator.class));
sortManipulators(pluginGeneralActionsManipulators);
return pluginGeneralActionsManipulators.toArray(new PluginGeneralActionsManipulator[0]);
}
/**
* Prepares an array that has one instance of every AttributeColumnsManipulator implementation
* that has a builder registered and returns it.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all AttributeColumnsManipulator implementations
*/
public AttributeColumnsManipulator[] getAttributeColumnsManipulators() {
ArrayList attributeColumnsManipulators = new ArrayList<>();
attributeColumnsManipulators.addAll(Lookup.getDefault().lookupAll(AttributeColumnsManipulator.class));
sortAttributeColumnsManipulators(attributeColumnsManipulators);
return attributeColumnsManipulators.toArray(new AttributeColumnsManipulator[0]);
}
/**
* Prepares an array with one new instance of every AttributeValueManipulator
* that has a builder registered and returns it.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all AttributeValueManipulator implementations
*/
public AttributeValueManipulator[] getAttributeValueManipulators() {
ArrayList attributeValueManipulators = new ArrayList<>();
for (AttributeValueManipulatorBuilder am : Lookup.getDefault().lookupAll(AttributeValueManipulatorBuilder.class)) {
attributeValueManipulators.add(am.getAttributeValueManipulator());
}
sortManipulators(attributeValueManipulators);
return attributeValueManipulators.toArray(new AttributeValueManipulator[0]);
}
/**
* Prepares an array that has one new instance of every AttributeColumnsMergeStrategy implementation that is registered.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all AttributeColumnsMergeStrategy implementations
*/
public AttributeColumnsMergeStrategy[] getAttributeColumnsMergeStrategies() {
ArrayList strategies = new ArrayList<>();
for (AttributeColumnsMergeStrategyBuilder cs : Lookup.getDefault().lookupAll(AttributeColumnsMergeStrategyBuilder.class)) {
strategies.add(cs.getAttributeColumnsMergeStrategy());
}
sortManipulators(strategies);
return strategies.toArray(new AttributeColumnsMergeStrategy[0]);
}
/**
* Prepares an array that has one new instance of every AttributeRowsMergeStrategy implementation that is registered.
* It also returns the manipulators ordered first by type and then by position.
* @return Array of all AttributeRowsMergeStrategy implementations
*/
public AttributeRowsMergeStrategy[] getAttributeRowsMergeStrategies() {
ArrayList strategies = new ArrayList<>();
for (AttributeRowsMergeStrategyBuilder cs : Lookup.getDefault().lookupAll(AttributeRowsMergeStrategyBuilder.class)) {
strategies.add(cs.getAttributeRowsMergeStrategy());
}
sortManipulators(strategies);
return strategies.toArray(new AttributeRowsMergeStrategy[0]);
}
private void sortManipulators(ArrayList m) {
Collections.sort(m, new Comparator() {
@Override
public int compare(Manipulator o1, Manipulator o2) {
//Order by type, position.
if (o1.getType() == o2.getType()) {
return o1.getPosition() - o2.getPosition();
} else {
return o1.getType() - o2.getType();
}
}
});
}
private void sortAttributeColumnsManipulators(ArrayList m) {
Collections.sort(m, new Comparator() {
@Override
public int compare(AttributeColumnsManipulator o1, AttributeColumnsManipulator o2) {
//Order by type, position.
if (o1.getType() == o2.getType()) {
return o1.getPosition() - o2.getPosition();
} else {
return o1.getType() - o2.getType();
}
}
});
}
/**
* Prepares the dialog UI of a manipulator if it has one and executes the manipulator in a separate
* Thread when the dialog is accepted or directly if there is no UI.
* @param m Manipulator to execute
*/
public void executeManipulator(final Manipulator m) {
if (m.canExecute()) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
final ManipulatorUI ui = m.getUI();
//Show a dialog for the manipulator UI if it provides one. If not, execute the manipulator directly:
if (ui != null) {
final JButton okButton = new JButton(NbBundle.getMessage(DataLaboratoryHelper.class, "DataLaboratoryHelper.ui.okButton.text"));
DialogControls dialogControls = new DialogControlsImpl(okButton);
ui.setup(m, dialogControls);
JPanel settingsPanel = ui.getSettingsPanel();
DialogDescriptor dd = new DialogDescriptor(settingsPanel, NbBundle.getMessage(DataLaboratoryHelper.class, "SettingsPanel.title", ui.getDisplayName()), ui.isModal(), new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
if (e.getSource().equals(okButton)) {
ui.unSetup();
executeManipulatorInOtherThread(m);
} else {
ui.unSetup();
}
}
});
dd.setOptions(new Object[]{okButton, DialogDescriptor.CANCEL_OPTION});
dd.setClosingOptions(null);//All options close
Dialog dialog = DialogDisplayer.getDefault().createDialog(dd);
dialog.addWindowListener(new WindowAdapter() {
@Override
public void windowClosing(WindowEvent e) {
ui.unSetup();
}
});
dialog.setVisible(true);
} else {
executeManipulatorInOtherThread(m);
}
}
});
}
}
/**
* This method shows the UI of an AttributeRowsMergeStrategy if it is provided and the AttributeRowsMergeStrategy can be executed.
* These UI only configures (calls unSetup) the AttributeRowsMergeStrategy if the dialog is accepted,
* and it does not execute the AttributeRowsMergeStrategy.
* @param m AttributeRowsMergeStrategy
* @return True if the AttributeRowsMergeStrategy UI is provided
*/
public boolean showAttributeRowsMergeStrategyUIDialog(final AttributeRowsMergeStrategy m) {
final ManipulatorUI ui = m.getUI();
//Show a dialog for the manipulator UI if it provides one. If not, execute the manipulator directly:
if (ui != null && m.canExecute()) {
final JButton okButton = new JButton(NbBundle.getMessage(DataLaboratoryHelper.class, "DataLaboratoryHelper.ui.okButton.text"));
DialogControls dialogControls = new DialogControlsImpl(okButton);
ui.setup(m, dialogControls);
JPanel settingsPanel = ui.getSettingsPanel();
DialogDescriptor dd = new DialogDescriptor(settingsPanel, NbBundle.getMessage(DataLaboratoryHelper.class, "SettingsPanel.title", ui.getDisplayName()), ui.isModal(), new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
if (e.getSource().equals(okButton)) {
ui.unSetup();
}
}
});
dd.setOptions(new Object[]{okButton, DialogDescriptor.CANCEL_OPTION});
dd.setClosingOptions(null);//All options close
Dialog dialog = DialogDisplayer.getDefault().createDialog(dd);
dialog.setVisible(true);
return true;
}
return false;
}
private void executeManipulatorInOtherThread(final Manipulator m) {
new Thread() {
@Override
public void run() {
this.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
@Override
public void uncaughtException(Thread t, Throwable e) {
Logger.getLogger("").log(Level.SEVERE, null, e);
}
});
m.execute();
}
}.start();
}
/**
* Prepares the dialog UI of a AttributeColumnsManipulator if it has one and executes the manipulator in a separate
* Thread when the dialog is accepted or directly if there is no UI.
* @param m AttributeColumnsManipulator
* @param graphModel Graph model of the table
* @param table Table of the column
* @param column Column to manipulate
*/
public void executeAttributeColumnsManipulator(final AttributeColumnsManipulator m, final GraphModel graphModel, final Table table, final Column column) {
if (m.canManipulateColumn(table, column)) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
final AttributeColumnsManipulatorUI ui = m.getUI(table, column);
//Show a dialog for the manipulator UI if it provides one. If not, execute the manipulator directly:
if (ui != null) {
final JButton okButton = new JButton(NbBundle.getMessage(DataLaboratoryHelper.class, "DataLaboratoryHelper.ui.okButton.text"));
DialogControls dialogControls = new DialogControlsImpl(okButton);
ui.setup(m, graphModel, table, column, dialogControls);
JPanel settingsPanel = ui.getSettingsPanel();
DialogDescriptor dd = new DialogDescriptor(settingsPanel, NbBundle.getMessage(DataLaboratoryHelper.class, "SettingsPanel.title", ui.getDisplayName()), ui.isModal(), new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
if (e.getSource().equals(okButton)) {
ui.unSetup();
executeAttributeColumnsManipulatorInOtherThread(m, table, column);
} else {
ui.unSetup();
}
}
});
dd.setOptions(new Object[]{okButton, DialogDescriptor.CANCEL_OPTION});
dd.setClosingOptions(null);//All options close
Dialog dialog = DialogDisplayer.getDefault().createDialog(dd);
dialog.addWindowListener(new WindowAdapter() {
@Override
public void windowClosing(WindowEvent e) {
ui.unSetup();
}
});
dialog.setVisible(true);
} else {
executeAttributeColumnsManipulatorInOtherThread(m, table, column);
}
}
});
}
}
private void executeAttributeColumnsManipulatorInOtherThread(final AttributeColumnsManipulator m, final Table table, final Column column) {
new Thread() {
@Override
public void run() {
m.execute(table, column);
}
}.start();
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public NodesManipulator getNodesManipulatorByName(String name) {
for (NodesManipulatorBuilder nm : Lookup.getDefault().lookupAll(NodesManipulatorBuilder.class)) {
if (nm.getNodesManipulator().getClass().getSimpleName().equals(name)) {
return nm.getNodesManipulator();
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public EdgesManipulator getEdgesManipulatorByName(String name) {
for (EdgesManipulatorBuilder nm : Lookup.getDefault().lookupAll(EdgesManipulatorBuilder.class)) {
if (nm.getEdgesManipulator().getClass().getSimpleName().equals(name)) {
return nm.getEdgesManipulator();
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public GeneralActionsManipulator getGeneralActionsManipulatorByName(String name) {
for (GeneralActionsManipulator m : Lookup.getDefault().lookupAll(GeneralActionsManipulator.class)) {
if (m.getClass().getSimpleName().equals(name)) {
return m;
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public PluginGeneralActionsManipulator getPluginGeneralActionsManipulatorByName(String name) {
for (PluginGeneralActionsManipulator m : Lookup.getDefault().lookupAll(PluginGeneralActionsManipulator.class)) {
if (m.getClass().getSimpleName().equals(name)) {
return m;
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public AttributeColumnsManipulator getAttributeColumnsManipulatorByName(String name) {
for (AttributeColumnsManipulator m : Lookup.getDefault().lookupAll(AttributeColumnsManipulator.class)) {
if (m.getClass().getSimpleName().equals(name)) {
return m;
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public AttributeValueManipulator getAttributeValueManipulatorByName(String name) {
for (AttributeValueManipulatorBuilder am : Lookup.getDefault().lookupAll(AttributeValueManipulatorBuilder.class)) {
if (am.getAttributeValueManipulator().getClass().getSimpleName().equals(name)) {
return am.getAttributeValueManipulator();
}
}
return null;
}
/**
* Returns the AttributeColumnsMergeStrategy with that class name or null if it does not exist
*/
public AttributeColumnsMergeStrategy getAttributeColumnsMergeStrategyByName(String name) {
for (AttributeColumnsMergeStrategyBuilder cs : Lookup.getDefault().lookupAll(AttributeColumnsMergeStrategyBuilder.class)) {
if (cs.getAttributeColumnsMergeStrategy().getClass().getSimpleName().equals(name)) {
return cs.getAttributeColumnsMergeStrategy();
}
}
return null;
}
/**
* Returns the AttributeRowsMergeStrategy with that class name or null if it does not exist
*/
public AttributeRowsMergeStrategy getAttributeRowsMergeStrategyByName(String name) {
for (AttributeRowsMergeStrategyBuilder cs : Lookup.getDefault().lookupAll(AttributeRowsMergeStrategyBuilder.class)) {
if (cs.getAttributeRowsMergeStrategy().getClass().getSimpleName().equals(name)) {
return cs.getAttributeRowsMergeStrategy();
}
}
return null;
}
class DialogControlsImpl implements DialogControls {
JComponent okButton;
public DialogControlsImpl(JComponent okButton) {
this.okButton = okButton;
}
@Override
public void setOkButtonEnabled(boolean enabled) {
okButton.setEnabled(enabled);
}
@Override
public boolean isOkButtonEnabled() {
return okButton.isEnabled();
}
}
public static DataLaboratoryHelper getDefault() {
return Lookup.getDefault().lookup(DataLaboratoryHelper.class);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy