1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.5.0) on Thu May 15 17:17:32 EDT 2008 --> 6<TITLE> 7StoredIterator (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="keywords" CONTENT="com.sleepycat.collections.StoredIterator class"> 11 12<LINK REL ="stylesheet" TYPE="text/css" HREF="/style.css" TITLE="Style"> 13 14<SCRIPT type="text/javascript"> 15function windowTitle() 16{ 17 parent.document.title="StoredIterator (Oracle - Berkeley DB Java API)"; 18} 19</SCRIPT> 20<NOSCRIPT> 21</NOSCRIPT> 22 23</HEAD> 24 25<BODY BGCOLOR="white" onload="windowTitle();"> 26 27 28<!-- ========= START OF TOP NAVBAR ======= --> 29<A NAME="navbar_top"><!-- --></A> 30<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 31<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 32<TR> 33<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 34<A NAME="navbar_top_firstrow"><!-- --></A> 35<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 36 <TR ALIGN="center" VALIGN="top"> 37 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 39 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/StoredIterator.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 45 </TR> 46</TABLE> 47</TD> 48<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 49<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 50</TD> 51</TR> 52 53<TR> 54<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 55 <A HREF="/com/sleepycat/collections/StoredEntrySet.html" title="class in com.sleepycat.collections"><B>PREV CLASS</B></A> 56 <A HREF="/com/sleepycat/collections/StoredKeySet.html" title="class in com.sleepycat.collections"><B>NEXT CLASS</B></A></FONT></TD> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="/index.html?com/sleepycat/collections/StoredIterator.html" target="_top"><B>FRAMES</B></A> 59 <A HREF="StoredIterator.html" target="_top"><B>NO FRAMES</B></A> 60 <SCRIPT type="text/javascript"> 61 <!-- 62 if(window==top) { 63 document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>'); 64 } 65 //--> 66</SCRIPT> 67<NOSCRIPT> 68 <A HREF="/allclasses-noframe.html"><B>All Classes</B></A> 69</NOSCRIPT> 70 71 72</FONT></TD> 73</TR> 74<TR> 75<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 76 SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> 77<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 78DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD> 79</TR> 80</TABLE> 81<A NAME="skip-navbar_top"></A> 82<!-- ========= END OF TOP NAVBAR ========= --> 83 84<HR> 85<!-- ======== START OF CLASS DATA ======== --> 86<H2> 87<FONT SIZE="-1"> 88com.sleepycat.collections</FONT> 89<BR> 90Class StoredIterator</H2> 91<PRE> 92<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A> 93 <IMG SRC="/resources/inherit.gif" ALT="extended by "><B>com.sleepycat.collections.StoredIterator</B> 94</PRE> 95<DL> 96<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A></DD> 97</DL> 98<HR> 99<DL> 100<DT><PRE>public class <B>StoredIterator</B><DT>extends <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A></DL> 101</PRE> 102 103<P> 104The Iterator returned by all stored collections. 105 106 <p>While in general this class conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util"><CODE>Iterator</CODE></A> interface, 107 it is important to note that all iterators for stored collections must be 108 explicitly closed with <A HREF="/com/sleepycat/collections/StoredIterator.html#close()"><CODE>close()</CODE></A>. The static method <A HREF="/com/sleepycat/collections/StoredIterator.html#close(java.util.Iterator)"><CODE>close(java.util.Iterator)</CODE></A> allows calling close for all iterators without 109 harm to iterators that are not from stored collections, and also avoids 110 casting. If a stored iterator is not closed, unpredictable behavior 111 including process death may result.</p> 112 113 <p>This class implements the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util"><CODE>Iterator</CODE></A> interface for all stored 114 iterators. It also implements <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util"><CODE>ListIterator</CODE></A> because some list 115 iterator methods apply to all stored iterators, for example, <A HREF="/com/sleepycat/collections/StoredIterator.html#previous()"><CODE>previous()</CODE></A> and <A HREF="/com/sleepycat/collections/StoredIterator.html#hasPrevious()"><CODE>hasPrevious()</CODE></A>. Other list iterator methods are always 116 supported for lists, but for other types of collections are only supported 117 under certain conditions. See <A HREF="/com/sleepycat/collections/StoredIterator.html#nextIndex()"><CODE>nextIndex()</CODE></A>, <A HREF="/com/sleepycat/collections/StoredIterator.html#previousIndex()"><CODE>previousIndex()</CODE></A>, 118 <A HREF="/com/sleepycat/collections/StoredIterator.html#add(java.lang.Object)"><CODE>add(java.lang.Object)</CODE></A> and <A HREF="/com/sleepycat/collections/StoredIterator.html#set(java.lang.Object)"><CODE>set(java.lang.Object)</CODE></A> for details.</p> 119 120 <p>In addition, this class provides the following methods for stored 121 collection iterators only. Note that the use of these methods is not 122 compatible with the standard Java collections interface.</p> 123 <ul> 124 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#close()"><CODE>close()</CODE></A></li> 125 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#close(java.util.Iterator)"><CODE>close(Iterator)</CODE></A></li> 126 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#count()"><CODE>count()</CODE></A></li> 127 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#getCollection()"><CODE>getCollection()</CODE></A></li> 128 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#setReadModifyWrite(boolean)"><CODE>setReadModifyWrite(boolean)</CODE></A></li> 129 <li><A HREF="/com/sleepycat/collections/StoredIterator.html#isReadModifyWrite()"><CODE>isReadModifyWrite()</CODE></A></li> 130 </ul> 131<P> 132 133<P> 134<HR> 135 136<P> 137 138<!-- ========== METHOD SUMMARY =========== --> 139 140<A NAME="method_summary"><!-- --></A> 141<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 142<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 143<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 144<B>Method Summary</B></FONT></TH> 145</TR> 146<TR BGCOLOR="white" CLASS="TableRowColor"> 147<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 148<CODE> void</CODE></FONT></TD> 149<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#add(java.lang.Object)">add</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> value)</CODE> 150 151<BR> 152 Inserts the specified element into the list or inserts a duplicate into 153 other types of collections (optional operation).</TD> 154</TR> 155<TR BGCOLOR="white" CLASS="TableRowColor"> 156<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 157<CODE> void</CODE></FONT></TD> 158<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#close()">close</A></B>()</CODE> 159 160<BR> 161 Closes this iterator.</TD> 162</TR> 163<TR BGCOLOR="white" CLASS="TableRowColor"> 164<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 165<CODE>static void</CODE></FONT></TD> 166<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#close(java.util.Iterator)">close</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A> i)</CODE> 167 168<BR> 169 Closes the given iterator using <A HREF="/com/sleepycat/collections/StoredIterator.html#close()"><CODE>close()</CODE></A> if it is a <A HREF="/com/sleepycat/collections/StoredIterator.html" title="class in com.sleepycat.collections"><CODE>StoredIterator</CODE></A>.</TD> 170</TR> 171<TR BGCOLOR="white" CLASS="TableRowColor"> 172<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 173<CODE> int</CODE></FONT></TD> 174<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#count()">count</A></B>()</CODE> 175 176<BR> 177 Returns the number of elements having the same key value as the key 178 value of the element last returned by next() or previous().</TD> 179</TR> 180<TR BGCOLOR="white" CLASS="TableRowColor"> 181<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 182<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util">ListIterator</A></CODE></FONT></TD> 183<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#dup()">dup</A></B>()</CODE> 184 185<BR> 186 Duplicate a cursor.</TD> 187</TR> 188<TR BGCOLOR="white" CLASS="TableRowColor"> 189<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 190<CODE> <A HREF="/com/sleepycat/collections/StoredCollection.html" title="class in com.sleepycat.collections">StoredCollection</A></CODE></FONT></TD> 191<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#getCollection()">getCollection</A></B>()</CODE> 192 193<BR> 194 Returns the collection associated with this iterator.</TD> 195</TR> 196<TR BGCOLOR="white" CLASS="TableRowColor"> 197<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 198<CODE> boolean</CODE></FONT></TD> 199<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#hasNext()">hasNext</A></B>()</CODE> 200 201<BR> 202 Returns true if this iterator has more elements when traversing in the 203 forward direction.</TD> 204</TR> 205<TR BGCOLOR="white" CLASS="TableRowColor"> 206<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 207<CODE> boolean</CODE></FONT></TD> 208<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#hasPrevious()">hasPrevious</A></B>()</CODE> 209 210<BR> 211 Returns true if this iterator has more elements when traversing in the 212 reverse direction.</TD> 213</TR> 214<TR BGCOLOR="white" CLASS="TableRowColor"> 215<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 216<CODE> boolean</CODE></FONT></TD> 217<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#isCurrentData(java.lang.Object)">isCurrentData</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> currentData)</CODE> 218 219<BR> 220 Returns whether the given data is the current iterator data.</TD> 221</TR> 222<TR BGCOLOR="white" CLASS="TableRowColor"> 223<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 224<CODE> boolean</CODE></FONT></TD> 225<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#isReadModifyWrite()">isReadModifyWrite</A></B>()</CODE> 226 227<BR> 228 Returns whether write-locks will be obtained when reading with this 229 cursor.</TD> 230</TR> 231<TR BGCOLOR="white" CLASS="TableRowColor"> 232<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 233<CODE> boolean</CODE></FONT></TD> 234<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#moveToIndex(int)">moveToIndex</A></B>(int index)</CODE> 235 236<BR> 237 Initializes a list iterator at the given index.</TD> 238</TR> 239<TR BGCOLOR="white" CLASS="TableRowColor"> 240<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 241<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD> 242<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#next()">next</A></B>()</CODE> 243 244<BR> 245 Returns the next element in the iteration.</TD> 246</TR> 247<TR BGCOLOR="white" CLASS="TableRowColor"> 248<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 249<CODE> int</CODE></FONT></TD> 250<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#nextIndex()">nextIndex</A></B>()</CODE> 251 252<BR> 253 Returns the index of the element that would be returned by a subsequent 254 call to next.</TD> 255</TR> 256<TR BGCOLOR="white" CLASS="TableRowColor"> 257<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 258<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD> 259<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#previous()">previous</A></B>()</CODE> 260 261<BR> 262 Returns the next element in the iteration.</TD> 263</TR> 264<TR BGCOLOR="white" CLASS="TableRowColor"> 265<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 266<CODE> int</CODE></FONT></TD> 267<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#previousIndex()">previousIndex</A></B>()</CODE> 268 269<BR> 270 Returns the index of the element that would be returned by a subsequent 271 call to previous.</TD> 272</TR> 273<TR BGCOLOR="white" CLASS="TableRowColor"> 274<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 275<CODE> void</CODE></FONT></TD> 276<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#remove()">remove</A></B>()</CODE> 277 278<BR> 279 Removes the last element that was returned by next or previous (optional 280 operation).</TD> 281</TR> 282<TR BGCOLOR="white" CLASS="TableRowColor"> 283<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 284<CODE> void</CODE></FONT></TD> 285<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#set(java.lang.Object)">set</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> value)</CODE> 286 287<BR> 288 Replaces the last element returned by next or previous with the 289 specified element (optional operation).</TD> 290</TR> 291<TR BGCOLOR="white" CLASS="TableRowColor"> 292<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 293<CODE> void</CODE></FONT></TD> 294<TD><CODE><B><A HREF="/com/sleepycat/collections/StoredIterator.html#setReadModifyWrite(boolean)">setReadModifyWrite</A></B>(boolean lockForWrite)</CODE> 295 296<BR> 297 Changes whether write-locks will be obtained when reading with this 298 cursor.</TD> 299</TR> 300</TABLE> 301 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> 302<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 303<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 304<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH> 305</TR> 306<TR BGCOLOR="white" CLASS="TableRowColor"> 307<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.5.0/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.5.0/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/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.5.0/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> 308</TR> 309</TABLE> 310 311<P> 312 313<!-- ============ METHOD DETAIL ========== --> 314 315<A NAME="method_detail"><!-- --></A> 316<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 317<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 318<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 319<B>Method Detail</B></FONT></TH> 320</TR> 321</TABLE> 322 323<A NAME="close(java.util.Iterator)"><!-- --></A><H3> 324close</H3> 325<PRE> 326public static void <B>close</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A> i)</PRE> 327<DL> 328<DD>Closes the given iterator using <A HREF="/com/sleepycat/collections/StoredIterator.html#close()"><CODE>close()</CODE></A> if it is a <A HREF="/com/sleepycat/collections/StoredIterator.html" title="class in com.sleepycat.collections"><CODE>StoredIterator</CODE></A>. If the given iterator is not a <A HREF="/com/sleepycat/collections/StoredIterator.html" title="class in com.sleepycat.collections"><CODE>StoredIterator</CODE></A>, 329 this method does nothing. 330<P> 331<DD><DL> 332</DL> 333</DD> 334<DD><DL> 335<DT><B>Parameters:</B><DD><CODE>i</CODE> - is the iterator to close. 336<DT><B>Throws:</B> 337<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 338</DD> 339</DL> 340<HR> 341 342<A NAME="isReadModifyWrite()"><!-- --></A><H3> 343isReadModifyWrite</H3> 344<PRE> 345public final boolean <B>isReadModifyWrite</B>()</PRE> 346<DL> 347<DD>Returns whether write-locks will be obtained when reading with this 348 cursor. 349 Obtaining write-locks can prevent deadlocks when reading and then 350 modifying data. 351<P> 352<DD><DL> 353</DL> 354</DD> 355<DD><DL> 356 357<DT><B>Returns:</B><DD>the write-lock setting.</DL> 358</DD> 359</DL> 360<HR> 361 362<A NAME="setReadModifyWrite(boolean)"><!-- --></A><H3> 363setReadModifyWrite</H3> 364<PRE> 365public void <B>setReadModifyWrite</B>(boolean lockForWrite)</PRE> 366<DL> 367<DD>Changes whether write-locks will be obtained when reading with this 368 cursor. 369 Obtaining write-locks can prevent deadlocks when reading and then 370 modifying data. 371<P> 372<DD><DL> 373</DL> 374</DD> 375<DD><DL> 376<DT><B>Parameters:</B><DD><CODE>lockForWrite</CODE> - the write-lock setting.</DL> 377</DD> 378</DL> 379<HR> 380 381<A NAME="hasNext()"><!-- --></A><H3> 382hasNext</H3> 383<PRE> 384public boolean <B>hasNext</B>()</PRE> 385<DL> 386<DD>Returns true if this iterator has more elements when traversing in the 387 forward direction. False is returned if the iterator has been closed. 388 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html#hasNext()" title="class or interface in java.util"><CODE>Iterator.hasNext()</CODE></A> interface. 389<P> 390<DD><DL> 391</DL> 392</DD> 393<DD><DL> 394 395<DT><B>Returns:</B><DD>whether <A HREF="/com/sleepycat/collections/StoredIterator.html#next()"><CODE>next()</CODE></A> will succeed. 396<DT><B>Throws:</B> 397<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 398</DD> 399</DL> 400<HR> 401 402<A NAME="hasPrevious()"><!-- --></A><H3> 403hasPrevious</H3> 404<PRE> 405public boolean <B>hasPrevious</B>()</PRE> 406<DL> 407<DD>Returns true if this iterator has more elements when traversing in the 408 reverse direction. It returns false if the iterator has been closed. 409 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#hasPrevious()" title="class or interface in java.util"><CODE>ListIterator.hasPrevious()</CODE></A> interface. 410<P> 411<DD><DL> 412</DL> 413</DD> 414<DD><DL> 415 416<DT><B>Returns:</B><DD>whether <A HREF="/com/sleepycat/collections/StoredIterator.html#previous()"><CODE>previous()</CODE></A> will succeed. 417<DT><B>Throws:</B> 418<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is thrown.</DL> 419</DD> 420</DL> 421<HR> 422 423<A NAME="next()"><!-- --></A><H3> 424next</H3> 425<PRE> 426public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>next</B>()</PRE> 427<DL> 428<DD>Returns the next element in the iteration. 429 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html#next()" title="class or interface in java.util"><CODE>Iterator.next()</CODE></A> interface. 430<P> 431<DD><DL> 432</DL> 433</DD> 434<DD><DL> 435 436<DT><B>Returns:</B><DD>the next element. 437<DT><B>Throws:</B> 438<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 439 thrown.</DL> 440</DD> 441</DL> 442<HR> 443 444<A NAME="previous()"><!-- --></A><H3> 445previous</H3> 446<PRE> 447public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>previous</B>()</PRE> 448<DL> 449<DD>Returns the next element in the iteration. 450 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#previous()" title="class or interface in java.util"><CODE>ListIterator.previous()</CODE></A> interface. 451<P> 452<DD><DL> 453</DL> 454</DD> 455<DD><DL> 456 457<DT><B>Returns:</B><DD>the previous element. 458<DT><B>Throws:</B> 459<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 460 thrown.</DL> 461</DD> 462</DL> 463<HR> 464 465<A NAME="nextIndex()"><!-- --></A><H3> 466nextIndex</H3> 467<PRE> 468public int <B>nextIndex</B>()</PRE> 469<DL> 470<DD>Returns the index of the element that would be returned by a subsequent 471 call to next. 472 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#nextIndex()" title="class or interface in java.util"><CODE>ListIterator.nextIndex()</CODE></A> interface 473 except that it returns Integer.MAX_VALUE for stored lists when 474 positioned at the end of the list, rather than returning the list size 475 as specified by the ListIterator interface. This is because the database 476 size is not available. 477<P> 478<DD><DL> 479</DL> 480</DD> 481<DD><DL> 482 483<DT><B>Returns:</B><DD>the next index. 484<DT><B>Throws:</B> 485<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if this iterator's collection does 486 not use record number keys. 487<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 488 thrown.</DL> 489</DD> 490</DL> 491<HR> 492 493<A NAME="previousIndex()"><!-- --></A><H3> 494previousIndex</H3> 495<PRE> 496public int <B>previousIndex</B>()</PRE> 497<DL> 498<DD>Returns the index of the element that would be returned by a subsequent 499 call to previous. 500 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#previousIndex()" title="class or interface in java.util"><CODE>ListIterator.previousIndex()</CODE></A> 501 interface. 502<P> 503<DD><DL> 504</DL> 505</DD> 506<DD><DL> 507 508<DT><B>Returns:</B><DD>the previous index. 509<DT><B>Throws:</B> 510<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if this iterator's collection does 511 not use record number keys. 512<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 513 thrown.</DL> 514</DD> 515</DL> 516<HR> 517 518<A NAME="set(java.lang.Object)"><!-- --></A><H3> 519set</H3> 520<PRE> 521public void <B>set</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> value)</PRE> 522<DL> 523<DD>Replaces the last element returned by next or previous with the 524 specified element (optional operation). 525 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#set(E)" title="class or interface in java.util"><CODE>ListIterator.set(E)</CODE></A> interface. 526 527 <p>In order to call this method, if the underlying Database is 528 transactional then a transaction must be active when creating the 529 iterator.</p> 530<P> 531<DD><DL> 532</DL> 533</DD> 534<DD><DL> 535<DT><B>Parameters:</B><DD><CODE>value</CODE> - the new value. 536<DT><B>Throws:</B> 537<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is a <A HREF="/com/sleepycat/collections/StoredKeySet.html" title="class in com.sleepycat.collections"><CODE>StoredKeySet</CODE></A> (the set returned by <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Map.html#keySet()" title="class or interface in java.util"><CODE>Map.keySet()</CODE></A>), or if 538 duplicates are sorted since this would change the iterator position, or 539 if the collection is indexed, or if the collection is read-only. 540<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an entity value binding is used and 541 the primary key of the value given is different than the existing stored 542 primary key. 543<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 544 thrown.</DL> 545</DD> 546</DL> 547<HR> 548 549<A NAME="remove()"><!-- --></A><H3> 550remove</H3> 551<PRE> 552public void <B>remove</B>()</PRE> 553<DL> 554<DD>Removes the last element that was returned by next or previous (optional 555 operation). 556 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#remove()" title="class or interface in java.util"><CODE>ListIterator.remove()</CODE></A> interface except 557 that when the collection is a list and the RECNO-RENUMBER access method 558 is not used, list indices will not be renumbered. 559 560 <p>In order to call this method, if the underlying Database is 561 transactional then a transaction must be active when creating the 562 iterator.</p> 563 564 <p>Note that for the JE product, RECNO-RENUMBER databases are not 565 supported, and therefore list indices are never renumbered by this 566 method.</p> 567<P> 568<DD><DL> 569</DL> 570</DD> 571<DD><DL> 572 573<DT><B>Throws:</B> 574<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is a sublist, or 575 if the collection is read-only. 576<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 577 thrown.</DL> 578</DD> 579</DL> 580<HR> 581 582<A NAME="add(java.lang.Object)"><!-- --></A><H3> 583add</H3> 584<PRE> 585public void <B>add</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> value)</PRE> 586<DL> 587<DD>Inserts the specified element into the list or inserts a duplicate into 588 other types of collections (optional operation). 589 This method conforms to the <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html#add(E)" title="class or interface in java.util"><CODE>ListIterator.add(E)</CODE></A> interface when 590 the collection is a list and the RECNO-RENUMBER access method is used. 591 Otherwise, this method may only be called when duplicates are allowed. 592 If duplicates are unsorted, the new value will be inserted in the same 593 manner as list elements. 594 If duplicates are sorted, the new value will be inserted in sort order. 595 596 <p>Note that for the JE product, RECNO-RENUMBER databases are not 597 supported, and therefore this method may only be used to add 598 duplicates.</p> 599<P> 600<DD><DL> 601</DL> 602</DD> 603<DD><DL> 604<DT><B>Parameters:</B><DD><CODE>value</CODE> - the new value. 605<DT><B>Throws:</B> 606<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the collection is a sublist, or 607 if the collection is indexed, or if the collection is read-only, or if 608 the collection is a list and the RECNO-RENUMBER access method was not 609 used, or if the collection is not a list and duplicates are not allowed. 610<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if the collection is empty and is not a 611 list with RECNO-RENUMBER access. 612<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if a duplicate value is being added 613 that already exists and duplicates are sorted. 614<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 615 thrown.</DL> 616</DD> 617</DL> 618<HR> 619 620<A NAME="count()"><!-- --></A><H3> 621count</H3> 622<PRE> 623public int <B>count</B>()</PRE> 624<DL> 625<DD>Returns the number of elements having the same key value as the key 626 value of the element last returned by next() or previous(). If no 627 duplicates are allowed, 1 is always returned. 628 This method does not exist in the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util"><CODE>Iterator</CODE></A> or <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util"><CODE>ListIterator</CODE></A> interfaces. 629<P> 630<DD><DL> 631</DL> 632</DD> 633<DD><DL> 634 635<DT><B>Returns:</B><DD>the number of duplicates. 636<DT><B>Throws:</B> 637<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if next() or previous() has not been 638 called for this iterator, or if remove() or add() were called after 639 the last call to next() or previous().</DL> 640</DD> 641</DL> 642<HR> 643 644<A NAME="close()"><!-- --></A><H3> 645close</H3> 646<PRE> 647public void <B>close</B>()</PRE> 648<DL> 649<DD>Closes this iterator. 650 This method does not exist in the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util"><CODE>Iterator</CODE></A> or <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util"><CODE>ListIterator</CODE></A> interfaces. 651 652 <p>After being closed, only the <A HREF="/com/sleepycat/collections/StoredIterator.html#hasNext()"><CODE>hasNext()</CODE></A> and <A HREF="/com/sleepycat/collections/StoredIterator.html#hasPrevious()"><CODE>hasPrevious()</CODE></A> methods may be called and these will return false. <A HREF="/com/sleepycat/collections/StoredIterator.html#close()"><CODE>close()</CODE></A> may also be called again and will do nothing. If other 653 methods are called a <code>NullPointerException</code> will generally be 654 thrown.</p> 655<P> 656<DD><DL> 657</DL> 658</DD> 659<DD><DL> 660 661<DT><B>Throws:</B> 662<DD><CODE><A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util">RuntimeExceptionWrapper</A></CODE> - if a <A HREF="/com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> is 663 thrown.</DL> 664</DD> 665</DL> 666<HR> 667 668<A NAME="getCollection()"><!-- --></A><H3> 669getCollection</H3> 670<PRE> 671public final <A HREF="/com/sleepycat/collections/StoredCollection.html" title="class in com.sleepycat.collections">StoredCollection</A> <B>getCollection</B>()</PRE> 672<DL> 673<DD>Returns the collection associated with this iterator. 674 This method does not exist in the standard <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Iterator.html" title="class or interface in java.util"><CODE>Iterator</CODE></A> or <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util"><CODE>ListIterator</CODE></A> interfaces. 675<P> 676<DD><DL> 677</DL> 678</DD> 679<DD><DL> 680 681<DT><B>Returns:</B><DD>the collection associated with this iterator.</DL> 682</DD> 683</DL> 684<HR> 685 686<A NAME="dup()"><!-- --></A><H3> 687dup</H3> 688<PRE> 689public final <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/ListIterator.html" title="class or interface in java.util">ListIterator</A> <B>dup</B>()</PRE> 690<DL> 691<DD>Duplicate a cursor. Called by StoredCollections.iterator. 692<P> 693<DD><DL> 694</DL> 695</DD> 696<DD><DL> 697</DL> 698</DD> 699</DL> 700<HR> 701 702<A NAME="isCurrentData(java.lang.Object)"><!-- --></A><H3> 703isCurrentData</H3> 704<PRE> 705public final boolean <B>isCurrentData</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> currentData)</PRE> 706<DL> 707<DD>Returns whether the given data is the current iterator data. Called by 708 StoredMapEntry.setValue. 709<P> 710<DD><DL> 711</DL> 712</DD> 713<DD><DL> 714</DL> 715</DD> 716</DL> 717<HR> 718 719<A NAME="moveToIndex(int)"><!-- --></A><H3> 720moveToIndex</H3> 721<PRE> 722public final boolean <B>moveToIndex</B>(int index)</PRE> 723<DL> 724<DD>Initializes a list iterator at the given index. Called by 725 StoredList.iterator(int). 726<P> 727<DD><DL> 728</DL> 729</DD> 730<DD><DL> 731</DL> 732</DD> 733</DL> 734<!-- ========= END OF CLASS DATA ========= --> 735<HR> 736 737 738<!-- ======= START OF BOTTOM NAVBAR ====== --> 739<A NAME="navbar_bottom"><!-- --></A> 740<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 741<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 742<TR> 743<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 744<A NAME="navbar_bottom_firstrow"><!-- --></A> 745<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 746 <TR ALIGN="center" VALIGN="top"> 747 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 748 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 749 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 750 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/StoredIterator.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 751 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 752 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 753 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 754 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 755 </TR> 756</TABLE> 757</TD> 758<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 759<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 760</TD> 761</TR> 762 763<TR> 764<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 765 <A HREF="/com/sleepycat/collections/StoredEntrySet.html" title="class in com.sleepycat.collections"><B>PREV CLASS</B></A> 766 <A HREF="/com/sleepycat/collections/StoredKeySet.html" title="class in com.sleepycat.collections"><B>NEXT CLASS</B></A></FONT></TD> 767<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 768 <A HREF="/index.html?com/sleepycat/collections/StoredIterator.html" target="_top"><B>FRAMES</B></A> 769 <A HREF="StoredIterator.html" target="_top"><B>NO FRAMES</B></A> 770 <SCRIPT type="text/javascript"> 771 <!-- 772 if(window==top) { 773 document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>'); 774 } 775 //--> 776</SCRIPT> 777<NOSCRIPT> 778 <A HREF="/allclasses-noframe.html"><B>All Classes</B></A> 779</NOSCRIPT> 780 781 782</FONT></TD> 783</TR> 784<TR> 785<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 786 SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> 787<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 788DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD> 789</TR> 790</TABLE> 791<A NAME="skip-navbar_bottom"></A> 792<!-- ======== END OF BOTTOM NAVBAR ======= --> 793 794<HR> 795<font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 796</BODY> 797</HTML> 798
