org.openstreetmap.josm.io.imagery

Class ImageryReader

java.lang.Object

org.openstreetmap.josm.io.imagery.ImageryReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ImageryReader
extends java.lang.Object
implements java.io.Closeable

Reader to parse the list of available imagery servers from an XML definition file.

The format is specified in the JOSM wiki.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ImageryReader.Parser
private static class	ImageryReader.State

Field Summary

Fields

Modifier and Type	Field and Description
private CachedFile	cachedFile
private boolean	fastFail
private java.lang.String	source

Constructor Summary

Constructors

Constructor and Description
ImageryReader(java.lang.String source) Constructs a ImageryReader from a given filename, URL or internal resource.

Method Summary

Modifier and Type	Method and Description
void	close()
java.util.List<ImageryInfo>	parse() Parses imagery source.
void	setFastFail(boolean fastFail) Sets whether opening HTTP connections should fail fast, i.e., whether a low connect timeout should be used.

Methods inherited from class java.lang.Object

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

Field Detail

source

private final java.lang.String source

cachedFile

private CachedFile cachedFile

fastFail

private boolean fastFail

Constructor Detail

ImageryReader

public ImageryReader(java.lang.String source)

Constructs a ImageryReader from a given filename, URL or internal resource.

Parameters:

source - can be:

• relative or absolute file name
• file:///SOME/FILE the same as above
• http://... a URL. It will be cached on disk.
• resource://SOME/FILE file from the classpath (usually in the current *.jar)
• josmdir://SOME/FILE file inside josm user data directory (since r7058)
• josmplugindir://SOME/FILE file inside josm plugin directory (since r7834)

Method Detail

parse

public java.util.List<ImageryInfo> parse()
                                  throws org.xml.sax.SAXException,
                                         java.io.IOException

Parses imagery source.

Returns:

list of imagery info

Throws:

org.xml.sax.SAXException - if any SAX error occurs

java.io.IOException - if any I/O error occurs

setFastFail

public void setFastFail(boolean fastFail)

Sets whether opening HTTP connections should fail fast, i.e., whether a low connect timeout should be used.

Parameters:

fastFail - whether opening HTTP connections should fail fast

See Also:

CachedFile.setFastFail(boolean)

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException