gov.nasa.worldwind.ogc.kml.io

Class KMLInputStream

java.lang.Object

gov.nasa.worldwind.ogc.kml.io.KMLInputStream

All Implemented Interfaces:

KMLDoc

public class KMLInputStream
extends java.lang.Object
implements KMLDoc

Implements the KMLDoc interface for KML files read directly from input streams.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.io.InputStream	inputStream The InputStream specified to the constructor.
protected java.net.URI	uri The URI of this KML document.

Constructor Summary

Constructors

Constructor and Description
KMLInputStream(java.io.InputStream sourceStream, java.net.URI uri) Construct a KMLInputStream instance.

Method Summary

Modifier and Type	Method and Description
java.io.InputStream	getKMLStream() Returns the input stream reference passed to the constructor.
java.lang.String	getSupportFilePath(java.lang.String path) Resolve references against the document's URI.
java.io.InputStream	getSupportFileStream(java.lang.String path) Resolve references against the document's URI.

Methods inherited from class java.lang.Object

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

Field Detail

inputStream

protected java.io.InputStream inputStream

The InputStream specified to the constructor.

uri

protected java.net.URI uri

The URI of this KML document. May be null.

Constructor Detail

KMLInputStream

public KMLInputStream(java.io.InputStream sourceStream,
                      java.net.URI uri)
               throws java.io.IOException

Construct a KMLInputStream instance.

Parameters:

sourceStream - the KML stream.

uri - the URI of this KML document. This URI is used to resolve relative references. May be null.

Throws:

java.lang.IllegalArgumentException - if the specified input stream is null.

java.io.IOException - if an error occurs while attempting to read from the stream.

Method Detail

getKMLStream

public java.io.InputStream getKMLStream()
                                 throws java.io.IOException

Returns the input stream reference passed to the constructor.

Specified by:

getKMLStream in interface KMLDoc

Returns:

the input stream reference passed to the constructor.

Throws:

java.io.IOException - if an error occurs while attempting to create or open the input stream.

getSupportFilePath

public java.lang.String getSupportFilePath(java.lang.String path)

Resolve references against the document's URI.

Specified by:

getSupportFilePath in interface KMLDoc

Parameters:

path - the path of the requested file.

Returns:

a URL to the requested file, or null if the document does not have a base URI.

getSupportFileStream

public java.io.InputStream getSupportFileStream(java.lang.String path)
                                         throws java.io.IOException

Resolve references against the document's URI.

Specified by:

getSupportFileStream in interface KMLDoc

Parameters:

path - the path of the requested file.

Returns:

an input stream positioned to the start of the file, or null if the file does not exist.

Throws:

java.io.IOException - if an error occurs while attempting to query or open the file.