|
xmlgraphics-commons 1.3.1 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext
public abstract class AbstractImageSessionContext
Abstract base class for classes implementing ImageSessionContext. This class provides all the special treatment for Source creation, i.e. it provides optimized Source objects where possible.
Constructor Summary | |
---|---|
AbstractImageSessionContext()
|
Method Summary | |
---|---|
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 . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.apache.xmlgraphics.image.loader.ImageSessionContext |
---|
getParentContext, getTargetResolution |
Constructor Detail |
---|
public AbstractImageSessionContext()
Method Detail |
---|
protected abstract javax.xml.transform.Source resolveURI(java.lang.String uri)
uri
- URI to access
Source
object, or null if the URI
cannot be resolved.public javax.xml.transform.Source newSource(java.lang.String uri)
newSource
in interface ImageSessionContext
uri
- URI to access
Source
object, or null if the URI
cannot be resolved.public 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 null
File
object, or null
if the URL's protocol is not file
java.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 ImageSessionContext
uri
- the URI of the image
public javax.xml.transform.Source needSource(java.lang.String uri) throws java.io.FileNotFoundException
FileNotFoundException
is thrown.
needSource
in interface ImageSessionContext
uri
- the URI of the image
java.io.FileNotFoundException
- if the image cannot be foundpublic void returnSource(java.lang.String uri, javax.xml.transform.Source src)
returnSource
in interface ImageSessionContext
uri
- 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 object
|
xmlgraphics-commons 1.3.1 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |