net.sf.saxon.resource

Class JarCollection

java.lang.Object

net.sf.saxon.resource.AbstractResourceCollection

net.sf.saxon.resource.JarCollection

All Implemented Interfaces:

ResourceCollection

public class JarCollection
extends AbstractResourceCollection

A JarCollection represents a collection of resources held in a JAR or ZIP archive, accessed typically using a URI using the (Java-defined) "jar" URI scheme, or simply a "file" URI where the target file is a JAR or ZIP file.

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

params

Constructor Summary

Constructors

Constructor and Description
JarCollection(XPathContext context, String collectionURI, URIQueryParameters params) Create a JarCollection

Method Summary

Methods

Modifier and Type	Method and Description
String	getCollectionURI() Get the URI identifying this collection
Iterator<Resource>	getResources(XPathContext context) Get the resources in the collection.
Iterator<String>	getResourceURIs(XPathContext context) Get the URIs of the resources within the collection
protected Map<String,Sequence>	makeProperties(ZipEntry entry) Get the properties of a Zip file entry, for use when returning a MetadataResource containing this information

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

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

JarCollection

public JarCollection(XPathContext context,
             String collectionURI,
             URIQueryParameters params)

Create a JarCollection

Parameters:

context - The XPath dynamic context

collectionURI - the collection URI used to identify this collection (typically but not necessarily the location of the JAR file)

params - URI query parameters appearing on the collection URI

Method Detail

getCollectionURI

public String getCollectionURI()

Get the URI identifying this collection

Specified by:

getCollectionURI in interface ResourceCollection

Overrides:

getCollectionURI in class AbstractResourceCollection

Returns:

the collection URI

getResourceURIs

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

Get the URIs of the resources within the collection

Parameters:

context -

Returns:

a list of all the URIs of resources within the collection. The resources are identified by URIs of the form collection-uri!entry-path

Throws:

XPathException - if any error occurs accessing the JAR file contents

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)

makeProperties

protected Map<String,Sequence> makeProperties(ZipEntry entry)

Get the properties of a Zip file entry, for use when returning a MetadataResource containing this information

Parameters:

entry - the current Zip file entry

Returns:

a map containing the properties of this entry: comment, compressed-size, crc, extra, compression-method, entry-name, size, and last-modified.