de.cismet.commons.cismap.io.converters

Class GeomFromWkbConverter

java.lang.Object

de.cismet.commons.cismap.io.converters.GeomFromWkbConverter

All Implemented Interfaces:

BinaryToGeometryConverter, GeometryConverter<byte[]>, de.cismet.commons.converter.Converter<byte[],com.vividsolutions.jts.geom.Geometry>, de.cismet.commons.converter.FormatHint

public final class GeomFromWkbConverter
extends Object
implements BinaryToGeometryConverter

Creates a geometry from (E)WKB. However, the conversion back from a geometry produces WKB only. If the input is EWKB a possibly provided EPSG is ignored. Additionally the backwards conversion can take an additional parameter, the endian. By default the result of the conversion is a byte array with little endian encoding. Iff the first parameter equals 'XDR' (ignoring case) the big endian encoding will be used. This behaviour is equal to the ST_AsBinary function of PostGIS. The result of the backwards conversion is always two-dimensional.

Version:

1.0

Author:

martin.scholl@cismet.de

Nested Class Summary

Nested classes/interfaces inherited from interface de.cismet.commons.converter.Converter

de.cismet.commons.converter.Converter.MatchRating<FROM>

Constructor Summary

Constructors

Constructor and Description
GeomFromWkbConverter()

Method Summary

Modifier and Type	Method and Description
byte[]	convertBackward(com.vividsolutions.jts.geom.Geometry to, String... params) Converts a given instance of Geometry back to the origin format FROM.
com.vividsolutions.jts.geom.Geometry	convertForward(byte[] from, String... params) Converts a given instance FROM to a Geometry.
String	getFormatDescription()
String	getFormatDisplayName()
Object	getFormatExample()
String	getFormatHtmlDescription()
String	getFormatHtmlName()
String	getFormatName()

Methods inherited from class java.lang.Object

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

Constructor Detail

GeomFromWkbConverter

public GeomFromWkbConverter()

Method Detail

convertForward

public com.vividsolutions.jts.geom.Geometry convertForward(byte[] from,
                                                           String... params)
                                                    throws de.cismet.commons.converter.ConversionException

Converts a given instance FROM to a Geometry. The first parameter must be the EPSG code, e.g. EPSG:4326.

Specified by:

convertForward in interface GeometryConverter<byte[]>

Specified by:

convertForward in interface de.cismet.commons.converter.Converter<byte[],com.vividsolutions.jts.geom.Geometry>

Parameters:

from - the originating object that shall be converted to a Geometry

params - first parameter must be the EPSG code

Returns:

an instance of Geometry which was create from the FROM instance

Throws:

de.cismet.commons.converter.ConversionException - if any error occurs during conversion

convertBackward

public byte[] convertBackward(com.vividsolutions.jts.geom.Geometry to,
                              String... params)
                       throws de.cismet.commons.converter.ConversionException

Description copied from interface: GeometryConverter

Converts a given instance of Geometry back to the origin format FROM. The first parameter must be the EPSG code, e.g. EPSG:4326.

Specified by:

convertBackward in interface GeometryConverter<byte[]>

Specified by:

convertBackward in interface de.cismet.commons.converter.Converter<byte[],com.vividsolutions.jts.geom.Geometry>

Parameters:

to - the geometry that shall be converted back to an instance of FROM

params - no parameters needed

Returns:

an instance of FROM which was create from the Geometry instance

Throws:

de.cismet.commons.converter.ConversionException - if any error occurs during conversion

getFormatName

public String getFormatName()

Specified by:

getFormatName in interface de.cismet.commons.converter.FormatHint

getFormatDisplayName

public String getFormatDisplayName()

Specified by:

getFormatDisplayName in interface de.cismet.commons.converter.FormatHint

getFormatHtmlName

public String getFormatHtmlName()

Specified by:

getFormatHtmlName in interface de.cismet.commons.converter.FormatHint

getFormatDescription

public String getFormatDescription()

Specified by:

getFormatDescription in interface de.cismet.commons.converter.FormatHint

getFormatHtmlDescription

public String getFormatHtmlDescription()

Specified by:

getFormatHtmlDescription in interface de.cismet.commons.converter.FormatHint

getFormatExample

public Object getFormatExample()

Specified by:

getFormatExample in interface de.cismet.commons.converter.FormatHint