Package org.apache.sis.internal.storage.wkt

Class Store

java.lang.Object

org.apache.sis.storage.DataStore

org.apache.sis.internal.storage.URIDataStore

org.apache.sis.internal.storage.wkt.Store

All Implemented Interfaces:

AutoCloseable, ResourceOnFileSystem, StoreResource, Resource, Localized

final class Store
extends URIDataStore

A data store which creates data objects from a WKT definition.

Note: this class differs from PRJDataStore in that the file containing WKT definition is the main file, not an auxiliary file.

Since:

0.7

Version:

1.3

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.sis.internal.storage.URIDataStore

URIDataStore.Provider

Field Summary

Fields

Modifier and Type	Field	Description
private final GeometryLibrary	library	The geometry library, or null for the default.
private final Locale	locale	The locale for InternationalString localization or null for Locale.ROOT (usually English).
private org.opengis.metadata.Metadata	metadata	The metadata object, created when first needed.
private final List<Object>	objects	The parsed objects, filled only when first needed.
private static final int	SIZE_LIMIT	Arbitrary size limit.
private Reader	source	The reader, set by the constructor and cleared when no longer needed.
private final TimeZone	timezone	Timezone for dates, or null for UTC.

Fields inherited from class org.apache.sis.internal.storage.URIDataStore

location

Fields inherited from class org.apache.sis.storage.DataStore

listeners, provider

Constructor Summary

Constructors

Constructor	Description
Store(StoreProvider provider, StorageConnector connector)	Creates a new WKT store from the given file, URL or stream.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this data store and releases any underlying resources.
org.opengis.metadata.Metadata	getMetadata()	Returns the metadata associated to the parsed objects, or null if none.
private void	parse()	Parses the objects, if not already done.

Methods inherited from class org.apache.sis.internal.storage.URIDataStore

addTitleOrIdentifier, getComponentFiles, getIdentifier, getOpenParameters, getOriginator, getSpecifiedPath, location, parameters

Methods inherited from class org.apache.sis.storage.DataStore

addListener, findResource, getDisplayName, getLocale, getNativeMetadata, getProvider, removeListener, setLocale, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sis.storage.Resource

addListener, removeListener

Field Details

SIZE_LIMIT

private static final int SIZE_LIMIT

Arbitrary size limit. Files that big are likely to be something else than WKT, so this limit allows earlier error reporting than loading huge amount of data before to detect that those data are not what we taught they are.

See Also:

• Constant Field Values

source

private Reader source

The reader, set by the constructor and cleared when no longer needed.

locale

private final Locale locale

The locale for InternationalString localization or null for Locale.ROOT (usually English). This locale is not used for parsing numbers or dates.

timezone

private final TimeZone timezone

Timezone for dates, or null for UTC.

library

private final GeometryLibrary library

The geometry library, or null for the default.

objects

private final List<Object> objects

The parsed objects, filled only when first needed. May still be empty if the parsing failed.

metadata

private org.opengis.metadata.Metadata metadata

The metadata object, created when first needed.

Constructor Details

Store

public Store(StoreProvider provider,
 StorageConnector connector)
      throws DataStoreException

Creates a new WKT store from the given file, URL or stream.

Parameters:

provider - the factory that created this DataStore instance, or null if unspecified.

connector - information about the storage (URL, stream, etc).

Throws:

DataStoreException - if an error occurred while opening the stream.

Method Details

parse

private void parse()
            throws DataStoreException

Parses the objects, if not already done. Note that objects may still be empty if an exception has been thrown at this invocation time or in previous invocation.

Throws:

DataStoreException - if an error occurred during the parsing process.

getMetadata

public org.opengis.metadata.Metadata getMetadata()
                                          throws DataStoreException

Returns the metadata associated to the parsed objects, or null if none. The current implementation retains only instances of ReferenceSystem and ignore other objects. The identification information Citation is set to the CRS name and identifier, unless there is ambiguity.

Specified by:

getMetadata in interface Resource

Specified by:

getMetadata in class DataStore

Returns:

the metadata associated to the parsed object, or null if none.

Throws:

DataStoreException - if an error occurred during the parsing process.

See Also:

• DataStore.getIdentifier()
• DefaultMetadata.deepCopy(Metadata)

close

public void close()
           throws DataStoreException

Closes this data store and releases any underlying resources.

Specified by:

close in interface AutoCloseable

Specified by:

close in class DataStore

Throws:

DataStoreException - if an error occurred while closing this data store.

See Also:

• StoreListeners.close()