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> 7ReplicationTransport (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="keywords" CONTENT="com.sleepycat.db.ReplicationTransport 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="ReplicationTransport (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/ReplicationTransport.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/ReplicationTimeoutType.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 56 <A HREF="../../../com/sleepycat/db/RunRecoveryException.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/ReplicationTransport.html" target="_top"><B>FRAMES</B></A> 59 <A HREF="ReplicationTransport.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 | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> 77<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 78DETAIL: <A HREF="#field_detail">FIELD</A> | 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 ReplicationTransport</H2> 91<HR> 92<DL> 93<DT><PRE>public interface <B>ReplicationTransport</B></DL> 94</PRE> 95 96<P> 97An interface specifying a replication transmit function, which sends 98information to other members of the replication group. 99<P> 100 101<P> 102<HR> 103 104<P> 105<!-- =========== FIELD SUMMARY =========== --> 106 107<A NAME="field_summary"><!-- --></A> 108<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 109<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 110<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 111<B>Field Summary</B></FONT></TH> 112</TR> 113<TR BGCOLOR="white" CLASS="TableRowColor"> 114<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 115<CODE>static int</CODE></FONT></TD> 116<TD><CODE><B><A HREF="../../../com/sleepycat/db/ReplicationTransport.html#EID_BROADCAST">EID_BROADCAST</A></B></CODE> 117 118<BR> 119 A message that should be broadcast to every environment in the 120 replication group.</TD> 121</TR> 122<TR BGCOLOR="white" CLASS="TableRowColor"> 123<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 124<CODE>static int</CODE></FONT></TD> 125<TD><CODE><B><A HREF="../../../com/sleepycat/db/ReplicationTransport.html#EID_INVALID">EID_INVALID</A></B></CODE> 126 127<BR> 128 An invalid environment ID, and may be used to initialize environment ID 129 variables that are subsequently checked for validity.</TD> 130</TR> 131</TABLE> 132 133<!-- ========== METHOD SUMMARY =========== --> 134 135<A NAME="method_summary"><!-- --></A> 136<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 137<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 138<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 139<B>Method Summary</B></FONT></TH> 140</TR> 141<TR BGCOLOR="white" CLASS="TableRowColor"> 142<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 143<CODE> int</CODE></FONT></TD> 144<TD><CODE><B><A HREF="../../../com/sleepycat/db/ReplicationTransport.html#send(com.sleepycat.db.Environment, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.LogSequenceNumber, int, boolean, boolean, boolean, boolean)">send</A></B>(<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db">Environment</A> environment, 145 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> control, 146 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> rec, 147 <A HREF="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</A> lsn, 148 int envid, 149 boolean noBuffer, 150 boolean permanent, 151 boolean anywhere, 152 boolean isRetry)</CODE> 153 154<BR> 155 The callback used when Berkeley DB needs to transmit a replication message.</TD> 156</TR> 157</TABLE> 158 159<P> 160 161<!-- ============ FIELD DETAIL =========== --> 162 163<A NAME="field_detail"><!-- --></A> 164<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 165<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 166<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 167<B>Field Detail</B></FONT></TH> 168</TR> 169</TABLE> 170 171<A NAME="EID_BROADCAST"><!-- --></A><H3> 172EID_BROADCAST</H3> 173<PRE> 174static final int <B>EID_BROADCAST</B></PRE> 175<DL> 176<DD>A message that should be broadcast to every environment in the 177 replication group. The application may use a true broadcast protocol or 178 may send the message in sequence to each machine with which it is in 179 communication. In both cases, the sending site should not be asked to 180 process the message. 181<P> 182<DL> 183<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#com.sleepycat.db.ReplicationTransport.EID_BROADCAST">Constant Field Values</A></DL> 184</DL> 185<HR> 186 187<A NAME="EID_INVALID"><!-- --></A><H3> 188EID_INVALID</H3> 189<PRE> 190static final int <B>EID_INVALID</B></PRE> 191<DL> 192<DD>An invalid environment ID, and may be used to initialize environment ID 193 variables that are subsequently checked for validity. 194<P> 195<DL> 196<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#com.sleepycat.db.ReplicationTransport.EID_INVALID">Constant Field Values</A></DL> 197</DL> 198 199<!-- ============ METHOD DETAIL ========== --> 200 201<A NAME="method_detail"><!-- --></A> 202<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 203<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 204<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 205<B>Method Detail</B></FONT></TH> 206</TR> 207</TABLE> 208 209<A NAME="send(com.sleepycat.db.Environment, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.LogSequenceNumber, int, boolean, boolean, boolean, boolean)"><!-- --></A><H3> 210send</H3> 211<PRE> 212int <B>send</B>(<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db">Environment</A> environment, 213 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> control, 214 <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> rec, 215 <A HREF="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</A> lsn, 216 int envid, 217 boolean noBuffer, 218 boolean permanent, 219 boolean anywhere, 220 boolean isRetry) 221 throws <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></PRE> 222<DL> 223<DD>The callback used when Berkeley DB needs to transmit a replication message. 224 This method must not call back down into Berkeley DB. It must return 0 on 225 success and non-zero on failure. If the transmission fails, the message 226 being sent is necessary to maintain database integrity, and the local log 227 is not configured for synchronous flushing, the local log will be flushed; 228 otherwise, any error from the function will be ignored. 229 <p> 230<P> 231<DD><DL> 232<DT><B>Parameters:</B><DD><CODE>environment</CODE> - The enclosing database environment handle. 233 <p><DD><CODE>control</CODE> - The first of the two data elements to be transmitted. 234 <p><DD><CODE>rec</CODE> - The second of the two data elements to be transmitted. 235 <p><DD><CODE>lsn</CODE> - If the type of message to be sent has an LSN associated with it, 236 then the lsn contains the LSN of the record being sent. This LSN 237 can be used to determine that certain records have been processed 238 successfully by clients. 239 <p><DD><CODE>envid</CODE> - A positive integer identifier that specifies the replication 240 environment to which the message should be sent. 241 <p> 242 The value DB_EID_BROADCAST indicates that a message should be 243 broadcast to every environment in the replication group. The 244 application may use a true broadcast protocol or may send the 245 message in sequence to each machine with which it is in 246 communication. In both cases, the sending site should not be asked 247 to process the message. 248 <p><DD><CODE>noBuffer</CODE> - The record being sent should be transmitted immediately and not buffered 249 or delayed. 250 <p><DD><CODE>permanent</CODE> - The record being sent is critical for maintaining database integrity 251 (for example, the message includes a transaction commit). The 252 application should take appropriate action to enforce the reliability 253 guarantees it has chosen, such as waiting for acknowledgement from one 254 or more clients. 255 <p><DD><CODE>anywhere</CODE> - The message is a client request that can be satisfied by another client as 256 well as by the master. 257 <p><DD><CODE>isRetry</CODE> - The message is a client request that has already been made and to which no 258 response was received. 259 <p> 260<DT><B>Throws:</B> 261<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> 262</DD> 263</DL> 264<!-- ========= END OF CLASS DATA ========= --> 265<HR> 266 267 268<!-- ======= START OF BOTTOM NAVBAR ====== --> 269<A NAME="navbar_bottom"><!-- --></A> 270<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 271<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 272<TR> 273<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 274<A NAME="navbar_bottom_firstrow"><!-- --></A> 275<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 276 <TR ALIGN="center" VALIGN="top"> 277 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 278 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 279 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 280 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ReplicationTransport.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 281 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 282 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 283 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 284 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 285 </TR> 286</TABLE> 287</TD> 288<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 289<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 290</TD> 291</TR> 292 293<TR> 294<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 295 <A HREF="../../../com/sleepycat/db/ReplicationTimeoutType.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 296 <A HREF="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> 297<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 298 <A HREF="../../../index.html?com/sleepycat/db/ReplicationTransport.html" target="_top"><B>FRAMES</B></A> 299 <A HREF="ReplicationTransport.html" target="_top"><B>NO FRAMES</B></A> 300 <SCRIPT type="text/javascript"> 301 <!-- 302 if(window==top) { 303 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 304 } 305 //--> 306</SCRIPT> 307<NOSCRIPT> 308 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 309</NOSCRIPT> 310 311 312</FONT></TD> 313</TR> 314<TR> 315<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 316 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> 317<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 318DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD> 319</TR> 320</TABLE> 321<A NAME="skip-navbar_bottom"></A> 322<!-- ======== END OF BOTTOM NAVBAR ======= --> 323 324<HR> 325<font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 326</BODY> 327</HTML> 328