Chemical Data Processing Library Python API - Version 1.1.1
Classes | Static Public Member Functions | Static Public Attributes | List of all members
CDPL.Pharm.FeatureContainerIOManager Class Reference

A singleton class that serves as a global registry for Pharm.FeatureContainerInputHandler and Pharm.FeatureContainerOutputHandler implementation instances. More...

+ Inheritance diagram for CDPL.Pharm.FeatureContainerIOManager:

Classes

class  InputHandlerSequence
 
class  OutputHandlerSequence
 

Static Public Member Functions

None registerInputHandler (object handler)
 Registers the specified Pharm.FeatureContainerInputHandler implementation instance. More...
 
object getInputHandler (int idx)
 Returns a reference to the registered Pharm.FeatureContainerInputHandler implementation instance with the specified index. More...
 
object getInputHandlerByFormat (Base.DataFormat fmt)
 Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the specified data format. More...
 
object getInputHandlerByName (str name)
 Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified name. More...
 
object getInputHandlerByFileExtension (str file_ext)
 Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified file extension. More...
 
object getInputHandlerByMimeType (str mime_type)
 Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified mime-type. More...
 
bool unregisterInputHandler (Base.DataFormat fmt)
 Unregisters the Pharm.FeatureContainerInputHandler implementation instance for the specified data format. More...
 
None unregisterInputHandler (int idx)
 Unregisters the Pharm.FeatureContainerInputHandler implementation instance with the specified index. More...
 
bool unregisterInputHandler (object handler)
 Unregisters the specified Pharm.FeatureContainerInputHandler implementation instance. More...
 
int getNumInputHandlers ()
 Returns the number of registered Pharm.FeatureContainerInputHandler implementation instances. More...
 
InputHandlerSequence getInputHandlers ()
 
None registerOutputHandler (FeatureContainerOutputHandler handler)
 Registers the specified Pharm.FeatureContainerOutputHandler implementation instance. More...
 
FeatureContainerOutputHandler getOutputHandler (int idx)
 Returns a reference to the registered Pharm.FeatureContainerOutputHandler implementation instance with the specified index. More...
 
FeatureContainerOutputHandler getOutputHandlerByFormat (Base.DataFormat fmt)
 Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the specified data format. More...
 
FeatureContainerOutputHandler getOutputHandlerByName (str name)
 Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified name. More...
 
FeatureContainerOutputHandler getOutputHandlerByFileExtension (str file_ext)
 Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified file extension. More...
 
FeatureContainerOutputHandler getOutputHandlerByMimeType (str mime_type)
 Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified mime-type. More...
 
bool unregisterOutputHandler (Base.DataFormat fmt)
 Unregisters the Pharm.FeatureContainerOutputHandler implementation instance for the specified data format. More...
 
None unregisterOutputHandler (int idx)
 Unregisters the Pharm.FeatureContainerOutputHandler implementation instance with the specified index. More...
 
bool unregisterOutputHandler (FeatureContainerOutputHandler handler)
 Unregisters the specified Pharm.FeatureContainerOutputHandler implementation instance. More...
 
int getNumOutputHandlers ()
 Returns the number of registered Pharm.FeatureContainerOutputHandler implementation instances. More...
 
OutputHandlerSequence getOutputHandlers ()
 

Static Public Attributes

 inputHandlers = _HIDDEN_VALUE_
 
int numInputHandlers = 0
 
 outputHandlers = _HIDDEN_VALUE_
 
int numOutputHandlers = 4
 

Detailed Description

A singleton class that serves as a global registry for Pharm.FeatureContainerInputHandler and Pharm.FeatureContainerOutputHandler implementation instances.

DataIOManager provides static methods for the registration and lookup of Pharm.FeatureContainerInputHandler and Pharm.FeatureContainerOutputHandler implementation instances that handle different input and output storage formats.

Input and output handlers are registered by the methods registerInputHandler() and registerOutputHandler(). These methods expect a reference to an instance of the respective handler implementation as an argument (please note that the registered instance must not be destroyed as long as it is accessible via the DataIOManager interface!).

For the removal of registered handlers the unregisterInputHandler() and unregisterOutputHandler() family of overloaded methods is provided. These methods accept a reference to the registered handler instance, the handler index, the handled data format or an iterator pointing to the handler as an argument.

Registered input handlers can be queried by the methods getInputHandlerByFormat(), getInputHandlerByName(), getInputHandlerByFileExtension() and getInputHandlerByMimeType(), which allow to find a suitable handler for a given data format, data format name, file extension or mime-type. For the registered output handlers similar methods are provided.

I/O handlers for data formats and object types supported by the CDPL are registered in the static library initialization code. These built-in handlers are accessible by the linking client code as soon as the library initialization has finished.

Member Function Documentation

◆ registerInputHandler()

None CDPL.Pharm.FeatureContainerIOManager.registerInputHandler ( object  handler)
static

Registers the specified Pharm.FeatureContainerInputHandler implementation instance.

Parameters
handlerThe Pharm.FeatureContainerInputHandler implementation instance to register.

◆ getInputHandler()

object CDPL.Pharm.FeatureContainerIOManager.getInputHandler ( int  idx)
static

Returns a reference to the registered Pharm.FeatureContainerInputHandler implementation instance with the specified index.

Parameters
idxThe zero-based index of the Pharm.FeatureContainerInputHandler implementation instance to return.
Returns
A reference to the Pharm.FeatureContainerInputHandler implementation instance with the specified index.
Exceptions
Base.IndexErrorif idx is out of bounds.

◆ getInputHandlerByFormat()

object CDPL.Pharm.FeatureContainerIOManager.getInputHandlerByFormat ( Base.DataFormat  fmt)
static

Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the specified data format.

Parameters
fmtSpecifies the data format that is associated with the requested Pharm.FeatureContainerInputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the specified data format, or None if not available.

◆ getInputHandlerByName()

object CDPL.Pharm.FeatureContainerIOManager.getInputHandlerByName ( str  name)
static

Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified name.

Parameters
nameSpecifies the name of the data format that is associated with the requested Pharm.FeatureContainerInputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified name, or None if not available.
Note
The matching of the name is not case-sensitive.

◆ getInputHandlerByFileExtension()

object CDPL.Pharm.FeatureContainerIOManager.getInputHandlerByFileExtension ( str  file_ext)
static

Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified file extension.

Parameters
file_extSpecifies the file extension of the data format that is associated with the requested Pharm.FeatureContainerInputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified file extension, or None if not available.
Note
The matching of the file extension is not case-sensitive.

◆ getInputHandlerByMimeType()

object CDPL.Pharm.FeatureContainerIOManager.getInputHandlerByMimeType ( str  mime_type)
static

Returns a reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified mime-type.

Parameters
mime_typeSpecifies the mime-type of the data format that is associated with the requested Pharm.FeatureContainerInputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerInputHandler implementation instance registered for the data format with the specified mime-type, or None if not available.
Note
The matching of the mime-type is not case-sensitive.

◆ unregisterInputHandler() [1/3]

bool CDPL.Pharm.FeatureContainerIOManager.unregisterInputHandler ( Base.DataFormat  fmt)
static

Unregisters the Pharm.FeatureContainerInputHandler implementation instance for the specified data format.

Only one handler instance at a time will be unregistered (in a first in - first out manner). If more than one handler instance has been registered for the given data format, the method has to be called multiple times to unregister all instances.

Parameters
fmtSpecifies the data format that is associated with the handler instance to unregister.
Returns
True if a handler instance for the specified data format was found and has been unregistered, and False otherwise.

◆ unregisterInputHandler() [2/3]

None CDPL.Pharm.FeatureContainerIOManager.unregisterInputHandler ( int  idx)
static

Unregisters the Pharm.FeatureContainerInputHandler implementation instance with the specified index.

Parameters
idxThe zero-based index of the Pharm.FeatureContainerInputHandler implementation instance to unregister.
Exceptions
Base.IndexErrorif idx is out of bounds.

◆ unregisterInputHandler() [3/3]

bool CDPL.Pharm.FeatureContainerIOManager.unregisterInputHandler ( object  handler)
static

Unregisters the specified Pharm.FeatureContainerInputHandler implementation instance.

Parameters
handlerThe Pharm.FeatureContainerInputHandler implementation instance to unregister.
Returns
True if the handler instance was found and has been unregistered, and False otherwise.

◆ getNumInputHandlers()

int CDPL.Pharm.FeatureContainerIOManager.getNumInputHandlers ( )
static

Returns the number of registered Pharm.FeatureContainerInputHandler implementation instances.

Returns
The number of registered Pharm.FeatureContainerInputHandler implementation instances.

◆ getInputHandlers()

InputHandlerSequence CDPL.Pharm.FeatureContainerIOManager.getInputHandlers ( )
static
Parameters
<br>
Returns

◆ registerOutputHandler()

None CDPL.Pharm.FeatureContainerIOManager.registerOutputHandler ( FeatureContainerOutputHandler  handler)
static

Registers the specified Pharm.FeatureContainerOutputHandler implementation instance.

Parameters
handlerThe Pharm.FeatureContainerOutputHandler implementation instance to register.

◆ getOutputHandler()

FeatureContainerOutputHandler CDPL.Pharm.FeatureContainerIOManager.getOutputHandler ( int  idx)
static

Returns a reference to the registered Pharm.FeatureContainerOutputHandler implementation instance with the specified index.

Parameters
idxThe zero-based index of the Pharm.FeatureContainerOutputHandler implementation instance to return.
Returns
A reference to the Pharm.FeatureContainerOutputHandler implementation instance with the specified index.
Exceptions
Base.IndexErrorif idx is out of bounds.

◆ getOutputHandlerByFormat()

FeatureContainerOutputHandler CDPL.Pharm.FeatureContainerIOManager.getOutputHandlerByFormat ( Base.DataFormat  fmt)
static

Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the specified data format.

Parameters
fmtSpecifies the data format that is associated with the requested Pharm.FeatureContainerOutputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the specified data format, or None if not available.

◆ getOutputHandlerByName()

FeatureContainerOutputHandler CDPL.Pharm.FeatureContainerIOManager.getOutputHandlerByName ( str  name)
static

Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified name.

Parameters
nameSpecifies the name of the data format that is associated with the requested Pharm.FeatureContainerOutputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified name, or None if not available.
Note
The matching of the name is not case-sensitive.

◆ getOutputHandlerByFileExtension()

FeatureContainerOutputHandler CDPL.Pharm.FeatureContainerIOManager.getOutputHandlerByFileExtension ( str  file_ext)
static

Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified file extension.

Parameters
file_extSpecifies the file extension of the data format that is associated with the requested Pharm.FeatureContainerOutputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified file extension, or None if not available.
Note
The matching of the file extension is not case-sensitive.

◆ getOutputHandlerByMimeType()

FeatureContainerOutputHandler CDPL.Pharm.FeatureContainerIOManager.getOutputHandlerByMimeType ( str  mime_type)
static

Returns a reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified mime-type.

Parameters
mime_typeSpecifies the mime-type of the data format that is associated with the requested Pharm.FeatureContainerOutputHandler implementation instance.
Returns
A reference to a Pharm.FeatureContainerOutputHandler implementation instance registered for the data format with the specified mime-type, or None if not available.
Note
The matching of the mime-type is not case-sensitive.

◆ unregisterOutputHandler() [1/3]

bool CDPL.Pharm.FeatureContainerIOManager.unregisterOutputHandler ( Base.DataFormat  fmt)
static

Unregisters the Pharm.FeatureContainerOutputHandler implementation instance for the specified data format.

Only one handler instance at a time will be unregistered (in a first in - first out manner). If more than one handler instance has been registered for the given data format, the method has to be called multiple times to unregister all instances.

Parameters
fmtSpecifies the data format that is associated with the handler instance to unregister.
Returns
True if a handler instance for the specified data format was found and has been unregistered, and False otherwise.

◆ unregisterOutputHandler() [2/3]

None CDPL.Pharm.FeatureContainerIOManager.unregisterOutputHandler ( int  idx)
static

Unregisters the Pharm.FeatureContainerOutputHandler implementation instance with the specified index.

Parameters
idxThe zero-based index of the Pharm.FeatureContainerOutputHandler implementation instance to unregister.
Exceptions
Base.IndexErrorif idx is out of bounds.

◆ unregisterOutputHandler() [3/3]

bool CDPL.Pharm.FeatureContainerIOManager.unregisterOutputHandler ( FeatureContainerOutputHandler  handler)
static

Unregisters the specified Pharm.FeatureContainerOutputHandler implementation instance.

Parameters
handlerThe Pharm.FeatureContainerOutputHandler implementation instance to unregister.
Returns
True if the handler instance was found and has been unregistered, and False otherwise.

◆ getNumOutputHandlers()

int CDPL.Pharm.FeatureContainerIOManager.getNumOutputHandlers ( )
static

Returns the number of registered Pharm.FeatureContainerOutputHandler implementation instances.

Returns
The number of registered Pharm.FeatureContainerOutputHandler implementation instances.

◆ getOutputHandlers()

OutputHandlerSequence CDPL.Pharm.FeatureContainerIOManager.getOutputHandlers ( )
static
Parameters
<br>
Returns