org.cytoscape.model

Interface CyNetworkTableManager

public interface CyNetworkTableManager

Provides access to all network-table relationships. CyTables can be associated with a CyNetwork by being assigned a type and namespace within that CyNetwork. For example, a CyTable that stores CyNode attributes would be of type CyNode.class. You can associate multiple CyTables of a particular type to a CyNetwork as long as each of those CyTables has a different namespace. For instance, to add multiple node tables to a CyNetwork, you would call:

 setTable(network, CyNode.class, "my namespace", nodeTable1);
 setTable(network, CyNode.class, "my other namespace", nodeTable2);
 

So the triple (CyNetwork, type, namespace) refers to exactly one table at any given time. It's also possible to associate the same CyTable with multiple (CyNetwork, type, namespace) combinations.

By default, CyNetworks are associated with network, node, and edge tables for each of the following namespaces:

• CyNetwork.DEFAULT_ATTRS
• CyNetwork.LOCAL_ATTRS
• CyNetwork.HIDDEN_ATTRS

Cytoscape Backwards Compatibility (API Interface): We expect that this interface will be used but not implemented by developers using this interface. As such, we reserve the right to add methods to the interface as part of minor version upgrades. We will not remove methods for any changes other than major version upgrades.

Method Summary

Methods

Modifier and Type	Method and Description
Set<CyNetwork>	getNetworkSet() Returns a read-only set of all networks managed by this instance.
CyTable	getTable(CyNetwork network, Class<? extends CyIdentifiable> type, String namespace) Returns the table with the specified namespace and type from the network.
Map<String,CyTable>	getTables(CyNetwork network, Class<? extends CyIdentifiable> type) Returns a read-only map of all of the tables for the specified type from the network.
void	removeAllTables(CyNetwork network) Removes all tables associated with the given network.
void	removeTable(CyNetwork network, Class<? extends CyIdentifiable> type, String namespace) Removes the table with the specified namespace and type from the network.
void	reset() Clears all the network-table relationships.
void	setTable(CyNetwork network, Class<? extends CyIdentifiable> type, String namespace, CyTable table) Associates the given table to the network using the specified namespace and type.

Method Detail

setTable

void setTable(CyNetwork network,
            Class<? extends CyIdentifiable> type,
            String namespace,
            CyTable table)

Associates the given table to the network using the specified namespace and type.

Parameters:

network - the CyNetwork to associate the given table to.

type - Type of CyIdentifiable associated with the table.

namespace - the namespace the table should belong to.

table - the table to associate to the network with the specified namespace and type.

getTable

CyTable getTable(CyNetwork network,
               Class<? extends CyIdentifiable> type,
               String namespace)

Returns the table with the specified namespace and type from the network.

Parameters:

network - the network to check for the table.

type - Type of CyIdentifiable associated with the table.

namespace - the namespace the table should belong to.

Returns:

the table with the specified namespace and type from the network.

removeTable

void removeTable(CyNetwork network,
               Class<? extends CyIdentifiable> type,
               String namespace)

Removes the table with the specified namespace and type from the network.

Parameters:

network - the network to remove the table from.

type - Type of CyIdentifiable associated with the table.

namespace - the namespace the table should belong to.

getTables

Map<String,CyTable> getTables(CyNetwork network,
                            Class<? extends CyIdentifiable> type)

Returns a read-only map of all of the tables for the specified type from the network. Each table is keyed by its namespace.

Parameters:

network - The network to return the tables of.

type - The type of the tables to return.

Returns:

a read-only map of all the tables for the specified type from the network.

reset

void reset()

Clears all the network-table relationships.

getNetworkSet

Set<CyNetwork> getNetworkSet()

Returns a read-only set of all networks managed by this instance.

Returns:

a read-only set of all networks managed by this instance.

removeAllTables

void removeAllTables(CyNetwork network)

Removes all tables associated with the given network.

Parameters:

network - the network whose tables should be removed.