public final class WmsModelDecoder extends Object
IRasterModel
that connects to a WMS service.
See WmsModelDecoder#decode
for more details.
Modifier and Type | Method and Description |
---|---|
static IRasterModel |
decode(WmsDataSource dataSource)
Creates a WMS raster model, or returns information about why this model cannot be created.
|
static IRasterModel |
decode(WmsDataSource dataSource,
WmsCapabilities wmsCapabilities)
Creates a WMS raster model, or returns information about why this model cannot be created.
|
static IRasterModel |
decode(WmsDataSource dataSource,
WmsModelDecoderOptions options)
Creates a WMS raster model, or returns information about why this model cannot be created.
|
static IRasterModel |
decode(WmsDataSource dataSource,
WmsModelDecoderOptions options,
WmsCapabilities wmsCapabilities)
Creates a WMS raster model, or returns information about why this model cannot be created.
|
@NotNull public static IRasterModel decode(@NotNull WmsDataSource dataSource, @Nullable WmsCapabilities wmsCapabilities) throws IOException
dataSource
- The structure describing the source to use for data retrieval.wmsCapabilities
- The source's capabilities. Can be retrieved before using WmsCapabilities#getCapabilities
and reused. If set to null
, it will be queried internally.IOException
- when creation of the model fails.@NotNull public static IRasterModel decode(@NotNull WmsDataSource dataSource) throws IOException
dataSource
- The structure describing the source to use for data retrieval.IOException
- when creation of the model fails.@NotNull public static IRasterModel decode(@NotNull WmsDataSource dataSource, @NotNull WmsModelDecoderOptions options, @Nullable WmsCapabilities wmsCapabilities) throws IOException
The WMS capabilities are used to check the WmsDataSource
validity. The WMS requests are following the 1.3.0 or the 1.1.1 specification depending on the version referred in the WMS capabilities
.
This model does not support the entire WMS specification. The following restrictions are used:
CRS:84
.
bounds
is computed from the datasource's layers data extent if they are available, if not the bounds covers the entire coordinate reference system.
image/png
and image/jpeg
. When no image format is specified in the data source image/png
is used when available and image/jpeg
otherwise.
dataSource
- The structure describing the source to use for data retrieval.options
- Options for decoding WMS data, e.g. an optional http client implementation to send HTTP requests when fetching WMS resources.wmsCapabilities
- The source's capabilities. Can be retrieved before using WmsCapabilities#getCapabilities
and reused. If set to null
, it will be queried internally.IOException
- when creation of the model fails.@NotNull public static IRasterModel decode(@NotNull WmsDataSource dataSource, @NotNull WmsModelDecoderOptions options) throws IOException
The WMS capabilities are used to check the WmsDataSource
validity. The WMS requests are following the 1.3.0 or the 1.1.1 specification depending on the version referred in the WMS capabilities
.
This model does not support the entire WMS specification. The following restrictions are used:
CRS:84
.
bounds
is computed from the datasource's layers data extent if they are available, if not the bounds covers the entire coordinate reference system.
image/png
and image/jpeg
. When no image format is specified in the data source image/png
is used when available and image/jpeg
otherwise.
dataSource
- The structure describing the source to use for data retrieval.options
- Options for decoding WMS data, e.g. an optional http client implementation to send HTTP requests when fetching WMS resources.IOException
- when creation of the model fails.