Bio::OntologyIO::Handlers::InterPro_BioSQL_Handler - parse an InterPro XML file
and persist the resulting terms to a Biosql database
# see load_interpro.pl in bioperl-db/scripts/biosql/
This module is for parsing an InterPro XML file and persist the resulting terms
to a Biosql database as soon as the term is complete as signaled by the
appropriate xml tag. This parser takes advantage of SAX, a stream-based XML
parser technology, to keep the used memory as small as possible. The
alternative parser for InterPro, module InterProHandler, builds up the entire
ontology in memory, which given the size of the latest InterPro releases
requires a huge amount of memory.
This module takes the following non-standard arguments upon instantiation.
-db the adaptor factory as returned by a call to
Bio::DB::BioDB->new()
-version the InterPro version (not available as property!)
-term_factory the object factory to use for creating terms
Note that there are two alternatives for how to persist the terms and
relationships to the database. The default is using the adaptor factory passed
as -db or set as a property to create persistent objects and store them in the
database. The alternative is to specify a term persistence and a relationship
persistence handler; if one or both have been set, the respective handler will
be called with each term and relationship that is to be stored. See properties
persist_term_handler and persist_relationship_handler.
Juguang Xiao,
[email protected]
Hilmar Lapp, hlapp at gmx.net
The rest of the documentation details each of the object methods. Internal
methods are usually preceded with a _
Title : term_factory
Usage : $obj->term_factory($newval)
Function: Get/set the ontology term factory to use.
As a user of this module it is not necessary to call this
method as there will be default. In order to change the
default, the easiest way is to instantiate
L<Bio::Ontology::TermFactory> with the proper -type
argument. Most if not all parsers will actually use this
very implementation, so even easier than the aforementioned
way is to simply call
$ontio->term_factory->type("Bio::Ontology::MyTerm").
Example :
Returns : value of term_factory (a Bio::Factory::ObjectFactoryI object)
Args : on set, new value (a Bio::Factory::ObjectFactoryI object, optional)
Title : db
Usage : $obj->db($newval)
Function: Sets or retrieves the database adaptor factory.
The adaptor factory is a Bio::DB::DBAdaptorI compliant
object and will be used to obtain the persistence adaptors
necessary to serialize terms and relationships to the
database.
Usually, you will obtain such an object from a call to
Bio::DB::BioDB. You *must* set this property before
starting the parse.
Note that this property is immutable once set, except that
you may set it to undef. Therefore, be careful not to set
to undef before setting the desired real value.
Example :
Returns : value of db (a Bio::DB::DBAdaptorI compliant object)
Args : on set, new value (a Bio::DB::DBAdaptorI compliant object
or undef, optional)
Title : persist_term_handler
Usage : $obj->persist_term_handler($handler,@args)
Function: Sets or retrieves the persistence handler for terms along
with the constant set of arguments to be passed to the
handler.
If set, the first argument will be treated as a closure and
be called for each term to persist to the database. The
term will be passed as a named parameter (-term), followed
by the other arguments passed to this setter. Note that
this allows one to pass an arbitrary configuration to the
handler.
If not set, terms will be persisted along with their
relationships using the respective persistence adaptor
returned by the adaptor factory (see property db).
Example :
Returns : an array reference with the values passed on set, or an empty
array if never set
Args : On set, an array of values. The first value is the handler
as a closure; all other values will be passed to the handler
as constant argument.
Title : persist_relationship_handler
Usage : $obj->persist_relationship_handler($handler,@args)
Function: Sets or retrieves the persistence handler for relationships
along with the constant set of arguments to be passed to
the handler.
If set, the first argument will be treated as a closure and
be called for each relationship to persist to the database. The
relationship will be passed as a named parameter (-rel), followed
by the other arguments passed to this setter. Note that
this allows one to pass an arbitrary configuration to the
handler.
If not set, relationships will be persisted along with their
relationships using the respective persistence adaptor
returned by the adaptor factory (see property db).
Example :
Returns : an array reference with the values passed on set, or an empty
array if never set
Args : On set, an array of values. The first value is the handler
as a closure; all other values will be passed to the handler
as constant argument.
Title : _persist_term
Usage :
Function: Persists a term to the database, using either a previously
set persistence handler, or the adaptor factory directly.
Example :
Returns :
Args : the ontology term to persist
Title : _persist_relationship
Usage :
Function: Persists a relationship to the database, using either a
previously set persistence handler, or the adaptor factory
directly.
Example :
Returns :
Args : the term relationship to persist
Title : _persist_ontology
Usage :
Function: Perists the ontology itself to the database, by either
inserting or updating it.
Note that this will only create or update the ontology as
an entity, not any of its terms, relationships, or
relationship types.
Example :
Returns : the ontology as a persistent object with primary key
Args : the ontology to persist as a Bio::Ontology::OntologyI
compliant object