• Home
  • History
  • Annotate
  • Line#
  • Navigate
  • Raw
  • Download
  • only in /netgear-R7000-V1.0.7.12_1.2.5/ap/gpl/timemachine/db-4.7.25.NC/docs/java/com/sleepycat/db/
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>&nbsp;</TD>
38  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
39  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
40  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ReplicationTransport.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
41  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
42  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
43  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
44  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</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&nbsp;<A HREF="../../../com/sleepycat/db/ReplicationTimeoutType.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A>&nbsp;
56&nbsp;<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>  &nbsp;
59&nbsp;<A HREF="ReplicationTransport.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
60&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
77<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
78DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<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&nbsp;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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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&nbsp;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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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&nbsp;
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>&nbsp;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>&nbsp;environment,
145     <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;control,
146     <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;rec,
147     <A HREF="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</A>&nbsp;lsn,
148     int&nbsp;envid,
149     boolean&nbsp;noBuffer,
150     boolean&nbsp;permanent,
151     boolean&nbsp;anywhere,
152     boolean&nbsp;isRetry)</CODE>
153
154<BR>
155&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The callback used when Berkeley DB needs to transmit a replication message.</TD>
156</TR>
157</TABLE>
158&nbsp;
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>&nbsp;environment,
213         <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;control,
214         <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A>&nbsp;rec,
215         <A HREF="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db">LogSequenceNumber</A>&nbsp;lsn,
216         int&nbsp;envid,
217         boolean&nbsp;noBuffer,
218         boolean&nbsp;permanent,
219         boolean&nbsp;anywhere,
220         boolean&nbsp;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>&nbsp;</TD>
278  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
279  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
280  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ReplicationTransport.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
281  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
282  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
283  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
284  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</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&nbsp;<A HREF="../../../com/sleepycat/db/ReplicationTimeoutType.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A>&nbsp;
296&nbsp;<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>  &nbsp;
299&nbsp;<A HREF="ReplicationTransport.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
300&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
317<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
318DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<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