com.vividsolutions.jts.io.oracle

Class OraReader

java.lang.Object

com.vividsolutions.jts.io.oracle.OraReader

public class OraReader
extends Object

Reads a Geometry from an Oracle MDSYS.GEOMETRY STRUCT object.

The following Oracle geometry types are supported:

• POINT, MULTIPOINT
• LINE, MULTILINE
• POLYGON, MULTIPOLYGON

The optimized representations of SDO_POINT and RECTANGLE are supported in the following way:

• If the SDO_POINT attribute is present and SDO_ELEM_INFO and SDO_ORDINATES are not, a Point geometry is read. Otherwise, the geometry specified by the latter two attributes is read.
• RECTANGLEs are converted to equivalent Polygons

A GeometryFactory may be provided, otherwise a default one will be used. If a PrecisionModel other than PrecisionModel.FLOATING is supplied it is the client's responsibility to ensure that it matches the precision of the incoming data. If a lower precision for the data is required, a subsequent process must be run on the data to reduce its precision.

The coordinate dimension of the output is determined as follows:

• by default, the coordinate dimension matches that of the input
• the coordinate dimension can be set explicitly by the setDimension(int) method
• finally, the coordinate dimension is limited by the maximum dimension supported by the provided CoordinateSequenceFactory.

The Geometry SRID field is populated from the input Geometry.

To use this class a suitable Oracle JDBC JAR must be present in the classpath.

LIMITATIONS

• Geometries with Measures (XYM or XYZM) can be read, but the Measure values are not preserved
• Oracle geometries with a GTYPE of 43xx (XYMZ) are not supported.
• Geometries containing arcs are not supported
• Surface and solid geometries are not supported
• There is currently no way to read ancillary SDO_POINT information

Author:

Martin Davis

Constructor Summary

Constructors

Constructor and Description
OraReader() Creates a new reader, with a default GeometryFactory.
OraReader(GeometryFactory gf) Creates a new reader, with the supplied GeometryFactory.

Method Summary

Methods

Modifier and Type	Method and Description
int	getDimension() Gets the coordinate dimension which will be created.
Geometry	read(oracle.sql.STRUCT struct) Reads a Geometry representing the MDSYS.GEOMETRY provided in the STRUCT.
void	setDimension(int outputDimension) Sets the coordinate dimension to use for created geometries.

Methods inherited from class java.lang.Object

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

Constructor Detail

OraReader

public OraReader()

Creates a new reader, with a default GeometryFactory.

See Also:

OraReader(GeometryFactory)

OraReader

public OraReader(GeometryFactory gf)

Creates a new reader, with the supplied GeometryFactory. It is assumed that the supplied PrecisionModel matches the precision of the incoming data - coordinates are not made precise when read.

Parameters:

gf - A non-null geometry factory for later use.

Throws:

NullPointerException - when the geometry factory is null.

Method Detail

getDimension

public int getDimension()

Gets the coordinate dimension which will be created.

Returns:

the coordinate dimension which will be created

setDimension

public void setDimension(int outputDimension)

Sets the coordinate dimension to use for created geometries.

Parameters:

outputDimension - the coordinate dimension to create

read

public Geometry read(oracle.sql.STRUCT struct)
              throws SQLException

Reads a Geometry representing the MDSYS.GEOMETRY provided in the STRUCT. The type of geometry created depends on the Geometry type specified within the STRUCT. The SRID of the created geometry is set to be the same as the input SRID.

Parameters:

struct - The MDSYS.GEOMETRY Object to decode

Returns:

the Geometry if one could be created, null otherwise

Throws:

SQLException - if a read error occurs while accessing the struct

IllegalArgumentException - if an unsupported geometry type or encoding error is found