A datapool factory manages the construction and sharing of
IDatapool and IDatapoolIterator objects.
Test scripts by default use managed datapools that share the
datapool and iterator instance across multiple scripts.
Load the datapool from the specified file. If a
sharedInstance is requested then the cache of
other datapools that have been opened is checked for an
existing copy of the datapool. Note that modifying a shared
instance of the datapool may effect other uses of the datapool
and should only be done in a confined execution environment.
dpFile - The datapool file name.
sharedInstance - Available for sharing instances of
the datapool, which can save significantly
on datapool loading overhead.
Removes a reference to an instance of a datapool. If the
datapool is shared the reference count is reduced. Once
all references to a datapool have been unloaded the datapool
instance may be made available to garbage collection.
Return an iterator instance of the supplied iterator class.
Depending on attributes associated with the iterator class it
may be shared. The attributes of an iterator are negotiated
between the factory implementation and the iterator base class.
datapool - The datapool instance being iterated over.