net.sf.saxon.lib

Interface SourceResolver

All Known Implementing Classes:

Configuration

public interface SourceResolver

This interface defines a SourceResolver. A SourceResolver can be registered as part of the Configuration, and enables new kinds of Source to be recognized beyond those that are natively recognized by Saxon.

The task of the SourceResolver is to take any Source as input, and to return an ActiveSource that knows how to deliver itself to a Receiver. This allows new kinds of Source to be introduced, provided they implement the ActiveSource interface.

Method Summary

Modifier and Type	Method and Description
ActiveSource	resolveSource(javax.xml.transform.Source source, Configuration config) Resolve a Source.

Method Detail

resolveSource

ActiveSource resolveSource(javax.xml.transform.Source source,
                           Configuration config)
                    throws XPathException

Resolve a Source.

Parameters:

source - A source object, typically the source supplied as the first argument to Transformer.transform(javax.xml.transform.Source, javax.xml.transform.Result) or similar methods.

config - The Configuration. This provides the SourceResolver with access to configuration information; it also allows the SourceResolver to invoke the resolveSource() method on the Configuration object as a fallback implementation.

Returns:

a source object that Saxon knows how to process. Any implementation of ActiveSource is acceptable.

Throws:

XPathException - if the Source object is recognized but cannot be processed