Cytoscape 2.8.0 API

cytoscape.data
Class ImportHandler

java.lang.Object
  extended by cytoscape.data.ImportHandler

public class ImportHandler
extends Object

Central registry for all Cytoscape import classes.

Author:
Cytoscape Development Team.

Field Summary
protected static Set<CyFileFilter> cyFileFilters
          Set of all registered CyFileFilter Objects.
static String EDGE_NATURE
          Filter Type: EDGE.
static String GRAPH_NATURE
          Filter Type: NETWORK.
static String NODE_NATURE
          Filter Type: NODE.
static String PROPERTIES_NATURE
          Filer Type: PROPERTIES.
 
Constructor Summary
ImportHandler()
          Constructor.
 
Method Summary
 boolean addFilter(CyFileFilter cff)
          Registers a new CyFileFilter.
 boolean addFilter(CyFileFilter[] cff)
          Registers an Array of CyFileFilter Objects.
 File downloadFromURL(URL url, TaskMonitor taskMonitor)
          Download a temporary file from the given URL.
 Collection getAllDescriptions()
          Gets a collection of all registered filter descriptions.
 Collection getAllExtensions()
          Gets a collection of all registered file extensions.
 List getAllFilters()
          Gets a list of all registered filters plus a catch-all super set filter.
 List getAllFilters(String fileNature)
          Gets a list of all registered filters, which are of type: fileNature, plus a catch-all super set filter.
 Collection getAllTypes(String fileNature)
          Gets descriptions for all registered filters, which are of the type: fileNature.
 String getFileType(String fileName)
          Gets the name of the filter which is capable of reading the specified file.
 GraphReader getReader(String fileName)
          Gets the GraphReader that is capable of reading the specified file.
 GraphReader getReader(URL url)
          Gets the GraphReader that is capable of reading URL.
 void resetImportHandler()
          Unregisters all registered File Filters (except default file filters.) Resets everything with a clean slate.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

GRAPH_NATURE

public static String GRAPH_NATURE
Filter Type: NETWORK.


NODE_NATURE

public static String NODE_NATURE
Filter Type: NODE.


EDGE_NATURE

public static String EDGE_NATURE
Filter Type: EDGE.


PROPERTIES_NATURE

public static String PROPERTIES_NATURE
Filer Type: PROPERTIES.


cyFileFilters

protected static Set<CyFileFilter> cyFileFilters
Set of all registered CyFileFilter Objects.

Constructor Detail

ImportHandler

public ImportHandler()
Constructor.

Method Detail

addFilter

public boolean addFilter(CyFileFilter cff)
Registers a new CyFileFilter.

Parameters:
cff - CyFileFilter.
Returns:
true indicates filter was added successfully.

addFilter

public boolean addFilter(CyFileFilter[] cff)
Registers an Array of CyFileFilter Objects.

Parameters:
cff - Array of CyFileFilter Objects.
Returns:
true indicates all filters were added successfully.

getReader

public GraphReader getReader(String fileName)
Gets the GraphReader that is capable of reading the specified file.

Parameters:
fileName - File name or null if no reader is capable of reading the file.
Returns:
GraphReader capable of reading the specified file.

getReader

public GraphReader getReader(URL url)
Gets the GraphReader that is capable of reading URL.

Parameters:
url - -- the URL string
Returns:
GraphReader capable of reading the specified URL.

getAllTypes

public Collection getAllTypes(String fileNature)
Gets descriptions for all registered filters, which are of the type: fileNature.

Parameters:
fileNature - type: GRAPH_NATURE, NODE_NATURE, EDGE_NATURE, etc.
Returns:
Collection of String descriptions, e.g. "XGMML files"

getAllExtensions

public Collection getAllExtensions()
Gets a collection of all registered file extensions.

Returns:
Collection of Strings, e.g. "xgmml", "sif", etc.

getAllDescriptions

public Collection getAllDescriptions()
Gets a collection of all registered filter descriptions. Descriptions are of the form: "{File Description} ({file extensions})". For example: "GML files (*.gml)"

Returns:
Collection of Strings, e.g. "GML files (*.gml)", etc.

getFileType

public String getFileType(String fileName)
Gets the name of the filter which is capable of reading the specified file.

Parameters:
fileName - File Name.
Returns:
name of filter capable of reading the specified file.

getAllFilters

public List getAllFilters()
Gets a list of all registered filters plus a catch-all super set filter.

Returns:
List of CyFileFilter Objects.

getAllFilters

public List getAllFilters(String fileNature)
Gets a list of all registered filters, which are of type: fileNature, plus a catch-all super set filter.

Parameters:
fileNature - type: GRAPH_NATURE, NODE_NATURE, EDGE_NATURE, etc.
Returns:
List of CyFileFilter Objects.

resetImportHandler

public void resetImportHandler()
Unregisters all registered File Filters (except default file filters.) Resets everything with a clean slate.


downloadFromURL

public File downloadFromURL(URL url,
                            TaskMonitor taskMonitor)
                     throws IOException,
                            FileNotFoundException
Download a temporary file from the given URL. The file will be saved in the temporary directory and will be deleted after Cytoscape exits.

Parameters:
u - -- the URL string, TaskMonitor if any
Returns:
-- a temporary file downloaded from the given URL.
Throws:
IOException
FileNotFoundException

Cytoscape 2.8.0 API

Copyright 2010 Cytoscape Consortium. All rights reserved.