XML::SimpleDB::ResourceSet - container for multiple documents or document fragments
$collection = $dbm->getCollection("xmldb:$driver:$url/db/test/shakespeare"); $service = $collection->getService('XPathQueryService', '1.0'); $resourceSet = $service->query('//TITLE'); $id = 'hamlet.xml'; $resourceSet->addResource($collection->getResource($id)); $n = $resourceSet->getSize(); $resource = $resourceSet->getResource($n-1); $resourceSet->removeResource($n); $aref = $resourceSet->getIterator(); foreach(@{$aref)){ $xml = $_->getContent(); } $resourceSet->clear();
A container for resources, normally used when a query returns multiple document fragments.
Graham Seaman CPAN ID: GSEAMAN graham@opencollector.org
Copyright (c) 2002 Graham Seaman. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
XML::DB::Resource
Usage : $rs->addResource($resource)
Purpose : Store an additional resource
Argument : The resource to store
Returns : undef
Usage : $rs->clear()
Purpose : delete all current resources
Argument : None
Usage : $rs->getIterator()
Purpose : Should return an iterator; just returns an array reference (foreach is an iterator, isnt it?)
Returns : array reference to resources
Usage : $xml = $rs->getMembersAsResource()
Purpose : Returns a resource with an xml reprentation of contents
Argument : none
Returns : Resource
Comment : Not defined; the xml format is not yet defined in the spec. Need to check if Xindice or eXist have chosen to implement this.
Usage : $rs->getResource($no)
Purpose : returns resource at position $no
Argument : Integer position in array
Usage : $size = $rs->getSize()
Purpose : returns number of stored resources
Returns : Integer
Usage : $rs->removeResource($no)
Purpose : Removes Resource at position $no
Argument : Integer position
Purpose : Constructor
Comments : The constructor should not be called directly; new ResourceSets are created as a result of an XPathQuery.
To install XML::DB::Service, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XML::DB::Service
CPAN shell
perl -MCPAN -e shell install XML::DB::Service
For more information on module installation, please visit the detailed CPAN module installation guide.