<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!-- NewPage --> <html lang="en"> <head> <!-- Generated by javadoc (version 1.7.0_45) on Thu Jan 09 22:45:26 GMT 2014 --> <title>LogCursor</title> <meta name="date" content="2014-01-09"> <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style"> </head> <body> <script type="text/javascript"><!-- if (location.href.indexOf('is-external=true') == -1) { parent.document.title="LogCursor"; } //--> </script> <noscript> <div>JavaScript is disabled on your browser.</div> </noscript> <!-- ========= START OF TOP NAVBAR ======= --> <div class="topNav"><a name="navbar_top"> <!-- --> </a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow"> <!-- --> </a> <ul class="navList" title="Navigation"> <li><a href="../../../overview-summary.html">Overview</a></li> <li><a href="package-summary.html">Package</a></li> <li class="navBarCell1Rev">Class</li> <li><a href="package-tree.html">Tree</a></li> <li><a href="../../../deprecated-list.html">Deprecated</a></li> <li><a href="../../../index-all.html">Index</a></li> <li><a href="../../../help-doc.html">Help</a></li> </ul> </div> <div class="subNav"> <ul class="navList"> <li><a href="../../../com/sleepycat/db/LockStats.html" title="class in com.sleepycat.db"><span class="strong">Prev Class</span></a></li> <li><a href="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db"><span class="strong">Next Class</span></a></li> </ul> <ul class="navList"> <li><a href="../../../index.html?com/sleepycat/db/LogCursor.html" target="_top">Frames</a></li> <li><a href="LogCursor.html" target="_top">No Frames</a></li> </ul> <ul class="navList" id="allclasses_navbar_top"> <li><a href="../../../allclasses-noframe.html">All Classes</a></li> </ul> <div> <script type="text/javascript"><!-- allClassesLink = document.getElementById("allclasses_navbar_top"); if(window==top) { allClassesLink.style.display = "block"; } else { allClassesLink.style.display = "none"; } //--> </script> </div> <div> <ul class="subNavList"> <li>Summary: </li> <li>Nested | </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method_summary">Method</a></li> </ul> <ul class="subNavList"> <li>Detail: </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method_detail">Method</a></li> </ul> </div> <a name="skip-navbar_top"> <!-- --> </a></div> <!-- ========= END OF TOP NAVBAR ========= --> <!-- ======== START OF CLASS DATA ======== --> <div class="header"> <div class="subTitle">com.sleepycat.db</div> <h2 title="Class LogCursor" class="title">Class LogCursor</h2> </div> <div class="contentContainer"> <ul class="inheritance"> <li>java.lang.Object</li> <li> <ul class="inheritance"> <li>com.sleepycat.db.LogCursor</li> </ul> </li> </ul> <div class="description"> <ul class="blockList"> <li class="blockList"> <hr> <br> <pre>public class <span class="strong">LogCursor</span> extends java.lang.Object</pre> <div class="block">The LogCursor object is the handle for a cursor into the log files, supporting sequential access to the records stored in log files. <p> The handle is not free-threaded. Once the <a href="../../../com/sleepycat/db/LogCursor.html#close()"><code>LogCursor.close</code></a> method is called, the handle may not be accessed again, regardless of that method's success or failure.</div> </li> </ul> </div> <div class="summary"> <ul class="blockList"> <li class="blockList"> <!-- ========== METHOD SUMMARY =========== --> <ul class="blockList"> <li class="blockList"><a name="method_summary"> <!-- --> </a> <h3>Method Summary</h3> <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> <caption><span>Methods</span><span class="tabEnd"> </span></caption> <tr> <th class="colFirst" scope="col">Modifier and Type</th> <th class="colLast" scope="col">Method and Description</th> </tr> <tr class="altColor"> <td class="colFirst"><code>void</code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#close()">close</a></strong>()</code> </td> </tr> <tr class="rowColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#getCurrent(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">getCurrent</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return the LogSequenceNumber and log record to which the log cursor currently refers.</div> </td> </tr> <tr class="altColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#getFirst(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">getFirst</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return the first LogSequenceNumber and log record.</div> </td> </tr> <tr class="rowColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#getLast(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">getLast</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return the last LogSequenceNumber and log record.</div> </td> </tr> <tr class="altColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#getNext(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">getNext</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return the next LogSequenceNumber and log record.</div> </td> </tr> <tr class="rowColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#getPrev(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">getPrev</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return the previous LogSequenceNumber and log record.</div> </td> </tr> <tr class="altColor"> <td class="colFirst"><code><a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a></code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#set(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)">set</a></strong>(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data)</code> <div class="block">Return a specific log record.</div> </td> </tr> <tr class="rowColor"> <td class="colFirst"><code>int</code></td> <td class="colLast"><code><strong><a href="../../../com/sleepycat/db/LogCursor.html#version()">version</a></strong>()</code> <div class="block">Get the log file version.</div> </td> </tr> </table> <ul class="blockList"> <li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> <!-- --> </a> <h3>Methods inherited from class java.lang.Object</h3> <code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li> </ul> </li> </ul> </li> </ul> </div> <div class="details"> <ul class="blockList"> <li class="blockList"> <!-- ============ METHOD DETAIL ========== --> <ul class="blockList"> <li class="blockList"><a name="method_detail"> <!-- --> </a> <h3>Method Detail</h3> <a name="close()"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>close</h4> <pre>public void close() throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <dl><dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code></dd></dl> </li> </ul> <a name="getCurrent(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getCurrent</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> getCurrent(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return the LogSequenceNumber and log record to which the log cursor currently refers. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The returned LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. The data field is set to the record retrieved, and the size field indicates the number of bytes in the record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="getNext(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getNext</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> getNext(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return the next LogSequenceNumber and log record. <p> The current log position is advanced to the next record in the log, and its LogSequenceNumber and data are returned. If the cursor has not been initialized, the first available log record in the log will be returned. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The returned LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation; a return of NOTFOUND indicates the last log record has already been returned or the log is empty. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="getFirst(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getFirst</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> getFirst(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return the first LogSequenceNumber and log record. <p> The current log position is set to the first record in the log, and its LogSequenceNumber and data are returned. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The returned LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation; a return of NOTFOUND indicates the log is empty. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="getLast(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getLast</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> getLast(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return the last LogSequenceNumber and log record. <p> The current log position is set to the last record in the log, and its LogSequenceNumber and data are returned. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The returned LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation; a return of NOTFOUND indicates the log is empty. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="getPrev(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getPrev</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> getPrev(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return the previous LogSequenceNumber and log record. <p> The current log position is advanced to the previous record in the log, and its LogSequenceNumber and data are returned. If the cursor has not been initialized, the last available log record in the log will be returned. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The returned LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation; a return of NOTFOUND indicates the first log record has already been returned or the log is empty. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="set(com.sleepycat.db.LogSequenceNumber, com.sleepycat.db.DatabaseEntry)"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>set</h4> <pre>public <a href="../../../com/sleepycat/db/OperationStatus.html" title="class in com.sleepycat.db">OperationStatus</a> set(<a href="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</a> lsn, <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> data) throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Return a specific log record. <p> The current log position is set to the specified record in the log, and its data is returned. <p></div> <dl><dt><span class="strong">Parameters:</span></dt><dd><code>lsn</code> - The specified LogSequenceNumber. <p></dd><dd><code>data</code> - The returned log record. <p></dd> <dt><span class="strong">Returns:</span></dt><dd>The status of the operation. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> <a name="version()"> <!-- --> </a> <ul class="blockListLast"> <li class="blockList"> <h4>version</h4> <pre>public int version() throws <a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre> <div class="block">Get the log file version. <p></div> <dl><dt><span class="strong">Returns:</span></dt><dd>The log file version. <p> <p></dd> <dt><span class="strong">Throws:</span></dt> <dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl> </li> </ul> </li> </ul> </li> </ul> </div> </div> <!-- ========= END OF CLASS DATA ========= --> <!-- ======= START OF BOTTOM NAVBAR ====== --> <div class="bottomNav"><a name="navbar_bottom"> <!-- --> </a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> <!-- --> </a> <ul class="navList" title="Navigation"> <li><a href="../../../overview-summary.html">Overview</a></li> <li><a href="package-summary.html">Package</a></li> <li class="navBarCell1Rev">Class</li> <li><a href="package-tree.html">Tree</a></li> <li><a href="../../../deprecated-list.html">Deprecated</a></li> <li><a href="../../../index-all.html">Index</a></li> <li><a href="../../../help-doc.html">Help</a></li> </ul> </div> <div class="subNav"> <ul class="navList"> <li><a href="../../../com/sleepycat/db/LockStats.html" title="class in com.sleepycat.db"><span class="strong">Prev Class</span></a></li> <li><a href="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db"><span class="strong">Next Class</span></a></li> </ul> <ul class="navList"> <li><a href="../../../index.html?com/sleepycat/db/LogCursor.html" target="_top">Frames</a></li> <li><a href="LogCursor.html" target="_top">No Frames</a></li> </ul> <ul class="navList" id="allclasses_navbar_bottom"> <li><a href="../../../allclasses-noframe.html">All Classes</a></li> </ul> <div> <script type="text/javascript"><!-- allClassesLink = document.getElementById("allclasses_navbar_bottom"); if(window==top) { allClassesLink.style.display = "block"; } else { allClassesLink.style.display = "none"; } //--> </script> </div> <div> <ul class="subNavList"> <li>Summary: </li> <li>Nested | </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method_summary">Method</a></li> </ul> <ul class="subNavList"> <li>Detail: </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method_detail">Method</a></li> </ul> </div> <a name="skip-navbar_bottom"> <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> </body> </html>