Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.vividsolutions.jts.io.oracle
Class OraWriter

    java.lang.Object
      com.vividsolutions.jts.io.oracle.OraWriter

public class OraWriter
extends java.lang.Object

Translates a JTS Geometry into an Oracle STRUCT representing an MDSYS.GEOMETRY object. A connection to an oracle instance with access to the definition of the MDSYS.GEOMETRY object is required by the oracle driver.

Version:
  9i
Author:
  David Zwiers, Vivid Solutions.

Constructor Summary
`OraWriter(OracleConnection con)` Initialize the Oracle MDSYS.GEOMETRY Encoder with a valid oracle connection.
`OraWriter(OracleConnection con, int dimension)` Initialize the Oracle MDSYS.GEOMETRY Encoder with a valid oracle connection.

Method Summary
`void` | `setDimension(int dimension)`
`void` | `setSRID(int srid)` Provides the oppotunity to force all geometries written using this writter to be written using the specified srid.
`STRUCT` | `write(Geometry geom)` This routine will translate the JTS Geometry into an Oracle MDSYS.GEOMETRY STRUCT.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### OraWriter

    public OraWriter(OracleConnection con)

  Initialize the Oracle MDSYS.GEOMETRY Encoder with a valid oracle connection. The connection should have sufficient priveledges to view the description of the MDSYS.GEOMETRY type. The dimension is set to 2

Parameters:
  `con` -

### OraWriter

    public OraWriter(OracleConnection con,
                     int dimension)

  Initialize the Oracle MDSYS.GEOMETRY Encoder with a valid oracle connection. The connection should have sufficient priveledges to view the description of the MDSYS.GEOMETRY type.

Parameters:
  `con` -
  `dimension` -

Method Detail

### setSRID

    public void setSRID(int srid)

  Provides the oppotunity to force all geometries written using this writter to be written using the specified srid. This is useful in two cases: 1) when you do not want the geometry's srid to be over-written or 2) when you want to ensure an entire layer is always written using a constant srid.

  Parameters:
    `srid` -

### write

    public STRUCT write(Geometry geom)
                 throws java.sql.SQLException

  This routine will translate the JTS Geometry into an Oracle MDSYS.GEOMETRY STRUCT. Although invalid geometries may be encoded, and inserted into an Oracle DB, this is not recomended. It is the responsibility of the user to ensure the geometry is valid prior to calling this method. The user should also ensure the the geometry's SRID field contains the correct value, if an SRID is desired. An incorrect SRID value may cause index exceptions during an insert or update. When a null Geometry is passed in, a non-null, empty STRUCT is returned. Therefore, inserting the the result of calling this method directly into a table will never result in null insertions. (March 2006) To pass a NULL Geometry into an oracle geometry parameter using jdbc, use java.sql.CallableStatement.setNull(index,java.sql.Types.STRUCT,"MDSYS.SDO_GEOMETRY") (April 2006)

  Parameters:
    `geom` - JTS Geometry to encode
  Returns:
    Oracle MDSYS.GEOMETRY STRUCT
  Throws:
    `java.sql.SQLException`

### setDimension

    public void setDimension(int dimension)

  Parameters:
    `dimension` - The dimension to set.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD