geometryconverter.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;ARRAY</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toARRAY(int[], java.lang.String)">toARRAY</A></B>(int[]&nbsp;ints,
        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;dataType)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for ARRAY construction.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;ARRAY</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toATTRIBUTE(double[], java.lang.String)">toATTRIBUTE</A></B>(double[]&nbsp;ords,
            <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;desc)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;CHAR</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toCHAR(java.lang.String)">toCHAR</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for CHAR construction</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;NUMBER</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toNUMBER(double)">toNUMBER</A></B>(double&nbsp;number)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for NUMBER construction.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;NUMBER</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toNUMBER(int)">toNUMBER</A></B>(int&nbsp;number)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for NUMBER construction</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;ARRAY</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toORDINATE(com.vividsolutions.jts.geom.CoordinateList, double[][], int)">toORDINATE</A></B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/CoordinateList.html" title="class or interface in com.vividsolutions.jts.geom">CoordinateList</A>&nbsp;list,
           double[][]&nbsp;measures,
           int&nbsp;D)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for ARRAY construction.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;ARRAY</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toORDINATE(double[])">toORDINATE</A></B>(double[]&nbsp;ords)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;STRUCT</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toSDO(com.vividsolutions.jts.geom.Geometry)">toSDO</A></B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Used to convert double[] to SDO_ODINATE_ARRAY.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;STRUCT</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/oracle/sdo/GeometryConverter.html#toSTRUCT(oracle.sql.Datum[], java.lang.String)">toSTRUCT</A></B>(Datum[]&nbsp;attributes,
         <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;dataType)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convience method for STRUCT construction.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="connection"><!-- --></A><H3>
connection</H3>
<PRE>
protected OracleConnection <B>connection</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>

<A NAME="DATATYPE"><!-- --></A><H3>
DATATYPE</H3>
<PRE>
public static final <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>DATATYPE</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#org.geotools.data.oracle.sdo.GeometryConverter.DATATYPE">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="GeometryConverter(oracle.jdbc.OracleConnection)"><!-- --></A><H3>
GeometryConverter</H3>
<PRE>
public <B>GeometryConverter</B>(OracleConnection&nbsp;connection)</PRE>
<DL>
</DL>
<HR>

<A NAME="GeometryConverter(oracle.jdbc.OracleConnection, com.vividsolutions.jts.geom.GeometryFactory)"><!-- --></A><H3>
GeometryConverter</H3>
<PRE>
public <B>GeometryConverter</B>(OracleConnection&nbsp;connection,
                         <A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/GeometryFactory.html" title="class or interface in com.vividsolutions.jts.geom">GeometryFactory</A>&nbsp;geometryFactory)</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getDataTypeName()"><!-- --></A><H3>
getDataTypeName</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getDataTypeName</B>()</PRE>
<DL>
<DD>Used to handle MDSYS.SDO_GEOMETRY.
<P>
<DD><DL>

<DT><B>Returns:</B><DD><code>MDSYS.SDO_GEOMETRY</code><DT><B>See Also:</B><DD><CODE>net.refractions.jspatial.Converter#getDataType()</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="isCapable(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
isCapable</H3>
<PRE>
public boolean <B>isCapable</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Ensure that obj is a JTS Geometry (2D or 3D) with no LRS measures.
 <p>
 This Converter does not support SpatialCoordinates</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - the Geometry to be converted
<DT><B>Returns:</B><DD><code>true</code> if <code>obj</code> is a JTS Geometry<DT><B>See Also:</B><DD><CODE>net.refractions.jspatial.Converter#isCapable(java.lang.Object)</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="asGeometry(oracle.sql.STRUCT)"><!-- --></A><H3>
asGeometry</H3>
<PRE>
public <A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A> <B>asGeometry</B>(STRUCT&nbsp;sdoGeometry)
                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Convert provided SDO_GEOMETRY to JTS Geometry.
 <p>
 Will return <code>null</code> as <code>null</code>.
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sdoGeometry</CODE> - datum STRUCT to be converted to a double[]
<DT><B>Returns:</B><DD>JTS <code>Geometry</code> representing the provided <code>datum</code>
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></CODE><DT><B>See Also:</B><DD><CODE>net.refractions.jspatial.Converter#toObject(oracle.sql.STRUCT)</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="toSDO(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
toSDO</H3>
<PRE>
public STRUCT <B>toSDO</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)
                        throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Used to convert double[] to SDO_ODINATE_ARRAY.
 <p>
 Will return <code>null</code> as an empty <code>SDO_GEOMETRY</code></p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - Map to be represented as a STRUCT
<DT><B>Returns:</B><DD>STRUCT representing provided Map
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></CODE><DT><B>See Also:</B><DD><CODE>net.refractions.jspatial.Converter#toDataType(java.lang.Object)</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="asEmptyDataType()"><!-- --></A><H3>
asEmptyDataType</H3>
<PRE>
protected STRUCT <B>asEmptyDataType</B>()
                                     throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Representation of <code>null</code> as an Empty <code>SDO_GEOMETRY</code>.
<P>
<DD><DL>

<DT><B>Returns:</B><DD><code>null</code> as a SDO_GEOMETRY
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="toSTRUCT(oracle.sql.Datum[], java.lang.String)"><!-- --></A><H3>
toSTRUCT</H3>
<PRE>
protected final STRUCT <B>toSTRUCT</B>(Datum[]&nbsp;attributes,
                                <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;dataType)
                                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Convience method for STRUCT construction.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="toARRAY(double[], java.lang.String)"><!-- --></A><H3>
toARRAY</H3>
<PRE>
protected final ARRAY <B>toARRAY</B>(double[]&nbsp;doubles,
                              <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;dataType)
                                  throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Convience method for ARRAY construction.
 <p>
 Compare and contrast with toORDINATE - which treats <code>Double.NaN</code>
 as<code>NULL</code></p>
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="toORDINATE(com.vividsolutions.jts.geom.CoordinateList, double[][], int)"><!-- --></A><H3>
toORDINATE</H3>
<PRE>
protected final ARRAY <B>toORDINATE</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/CoordinateList.html" title="class or interface in com.vividsolutions.jts.geom">CoordinateList</A>&nbsp;list,
                                 double[][]&nbsp;measures,
                                 int&nbsp;D)
                                     throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/SQLException.html" title="class or interface in java.sql">SQLException</A></PRE>
<DL>
<DD>Convience method for ARRAY construction.
 <p>
 Forced to burn memory here - only way to actually place
 <code>NULL</code> numbers in the ordinate stream.</p>
 <ul>
 <li>JTS: records lack of data as <code>Double.NaN</code></li>
 <li>SDO: records lack of data as <code>NULL</code></li>
 </ul>