net.sf.saxon.resource

Class DirectoryCollection

java.lang.Object

net.sf.saxon.resource.AbstractResourceCollection

net.sf.saxon.resource.DirectoryCollection

All Implemented Interfaces:

ResourceCollection

public class DirectoryCollection
extends AbstractResourceCollection

This class represents a resource collection containing all, or selected, files within a filestore directory.

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.saxon.resource.AbstractResourceCollection

AbstractResourceCollection.InputDetails

Field Summary

Fields inherited from class net.sf.saxon.resource.AbstractResourceCollection

collectionURI, params

Constructor Summary

Constructors

Constructor and Description
DirectoryCollection(String collectionURI, File file, URIQueryParameters params) Create a directory collection

Method Summary

Methods

Modifier and Type	Method and Description
protected Iterator<String>	directoryContents(File directory, URIQueryParameters params) Return the contents of a collection that maps to a directory in filestore
Iterator<Resource>	getResources(XPathContext context) Get the resources in the collection.
Iterator<String>	getResourceURIs(XPathContext context) Get the URIs of the resources in the collection.

Methods inherited from class net.sf.saxon.resource.AbstractResourceCollection

getCollectionURI, getInputDetails, guessContentType, isStable, makeResource, optionsFromQueryParameters, registerContentType, registerFileExtension

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DirectoryCollection

public DirectoryCollection(String collectionURI,
                   File file,
                   URIQueryParameters params)

Create a directory collection

Parameters:

collectionURI - the collection URI

file - the directory containing the files

params - query parameters supplied as part of the URI

Method Detail

getResourceURIs

public Iterator<String> getResourceURIs(XPathContext context)
                                 throws XPathException

Description copied from interface: ResourceCollection

Get the URIs of the resources in the collection. This supports the fn:uri-collection() function. It is not required that all collections expose a list of URIs in this way, or that the URIs bear any particular relationship to the resources returned by the getResources() method for the same collection URI. The URIs that are returned should be suitable for passing to the registered URIResolver (in the case of XML resources), or the UnparsedTextResolver (in the case of unparsed text and JSON resources), etc.

Parameters:

context - the XPath evaluation context

Returns:

an iterator over the URIs of the resources in the collection

Throws:

XPathException - in the event of any error (for example, if the collection URI is not recognized)

getResources

public Iterator<Resource> getResources(XPathContext context)
                                throws XPathException

Description copied from interface: ResourceCollection

Get the resources in the collection. This supports the fn:collection() function. It is not required that all collections expose a set of resources in this way, or that the resources returned bear any particular relationship to the URIs returned by the getResourceURIs() method for the same collection URI.

Parameters:

context - the XPath evaluation context

Returns:

an iterator over the resources in the collection

Throws:

XPathException - in the event of any error (for example, if the collection URI is not recognized)

directoryContents

protected Iterator<String> directoryContents(File directory,
                                 URIQueryParameters params)

Return the contents of a collection that maps to a directory in filestore

Parameters:

directory - the directory to be processed

params - parameters indicating whether to process recursively, what to do on errors, and which files to select

Returns:

an iterator over the absolute URIs of the documents in the collection