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:31 EDT 2008 --> 6<TITLE> 7RecordNumberAppender (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="keywords" CONTENT="com.sleepycat.db.RecordNumberAppender interface"> 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="RecordNumberAppender (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/RecordNumberAppender.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/db/QueueStats.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 56 <A HREF="../../../com/sleepycat/db/RecoveryOperation.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="../../../index.html?com/sleepycat/db/RecordNumberAppender.html" target="_top"><B>FRAMES</B></A> 59 <A HREF="RecordNumberAppender.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.db</FONT> 89<BR> 90Interface RecordNumberAppender</H2> 91<HR> 92<DL> 93<DT><PRE>public interface <B>RecordNumberAppender</B></DL> 94</PRE> 95 96<P> 97An interface specifying a callback function that modifies stored data 98based on a generated key. 99<P> 100 101<P> 102<HR> 103 104<P> 105 106<!-- ========== METHOD SUMMARY =========== --> 107 108<A NAME="method_summary"><!-- --></A> 109<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 110<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 111<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 112<B>Method Summary</B></FONT></TH> 113</TR> 114<TR BGCOLOR="white" CLASS="TableRowColor"> 115<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 116<CODE> void</CODE></FONT></TD> 117<TD><CODE><B><A HREF="../../../com/sleepycat/db/RecordNumberAppender.html#appendRecordNumber(com.sleepycat.db.Database, com.sleepycat.db.DatabaseEntry, int)">appendRecordNumber</A></B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> db, 118 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> data, 119 int recno)</CODE> 120 121<BR> 122 A callback function to modify the stored database based on the 123 generated key.</TD> 124</TR> 125</TABLE> 126 127<P> 128 129<!-- ============ METHOD DETAIL ========== --> 130 131<A NAME="method_detail"><!-- --></A> 132<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 133<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 134<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 135<B>Method Detail</B></FONT></TH> 136</TR> 137</TABLE> 138 139<A NAME="appendRecordNumber(com.sleepycat.db.Database, com.sleepycat.db.DatabaseEntry, int)"><!-- --></A><H3> 140appendRecordNumber</H3> 141<PRE> 142void <B>appendRecordNumber</B>(<A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db">Database</A> db, 143 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> data, 144 int recno) 145 throws <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></PRE> 146<DL> 147<DD>A callback function to modify the stored database based on the 148 generated key. 149 <p> 150 When storing records using <A HREF="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry)"><CODE>Database.append</CODE></A> it may be 151 useful to modify the stored data based on the generated key. This function will be called after the record number has been 152 selected, but before the data has been stored. 153 <p> The callback function may modify the data <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db"><CODE>DatabaseEntry</CODE></A>. <p> The callback function must throw a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> object 154 to encapsulate the error on failure. That object will be thrown to 155 caller of <A HREF="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry)"><CODE>Database.append</CODE></A>. 156 <p> 157<P> 158<DD><DL> 159<DT><B>Parameters:</B><DD><CODE>db</CODE> - The enclosing database handle. 160 <p> @param data 161 The data to be stored. 162 <p><DD><CODE>recno</CODE> - The generated record number. 163<DT><B>Throws:</B> 164<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE></DL> 165</DD> 166</DL> 167<!-- ========= END OF CLASS DATA ========= --> 168<HR> 169 170 171<!-- ======= START OF BOTTOM NAVBAR ====== --> 172<A NAME="navbar_bottom"><!-- --></A> 173<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 174<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 175<TR> 176<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 177<A NAME="navbar_bottom_firstrow"><!-- --></A> 178<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 179 <TR ALIGN="center" VALIGN="top"> 180 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 181 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 182 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 183 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/RecordNumberAppender.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 184 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 185 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 186 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 187 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 188 </TR> 189</TABLE> 190</TD> 191<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 192<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 193</TD> 194</TR> 195 196<TR> 197<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 198 <A HREF="../../../com/sleepycat/db/QueueStats.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 199 <A HREF="../../../com/sleepycat/db/RecoveryOperation.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> 200<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 201 <A HREF="../../../index.html?com/sleepycat/db/RecordNumberAppender.html" target="_top"><B>FRAMES</B></A> 202 <A HREF="RecordNumberAppender.html" target="_top"><B>NO FRAMES</B></A> 203 <SCRIPT type="text/javascript"> 204 <!-- 205 if(window==top) { 206 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 207 } 208 //--> 209</SCRIPT> 210<NOSCRIPT> 211 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 212</NOSCRIPT> 213 214 215</FONT></TD> 216</TR> 217<TR> 218<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 219 SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> 220<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 221DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD> 222</TR> 223</TABLE> 224<A NAME="skip-navbar_bottom"></A> 225<!-- ======== END OF BOTTOM NAVBAR ======= --> 226 227<HR> 228<font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 229</BODY> 230</HTML> 231