oidfidmapper.html

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

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Provides the number of decimal digits for this column. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#getColumnName(int)">getColumnName</A></B>(int&nbsp;colIndex)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the name of the specified column in the primary key</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#getColumnSize(int)">getColumnSize</A></B>(int&nbsp;colIndex)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the size of a primary key column as it would be provided by the
 database metadata. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#getColumnType(int)">getColumnType</A></B>(int&nbsp;colIndex)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the column type by using a constant available in the
 java.sql.Types interface</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#getID(java.lang.Object[])">getID</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;attributes)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the FID given the values of the prymary key attributes</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#getPKAttributes(java.lang.String)">getPKAttributes</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;FID)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Will always return an emtpy array since OIDs are not updatable, 
 so we don't try to parse the Feature ID at all.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#initSupportStructures()">initSupportStructures</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method will be called by JDBCDataStore when creating new tables to
 give the FID mapper an opportunity to initialize needed data
 structures, such as support tables, sequences, and so on.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#isAutoIncrement(int)">isAutoIncrement</A></B>(int&nbsp;colIndex)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns true if the column is of serial type, that is, its value is
 automatically generated by the database if the user does not provide
 one</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/geotools/data/postgis/fidmapper/OIDFidMapper.html#returnFIDColumnsAsAttributes()">returnFIDColumnsAsAttributes</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If true the primary key columns will be returned as attributes. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_AbstractFIDMapper"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html" title="class in org.geotools.data.jdbc.fidmapper">AbstractFIDMapper</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getColumnDecimalDigits()">getColumnDecimalDigits</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getColumnName()">getColumnName</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getColumnSize()">getColumnSize</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getColumnType()">getColumnType</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getTableName()">getTableName</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#getTableSchemaName()">getTableSchemaName</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#hasAutoIncrementColumns()">hasAutoIncrementColumns</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#isAutoIncrement()">isAutoIncrement</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#isVolatile()">isVolatile</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#setInfo(java.lang.String, int, int, int, boolean)">setInfo</A>, <A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#toString()">toString</A></CODE></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#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 =========== -->


<!-- ========= 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="OIDFidMapper()"><!-- --></A><H3>
OIDFidMapper</H3>
<PRE>
public <B>OIDFidMapper</B>()</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="initSupportStructures()"><!-- --></A><H3>
initSupportStructures</H3>
<PRE>
public void <B>initSupportStructures</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html" title="interface in org.geotools.data.jdbc.fidmapper">FIDMapper</A></CODE></B></DD>
<DD>This method will be called by JDBCDataStore when creating new tables to
 give the FID mapper an opportunity to initialize needed data
 structures, such as support tables, sequences, and so on.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html#initSupportStructures()">initSupportStructures</A></CODE> in interface <CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html" title="interface in org.geotools.data.jdbc.fidmapper">FIDMapper</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html#initSupportStructures()">initSupportStructures</A></CODE> in class <CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/AbstractFIDMapper.html" title="class in org.geotools.data.jdbc.fidmapper">AbstractFIDMapper</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html#initSupportStructures()"><CODE>FIDMapper.initSupportStructures()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getID(java.lang.Object[])"><!-- --></A><H3>
getID</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>getID</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;attributes)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html" title="interface in org.geotools.data.jdbc.fidmapper">FIDMapper</A></CODE></B></DD>
<DD>Returns the FID given the values of the prymary key attributes
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>attributes</CODE> - DOCUMENT ME!<DT><B>See Also:</B><DD><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html#getID(java.lang.Object[])"><CODE>FIDMapper.getID(java.lang.Object[])</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getPKAttributes(java.lang.String)"><!-- --></A><H3>
getPKAttributes</H3>
<PRE>
public <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>getPKAttributes</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;FID)
                         throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Will always return an emtpy array since OIDs are not updatable, 
 so we don't try to parse the Feature ID at all.
 Um - this causes failures in SQLEncoder - that may be the place
 to fix it, but I'm putting it in here for now.  I believe that
 the oid will not try to get updated since auto increment
 is set to false.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>FID</CODE> - The feature ID is going to be parsed
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html#getPKAttributes(java.lang.String)"><CODE>FIDMapper.getPKAttributes(java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="createID(java.sql.Connection, org.geotools.feature.Feature, java.sql.Statement)"><!-- --></A><H3>
createID</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>createID</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/Connection.html" title="class or interface in java.sql">Connection</A>&nbsp;conn,
                       <A HREF="../../../../../org/geotools/feature/Feature.html" title="interface in org.geotools.feature">Feature</A>&nbsp;feature,
                       <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/sql/Statement.html" title="class or interface in java.sql">Statement</A>&nbsp;statement)
                throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../../org/geotools/data/jdbc/fidmapper/FIDMapper.html" title="interface in org.geotools.data.jdbc.fidmapper">FIDMapper</A></CODE></B></DD>
<DD>Creates a new ID for a feature. <br>
 This is done either by querying the database (for auto-increment like
 types, for example sequences) or by inspecting the Feature (for
 example, for primary keys with business meaning that whose attributes
 are included in the Feature ones).
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>conn</CODE> - - the database connection<DD><CODE>feature</CODE> - - the feature that needs the new FID<DD><CODE>statement</CODE> - - the statement used to insert the feature into the