wfstransactionstate.html

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

<A NAME="setTransaction(org.geotools.data.Transaction)"><!-- --></A><H3>
setTransaction</H3>
<PRE>
public void <B>setTransaction</B>(<A HREF="../../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A>&nbsp;transaction)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></B></DD>
<DD>Provides configuration information for Transaction.State

 <p>
 setTransaction is called with non null <code>transaction</code> when
 Transaction.State is <code>putState</code> into a Transaction. This
 tranasction will be used to determine correct event notification.
 </p>

 <p>
 setTransaction is called with <code>null</code> when removeState is
 called (usually during Transaction.close() ).
 </p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/geotools/data/Transaction.State.html#setTransaction(org.geotools.data.Transaction)">setTransaction</A></CODE> in interface <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>transaction</CODE> - <DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/data/Transaction.State.html#setTransaction(org.geotools.data.Transaction)"><CODE>Transaction.State.setTransaction(org.geotools.data.Transaction)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="addAuthorization(java.lang.String)"><!-- --></A><H3>
addAuthorization</H3>
<PRE>
public void <B>addAuthorization</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;AuthID)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></B></DD>
<DD>Call back used for Transaction.setAuthorization()
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/geotools/data/Transaction.State.html#addAuthorization(java.lang.String)">addAuthorization</A></CODE> in interface <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/data/Transaction.State.html#addAuthorization(java.lang.String)"><CODE>Transaction.State.addAuthorization(java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getLockId()"><!-- --></A><H3>
getLockId</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>getLockId</B>()</PRE>
<DL>
<DD>Not implemented
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>String</DL>
</DD>
</DL>
<HR>

<A NAME="commit()"><!-- --></A><H3>
commit</H3>
<PRE>
public void <B>commit</B>()
            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/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></B></DD>
<DD>Call back used for Transaction.commit()
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/geotools/data/Transaction.State.html#commit()">commit</A></CODE> in interface <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></DL>
</DD>
<DD><DL>

<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/Transaction.State.html#commit()"><CODE>Transaction.State.commit()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="rollback()"><!-- --></A><H3>
rollback</H3>
<PRE>
public void <B>rollback</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></B></DD>
<DD>Call back used for Transaction.rollback()
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/geotools/data/Transaction.State.html#rollback()">rollback</A></CODE> in interface <CODE><A HREF="../../../../org/geotools/data/Transaction.State.html" title="interface in org.geotools.data">Transaction.State</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/data/Transaction.State.html#rollback()"><CODE>Transaction.State.rollback()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getFids(java.lang.String)"><!-- --></A><H3>
getFids</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>getFids</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;typeName)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Fid Set</DL>
</DD>
</DL>
<HR>

<A NAME="addAction(java.lang.String, org.geotools.data.wfs.Action)"><!-- --></A><H3>
addAction</H3>
<PRE>
public void <B>addAction</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;typeName,
                      <A HREF="../../../../org/geotools/data/wfs/Action.html" title="interface in org.geotools.data.wfs">Action</A>&nbsp;a)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>a</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="getActions(java.lang.String)"><!-- --></A><H3>
getActions</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html" title="class or interface in java.util">List</A> <B>getActions</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;typeName)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>List of Actions</DL>
</DD>
</DL>
<HR>

<A NAME="getAllActions()"><!-- --></A><H3>
getAllActions</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html" title="class or interface in java.util">List</A> <B>getAllActions</B>()</PRE>
<DL>
<DD>Returns all the actions for all FeatureTypes
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>all the actions for all FeatureTypes</DL>
</DD>
</DL>
<HR>

<A NAME="combineActions()"><!-- --></A><H3>
combineActions</H3>
<PRE>
protected void <B>combineActions</B>()</PRE>
<DL>
<DD>Combines updates and inserts reducing the number of actions in the commit.
 <p>
 This is in response to an issue where the FID is not known until after the commit so if a
 Feature is inserted then later updated(using a FID filter to identify the feature to update)
 within a single transactin then the commit will fail because the fid filter will be not apply
 once the insert action is processed.
 </p>
 <p>
 For Example:
 <ol>
 <li>Insert Feature.
 <p>
 Transaction assigns it the id: NewFeature.
 </p>
 </li>
 <li>Update Feature.
 <p>
 Fid filter is used to update NewFeature.
 </p>
 </li>
 <li>Commit.
 <p>
 Update will fail because when the Insert action is processed NewFeature will not refer to any
 feature.
 </p>
 </li>
 </ol>
 </p>
 <p>
 The algorithm is essentially foreach( insertAction ){ Apply each update and Delete action
 that applies to the inserted feature move insertAction to end of list }
 </p>
 <p>
 Mind you this only works assuming there aren't any direct dependencies between the actions
 beyond the ones specified by the API. For example if the value of an update depends directly
 on an earlier feature object (which is bad practice and should never be done). Then we may
 have problems with this solution. But I think that this solution is better than doing nothing
 because at least in the proper use of the API the correct result will be obtained. Whereas
 before the correct use of the API could obtain incorrect results.
 </p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="nextFid(java.lang.String)"><!-- --></A><H3>
nextFid</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>nextFid</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;typeName)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/WFSTransactionState.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/geotools/data/wfs/WFSTransactionAccessor.html" title="class in org.geotools.data.wfs"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="WFSTransactionState.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
Copyright &copy; 1996-2007 <a href="http://www.geotools.org">Geotools</a>. All Rights Reserved.
</BODY>
</HTML>