net.sf.saxon.resource

Class ExplicitCollection

java.lang.Object

net.sf.saxon.resource.AbstractResourceCollection

net.sf.saxon.resource.ExplicitCollection

All Implemented Interfaces:

ResourceCollection

public class ExplicitCollection
extends AbstractResourceCollection

This class represents a resource collection containing an explicitly enumerated set of resources

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, config, noExceptions, params

Constructor Summary

Constructors

Constructor and Description
ExplicitCollection(Configuration config, java.lang.String collectionURI, java.util.List<Resource> resources) Create an explicit collection

Method Summary

Modifier and Type	Method and Description
java.util.Iterator<? extends Resource>	getResources(XPathContext context) Get the resources in the collection.
java.util.Iterator<java.lang.String>	getResourceURIs(XPathContext context) Get the URIs of the resources in the collection.
boolean	stripWhitespace(SpaceStrippingRule rules) Supply information about the whitespace stripping rules that apply to this collection.

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

checkNotNull, getCollectionURI, getInputDetails, guessContentTypeFromContent, guessContentTypeFromName, isStable, makeResource, makeResource, makeTypedResource, optionsFromQueryParameters, registerContentType, setupErrorHandlingForCollection

Methods inherited from class java.lang.Object

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

Constructor Detail

ExplicitCollection

public ExplicitCollection(Configuration config,
                          java.lang.String collectionURI,
                          java.util.List<Resource> resources)

Create an explicit collection

Parameters:

config - the Saxon Configuration

collectionURI - the collection URI

resources - the resources in the collection

Method Detail

stripWhitespace

public boolean stripWhitespace(SpaceStrippingRule rules)

Supply information about the whitespace stripping rules that apply to this collection. This method will only be called when the collection() function is invoked from XSLT.

Overrides:

stripWhitespace in class AbstractResourceCollection

Parameters:

rules - the space-stripping rules that apply to this collection, derived from the xsl:strip-space and xsl:preserve-space declarations in the stylesheet package containing the call to the collection() function.

Returns:

true if the collection finder intends to take responsibility for whitespace stripping according to these rules; false if it wishes Saxon itself to post-process any returned XML documents to strip whitespace. Returning true may either indicate that the collection finder will strip whitespace before returning a document, or it may indicate that it does not wish the space stripping rules to be applied. The default (returned by this method if not overridden) is false.

getResourceURIs

public java.util.Iterator<java.lang.String> getResourceURIs(XPathContext context)

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 UnparsedTextURIResolver (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. The URIs are represented as Strings. They should preferably be absolute URIs.

getResources

public java.util.Iterator<? extends Resource> getResources(XPathContext context)

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. This returns objects of class Resource.