public abstract class AbstractImageSessionContext extends java.lang.Object implements ImageSessionContext
| Modifier and Type | Class and Description |
|---|---|
static interface |
AbstractImageSessionContext.FallbackResolver
Implementations of this interface will be used as the mechanism for creating the
Source that wraps resources. |
static class |
AbstractImageSessionContext.RestrictedFallbackResolver
This fallback resolver is to be used in environments where controlling file access is of
critical importance.
|
static class |
AbstractImageSessionContext.UnrestrictedFallbackResolver
An unrestricted resolver that has various contingency mechanisms that access the file-system.
|
| Constructor and Description |
|---|
AbstractImageSessionContext() |
AbstractImageSessionContext(AbstractImageSessionContext.FallbackResolver fallbackResolver) |
| Modifier and Type | Method and Description |
|---|---|
protected static javax.imageio.stream.ImageInputStream |
createImageInputStream(java.io.InputStream in) |
javax.xml.transform.Source |
getSource(java.lang.String uri)
Returns a Source object for a URI.
|
protected boolean |
isReusable(javax.xml.transform.Source src)
Indicates whether a Source is reusable.
|
javax.xml.transform.Source |
needSource(java.lang.String uri)
Returns a Source object for a URI.
|
javax.xml.transform.Source |
newSource(java.lang.String uri)
Attempts to create a Source object from the given URI.
|
protected abstract javax.xml.transform.Source |
resolveURI(java.lang.String uri)
Attempts to resolve the given URI.
|
void |
returnSource(java.lang.String uri,
javax.xml.transform.Source src)
Returns a Source object to a pool.
|
static java.io.File |
toFile(java.net.URL url)
Convert from a
URL to a File. |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitgetParentContext, getSourceResolution, getTargetResolutionpublic AbstractImageSessionContext()
public AbstractImageSessionContext(AbstractImageSessionContext.FallbackResolver fallbackResolver)
fallbackResolver - the fallback resolution mechanism to be used when simply getting an
InputStream that backs a Source isn't possible.protected abstract javax.xml.transform.Source resolveURI(java.lang.String uri)
uri - URI to accessSource object, or null if the URI
cannot be resolved.public javax.xml.transform.Source newSource(java.lang.String uri)
newSource in interface ImageSessionContexturi - URI to accessSource object, or null if the URI
cannot be resolved.protected static javax.imageio.stream.ImageInputStream createImageInputStream(java.io.InputStream in)
throws java.io.IOException
java.io.IOExceptionpublic static java.io.File toFile(java.net.URL url)
URL to a File.
This method will decode the URL.
Syntax such as file:///my%20docs/file.txt will be
correctly decoded to /my docs/file.txt.
Note: this method has been copied over from Apache Commons IO and enhanced to support UNC paths.
url - the file URL to convert, null returns nullFile object, or null
if the URL's protocol is not filejava.lang.IllegalArgumentException - if the file is incorrectly encodedpublic javax.xml.transform.Source getSource(java.lang.String uri)
ImageSessionContext.returnSource(String, Source) method).getSource in interface ImageSessionContexturi - the URI of the imagepublic javax.xml.transform.Source needSource(java.lang.String uri)
throws java.io.FileNotFoundException
FileNotFoundException is thrown.needSource in interface ImageSessionContexturi - the URI of the imagejava.io.FileNotFoundException - if the image cannot be foundpublic void returnSource(java.lang.String uri,
javax.xml.transform.Source src)
returnSource in interface ImageSessionContexturi - the URI of the imagesrc - the Source object belonging to the URIprotected boolean isReusable(javax.xml.transform.Source src)
ImageSource (containing an ImageInputStream) or a DOMSource.src - the Source objectCopyright 1999-2025 The Apache Software Foundation. All Rights Reserved.