docs/java/com/sleepycat/db/TransactionConfig.html

   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.6.0_23) on Fri May 11 14:10:06 EDT 2012 -->
   6 <TITLE>
   7 TransactionConfig (Oracle - Berkeley DB Java API)
   8 </TITLE>
   9
  10 <META NAME="date" CONTENT="2012-05-11">
  11
  12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../style.css" TITLE="Style">
  13
  14 <SCRIPT type="text/javascript">
  15 function windowTitle()
  16 {
  17     if (location.href.indexOf('is-external=true') == -1) {
  18         parent.document.title="TransactionConfig (Oracle - Berkeley DB Java API)";
  19     }
  20 }
  21 </SCRIPT>
  22 <NOSCRIPT>
  23 </NOSCRIPT>
  24
  25 </HEAD>
  26
  27 <BODY BGCOLOR="white" onload="windowTitle();">
  28 <HR>
  29
  30
  31 <!-- ========= START OF TOP NAVBAR ======= -->
  32 <A NAME="navbar_top"><!-- --></A>
  33 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  34 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  35 <TR>
  36 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  37 <A NAME="navbar_top_firstrow"><!-- --></A>
  38 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  39   <TR ALIGN="center" VALIGN="top">
  40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  42   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransactionConfig.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  44   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  45   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  46   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  47   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  48   </TR>
  49 </TABLE>
  50 </TD>
  51 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  52 <b>Berkeley DB</b><br><font size="-1"> version 5.3.21</font></EM>
  53 </TD>
  54 </TR>
  55
  56 <TR>
  57 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  58 &nbsp;<A HREF="../../../com/sleepycat/db/Transaction.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A>&nbsp;
  59 &nbsp;<A HREF="../../../com/sleepycat/db/TransactionStats.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD>
  60 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  61   <A HREF="../../../index.html?com/sleepycat/db/TransactionConfig.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  62 &nbsp;<A HREF="TransactionConfig.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
  63 &nbsp;<SCRIPT type="text/javascript">
  64   <!--
  65   if(window==top) {
  66     document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  67   }
  68   //-->
  69 </SCRIPT>
  70 <NOSCRIPT>
  71   <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
  72 </NOSCRIPT>
  73
  74
  75 </FONT></TD>
  76 </TR>
  77 <TR>
  78 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  79   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  80 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  81 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  82 </TR>
  83 </TABLE>
  84 <A NAME="skip-navbar_top"></A>
  85 <!-- ========= END OF TOP NAVBAR ========= -->
  86
  87 <HR>
  88 <!-- ======== START OF CLASS DATA ======== -->
  89 <H2>
  90 <FONT SIZE="-1">
  91 com.sleepycat.db</FONT>
  92 <BR>
  93 Class TransactionConfig</H2>
  94 <PRE>
  95 <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
  96   <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.db.TransactionConfig</B>
  97 </PRE>
  98 <DL>
  99 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</A></DD>
 100 </DL>
 101 <HR>
 102 <DL>
 103 <DT><PRE>public class <B>TransactionConfig</B><DT>extends <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</A></DL>
 104 </PRE>
 105
 106 <P>
 107 Specifies the attributes of a database environment transaction.
 108 <P>
 109
 110 <P>
 111 <HR>
 112
 113 <P>
 114 <!-- =========== FIELD SUMMARY =========== -->
 115
 116 <A NAME="field_summary"><!-- --></A>
 117 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 118 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 119 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 120 <B>Field Summary</B></FONT></TH>
 121 </TR>
 122 <TR BGCOLOR="white" CLASS="TableRowColor">
 123 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 124 <CODE>static&nbsp;<A HREF="../../../com/sleepycat/db/TransactionConfig.html" title="class in com.sleepycat.db">TransactionConfig</A></CODE></FONT></TD>
 125 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#DEFAULT">DEFAULT</A></B></CODE>
 126
 127 <BR>
 128 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default configuration used if null is passed to methods that create a
 129     transaction.</TD>
 130 </TR>
 131 </TABLE>
 132 &nbsp;
 133 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 134
 135 <A NAME="constructor_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>Constructor Summary</B></FONT></TH>
 140 </TR>
 141 <TR BGCOLOR="white" CLASS="TableRowColor">
 142 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#TransactionConfig()">TransactionConfig</A></B>()</CODE>
 143
 144 <BR>
 145 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;An instance created using the default constructor is initialized
 146     with the system's default settings.</TD>
 147 </TR>
 148 </TABLE>
 149 &nbsp;
 150 <!-- ========== METHOD SUMMARY =========== -->
 151
 152 <A NAME="method_summary"><!-- --></A>
 153 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 154 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 155 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 156 <B>Method Summary</B></FONT></TH>
 157 </TR>
 158 <TR BGCOLOR="white" CLASS="TableRowColor">
 159 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 160 <CODE>&nbsp;boolean</CODE></FONT></TD>
 161 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getBulk()">getBulk</A></B>()</CODE>
 162
 163 <BR>
 164 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return true if the Bulk attribute is set.</TD>
 165 </TR>
 166 <TR BGCOLOR="white" CLASS="TableRowColor">
 167 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 168 <CODE>&nbsp;boolean</CODE></FONT></TD>
 169 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getDegree2()">getDegree2</A></B>()</CODE>
 170
 171 <BR>
 172 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadCommitted()"><CODE>getReadCommitted()</CODE></A> to conform to ANSI
 173     database isolation terminology.</I></TD>
 174 </TR>
 175 <TR BGCOLOR="white" CLASS="TableRowColor">
 176 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 177 <CODE>&nbsp;boolean</CODE></FONT></TD>
 178 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getDirtyRead()">getDirtyRead</A></B>()</CODE>
 179
 180 <BR>
 181 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadUncommitted()"><CODE>getReadUncommitted()</CODE></A> to conform to ANSI
 182     database isolation terminology.</I></TD>
 183 </TR>
 184 <TR BGCOLOR="white" CLASS="TableRowColor">
 185 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 186 <CODE>&nbsp;boolean</CODE></FONT></TD>
 187 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getNoSync()">getNoSync</A></B>()</CODE>
 188
 189 <BR>
 190 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured to not write or synchronously
 191     flush the log it when commits.</TD>
 192 </TR>
 193 <TR BGCOLOR="white" CLASS="TableRowColor">
 194 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 195 <CODE>&nbsp;boolean</CODE></FONT></TD>
 196 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getNoWait()">getNoWait</A></B>()</CODE>
 197
 198 <BR>
 199 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured to not wait if a lock
 200     request cannot be immediately granted.</TD>
 201 </TR>
 202 <TR BGCOLOR="white" CLASS="TableRowColor">
 203 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 204 <CODE>&nbsp;boolean</CODE></FONT></TD>
 205 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadCommitted()">getReadCommitted</A></B>()</CODE>
 206
 207 <BR>
 208 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured for read committed isolation.</TD>
 209 </TR>
 210 <TR BGCOLOR="white" CLASS="TableRowColor">
 211 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 212 <CODE>&nbsp;boolean</CODE></FONT></TD>
 213 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadUncommitted()">getReadUncommitted</A></B>()</CODE>
 214
 215 <BR>
 216 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if read operations performed by the transaction are configured to
 217     return modified but not yet committed data.</TD>
 218 </TR>
 219 <TR BGCOLOR="white" CLASS="TableRowColor">
 220 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 221 <CODE>&nbsp;boolean</CODE></FONT></TD>
 222 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getSnapshot()">getSnapshot</A></B>()</CODE>
 223
 224 <BR>
 225 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return true if the transaction is configured for Snapshot Isolation.</TD>
 226 </TR>
 227 <TR BGCOLOR="white" CLASS="TableRowColor">
 228 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 229 <CODE>&nbsp;boolean</CODE></FONT></TD>
 230 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getSync()">getSync</A></B>()</CODE>
 231
 232 <BR>
 233 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured to write and synchronously
 234     flush the log it when commits.</TD>
 235 </TR>
 236 <TR BGCOLOR="white" CLASS="TableRowColor">
 237 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 238 <CODE>&nbsp;boolean</CODE></FONT></TD>
 239 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getWait()">getWait</A></B>()</CODE>
 240
 241 <BR>
 242 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured to wait if a lock
 243     request cannot be immediately granted.</TD>
 244 </TR>
 245 <TR BGCOLOR="white" CLASS="TableRowColor">
 246 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 247 <CODE>&nbsp;boolean</CODE></FONT></TD>
 248 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#getWriteNoSync()">getWriteNoSync</A></B>()</CODE>
 249
 250 <BR>
 251 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return if the transaction is configured to write but not synchronously
 252     flush the log it when commits.</TD>
 253 </TR>
 254 <TR BGCOLOR="white" CLASS="TableRowColor">
 255 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 256 <CODE>&nbsp;void</CODE></FONT></TD>
 257 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setBulk(boolean)">setBulk</A></B>(boolean&nbsp;bulk)</CODE>
 258
 259 <BR>
 260 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configures the transaction to enable the transactional bulk insert
 261     optimization.</TD>
 262 </TR>
 263 <TR BGCOLOR="white" CLASS="TableRowColor">
 264 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 265 <CODE>&nbsp;void</CODE></FONT></TD>
 266 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setDegree2(boolean)">setDegree2</A></B>(boolean&nbsp;degree2)</CODE>
 267
 268 <BR>
 269 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadCommitted(boolean)"><CODE>setReadCommitted(boolean)</CODE></A> to conform to ANSI
 270     database isolation terminology.</I></TD>
 271 </TR>
 272 <TR BGCOLOR="white" CLASS="TableRowColor">
 273 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 274 <CODE>&nbsp;void</CODE></FONT></TD>
 275 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setDirtyRead(boolean)">setDirtyRead</A></B>(boolean&nbsp;dirtyRead)</CODE>
 276
 277 <BR>
 278 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadUncommitted(boolean)"><CODE>setReadUncommitted(boolean)</CODE></A> to conform to ANSI
 279     database isolation terminology.</I></TD>
 280 </TR>
 281 <TR BGCOLOR="white" CLASS="TableRowColor">
 282 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 283 <CODE>&nbsp;void</CODE></FONT></TD>
 284 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setNoSync(boolean)">setNoSync</A></B>(boolean&nbsp;noSync)</CODE>
 285
 286 <BR>
 287 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction to not write or synchronously flush the log
 288     it when commits.</TD>
 289 </TR>
 290 <TR BGCOLOR="white" CLASS="TableRowColor">
 291 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 292 <CODE>&nbsp;void</CODE></FONT></TD>
 293 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setNoWait(boolean)">setNoWait</A></B>(boolean&nbsp;noWait)</CODE>
 294
 295 <BR>
 296 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction to not wait if a lock request cannot be
 297     immediately granted.</TD>
 298 </TR>
 299 <TR BGCOLOR="white" CLASS="TableRowColor">
 300 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 301 <CODE>&nbsp;void</CODE></FONT></TD>
 302 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadCommitted(boolean)">setReadCommitted</A></B>(boolean&nbsp;readCommitted)</CODE>
 303
 304 <BR>
 305 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction for read committed isolation.</TD>
 306 </TR>
 307 <TR BGCOLOR="white" CLASS="TableRowColor">
 308 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 309 <CODE>&nbsp;void</CODE></FONT></TD>
 310 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadUncommitted(boolean)">setReadUncommitted</A></B>(boolean&nbsp;readUncommitted)</CODE>
 311
 312 <BR>
 313 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure read operations performed by the transaction to return modified
 314     but not yet committed data.</TD>
 315 </TR>
 316 <TR BGCOLOR="white" CLASS="TableRowColor">
 317 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 318 <CODE>&nbsp;void</CODE></FONT></TD>
 319 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setSnapshot(boolean)">setSnapshot</A></B>(boolean&nbsp;snapshot)</CODE>
 320
 321 <BR>
 322 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This transaction will execute with snapshot isolation.</TD>
 323 </TR>
 324 <TR BGCOLOR="white" CLASS="TableRowColor">
 325 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 326 <CODE>&nbsp;void</CODE></FONT></TD>
 327 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setSync(boolean)">setSync</A></B>(boolean&nbsp;sync)</CODE>
 328
 329 <BR>
 330 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction to write and synchronously flush the log
 331     it when commits.</TD>
 332 </TR>
 333 <TR BGCOLOR="white" CLASS="TableRowColor">
 334 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 335 <CODE>&nbsp;void</CODE></FONT></TD>
 336 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setWait(boolean)">setWait</A></B>(boolean&nbsp;wait)</CODE>
 337
 338 <BR>
 339 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction to wait if a lock request cannot be
 340     immediately granted.</TD>
 341 </TR>
 342 <TR BGCOLOR="white" CLASS="TableRowColor">
 343 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 344 <CODE>&nbsp;void</CODE></FONT></TD>
 345 <TD><CODE><B><A HREF="../../../com/sleepycat/db/TransactionConfig.html#setWriteNoSync(boolean)">setWriteNoSync</A></B>(boolean&nbsp;writeNoSync)</CODE>
 346
 347 <BR>
 348 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Configure the transaction to write but not synchronously flush the log
 349     it when commits.</TD>
 350 </TR>
 351 </TABLE>
 352 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
 353 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 354 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 355 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
 356 </TR>
 357 <TR BGCOLOR="white" CLASS="TableRowColor">
 358 <TD><CODE><A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/1.5.0/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
 359 </TR>
 360 </TABLE>
 361 &nbsp;
 362 <P>
 363
 364 <!-- ============ FIELD DETAIL =========== -->
 365
 366 <A NAME="field_detail"><!-- --></A>
 367 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 368 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 369 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 370 <B>Field Detail</B></FONT></TH>
 371 </TR>
 372 </TABLE>
 373
 374 <A NAME="DEFAULT"><!-- --></A><H3>
 375 DEFAULT</H3>
 376 <PRE>
 377 public static final <A HREF="../../../com/sleepycat/db/TransactionConfig.html" title="class in com.sleepycat.db">TransactionConfig</A> <B>DEFAULT</B></PRE>
 378 <DL>
 379 <DD>Default configuration used if null is passed to methods that create a
 380     transaction.
 381 <P>
 382 <DL>
 383 </DL>
 384 </DL>
 385
 386 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 387
 388 <A NAME="constructor_detail"><!-- --></A>
 389 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 390 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 391 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 392 <B>Constructor Detail</B></FONT></TH>
 393 </TR>
 394 </TABLE>
 395
 396 <A NAME="TransactionConfig()"><!-- --></A><H3>
 397 TransactionConfig</H3>
 398 <PRE>
 399 public <B>TransactionConfig</B>()</PRE>
 400 <DL>
 401 <DD>An instance created using the default constructor is initialized
 402     with the system's default settings.
 403 <P>
 404 </DL>
 405
 406 <!-- ============ METHOD DETAIL ========== -->
 407
 408 <A NAME="method_detail"><!-- --></A>
 409 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 410 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 411 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 412 <B>Method Detail</B></FONT></TH>
 413 </TR>
 414 </TABLE>
 415
 416 <A NAME="setReadCommitted(boolean)"><!-- --></A><H3>
 417 setReadCommitted</H3>
 418 <PRE>
 419 public void <B>setReadCommitted</B>(boolean&nbsp;readCommitted)</PRE>
 420 <DL>
 421 <DD>Configure the transaction for read committed isolation.
 422     <p>
 423     This ensures the stability of the current data item read by the
 424     cursor but permits data read by this transaction to be modified or
 425     deleted prior to the commit of the transaction.
 426     <p>
 427 <P>
 428 <DD><DL>
 429 </DL>
 430 </DD>
 431 <DD><DL>
 432 <DT><B>Parameters:</B><DD><CODE>readCommitted</CODE> - If true, configure the transaction for read committed isolation.</DL>
 433 </DD>
 434 </DL>
 435 <HR>
 436
 437 <A NAME="getReadCommitted()"><!-- --></A><H3>
 438 getReadCommitted</H3>
 439 <PRE>
 440 public boolean <B>getReadCommitted</B>()</PRE>
 441 <DL>
 442 <DD>Return if the transaction is configured for read committed isolation.
 443     <p>
 444 <P>
 445 <DD><DL>
 446 </DL>
 447 </DD>
 448 <DD><DL>
 449
 450 <DT><B>Returns:</B><DD>If the transaction is configured for read committed isolation.</DL>
 451 </DD>
 452 </DL>
 453 <HR>
 454
 455 <A NAME="setDegree2(boolean)"><!-- --></A><H3>
 456 setDegree2</H3>
 457 <PRE>
 458 public void <B>setDegree2</B>(boolean&nbsp;degree2)</PRE>
 459 <DL>
 460 <DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadCommitted(boolean)"><CODE>setReadCommitted(boolean)</CODE></A> to conform to ANSI
 461     database isolation terminology.</I>
 462 <P>
 463 <DD>Configure the transaction for read committed isolation.
 464     <p>
 465     This ensures the stability of the current data item read by the
 466     cursor but permits data read by this transaction to be modified or
 467     deleted prior to the commit of the transaction.
 468     <p>
 469 <P>
 470 <DD><DL>
 471 </DL>
 472 </DD>
 473 <DD><DL>
 474 <DT><B>Parameters:</B><DD><CODE>degree2</CODE> - If true, configure the transaction for read committed isolation.
 475         <p></DL>
 476 </DD>
 477 </DL>
 478 <HR>
 479
 480 <A NAME="getDegree2()"><!-- --></A><H3>
 481 getDegree2</H3>
 482 <PRE>
 483 public boolean <B>getDegree2</B>()</PRE>
 484 <DL>
 485 <DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadCommitted()"><CODE>getReadCommitted()</CODE></A> to conform to ANSI
 486     database isolation terminology.</I>
 487 <P>
 488 <DD>Return if the transaction is configured for read committed isolation.
 489     <p>
 490 <P>
 491 <DD><DL>
 492 </DL>
 493 </DD>
 494 <DD><DL>
 495
 496 <DT><B>Returns:</B><DD>If the transaction is configured for read committed isolation.
 497         <p></DL>
 498 </DD>
 499 </DL>
 500 <HR>
 501
 502 <A NAME="setReadUncommitted(boolean)"><!-- --></A><H3>
 503 setReadUncommitted</H3>
 504 <PRE>
 505 public void <B>setReadUncommitted</B>(boolean&nbsp;readUncommitted)</PRE>
 506 <DL>
 507 <DD>Configure read operations performed by the transaction to return modified
 508     but not yet committed data.
 509     <p>
 510 <P>
 511 <DD><DL>
 512 </DL>
 513 </DD>
 514 <DD><DL>
 515 <DT><B>Parameters:</B><DD><CODE>readUncommitted</CODE> - If true, configure read operations performed by the transaction to return
 516     modified but not yet committed data.</DL>
 517 </DD>
 518 </DL>
 519 <HR>
 520
 521 <A NAME="getReadUncommitted()"><!-- --></A><H3>
 522 getReadUncommitted</H3>
 523 <PRE>
 524 public boolean <B>getReadUncommitted</B>()</PRE>
 525 <DL>
 526 <DD>Return if read operations performed by the transaction are configured to
 527     return modified but not yet committed data.
 528     <p>
 529 <P>
 530 <DD><DL>
 531 </DL>
 532 </DD>
 533 <DD><DL>
 534
 535 <DT><B>Returns:</B><DD>If read operations performed by the transaction are configured to return
 536     modified but not yet committed data.</DL>
 537 </DD>
 538 </DL>
 539 <HR>
 540
 541 <A NAME="setDirtyRead(boolean)"><!-- --></A><H3>
 542 setDirtyRead</H3>
 543 <PRE>
 544 public void <B>setDirtyRead</B>(boolean&nbsp;dirtyRead)</PRE>
 545 <DL>
 546 <DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#setReadUncommitted(boolean)"><CODE>setReadUncommitted(boolean)</CODE></A> to conform to ANSI
 547     database isolation terminology.</I>
 548 <P>
 549 <DD>Configure read operations performed by the transaction to return modified
 550     but not yet committed data.
 551     <p>
 552 <P>
 553 <DD><DL>
 554 </DL>
 555 </DD>
 556 <DD><DL>
 557 <DT><B>Parameters:</B><DD><CODE>dirtyRead</CODE> - If true, configure read operations performed by the transaction to return
 558     modified but not yet committed data.
 559         <p></DL>
 560 </DD>
 561 </DL>
 562 <HR>
 563
 564 <A NAME="getDirtyRead()"><!-- --></A><H3>
 565 getDirtyRead</H3>
 566 <PRE>
 567 public boolean <B>getDirtyRead</B>()</PRE>
 568 <DL>
 569 <DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../com/sleepycat/db/TransactionConfig.html#getReadUncommitted()"><CODE>getReadUncommitted()</CODE></A> to conform to ANSI
 570     database isolation terminology.</I>
 571 <P>
 572 <DD>Return if read operations performed by the transaction are configured to
 573     return modified but not yet committed data.
 574     <p>
 575 <P>
 576 <DD><DL>
 577 </DL>
 578 </DD>
 579 <DD><DL>
 580
 581 <DT><B>Returns:</B><DD>If read operations performed by the transaction are configured to return
 582     modified but not yet committed data.
 583         <p></DL>
 584 </DD>
 585 </DL>
 586 <HR>
 587
 588 <A NAME="setNoSync(boolean)"><!-- --></A><H3>
 589 setNoSync</H3>
 590 <PRE>
 591 public void <B>setNoSync</B>(boolean&nbsp;noSync)</PRE>
 592 <DL>
 593 <DD>Configure the transaction to not write or synchronously flush the log
 594     it when commits.
 595     <p>
 596     This behavior may be set for a database environment using the
 597     Environment.setMutableConfig method. Any value specified to this method
 598     overrides that setting.
 599     <p>
 600     The default is false for this class and the database environment.
 601     <p>
 602 <P>
 603 <DD><DL>
 604 </DL>
 605 </DD>
 606 <DD><DL>
 607 <DT><B>Parameters:</B><DD><CODE>noSync</CODE> - If true, transactions exhibit the ACI (atomicity, consistency, and
 608     isolation) properties, but not D (durability); that is, database
 609     integrity will be maintained, but if the application or system
 610     fails, it is possible some number of the most recently committed
 611     transactions may be undone during recovery. The number of
 612     transactions at risk is governed by how many log updates can fit
 613     into the log buffer, how often the operating system flushes dirty
 614     buffers to disk, and how often the log is checkpointed.</DL>
 615 </DD>
 616 </DL>
 617 <HR>
 618
 619 <A NAME="getNoSync()"><!-- --></A><H3>
 620 getNoSync</H3>
 621 <PRE>
 622 public boolean <B>getNoSync</B>()</PRE>
 623 <DL>
 624 <DD>Return if the transaction is configured to not write or synchronously
 625     flush the log it when commits.
 626     <p>
 627 <P>
 628 <DD><DL>
 629 </DL>
 630 </DD>
 631 <DD><DL>
 632
 633 <DT><B>Returns:</B><DD>If the transaction is configured to not write or synchronously flush
 634     the log it when commits.</DL>
 635 </DD>
 636 </DL>
 637 <HR>
 638
 639 <A NAME="setNoWait(boolean)"><!-- --></A><H3>
 640 setNoWait</H3>
 641 <PRE>
 642 public void <B>setNoWait</B>(boolean&nbsp;noWait)</PRE>
 643 <DL>
 644 <DD>Configure the transaction to not wait if a lock request cannot be
 645     immediately granted.
 646     <p>
 647     The default is false for this class and the database environment.
 648     <p>
 649 <P>
 650 <DD><DL>
 651 </DL>
 652 </DD>
 653 <DD><DL>
 654 <DT><B>Parameters:</B><DD><CODE>noWait</CODE> - If true, transactions will not wait if a lock request cannot be
 655     immediately granted, instead <A HREF="../../../com/sleepycat/db/DeadlockException.html" title="class in com.sleepycat.db"><CODE>DeadlockException</CODE></A> will be thrown.</DL>
 656 </DD>
 657 </DL>
 658 <HR>
 659
 660 <A NAME="getNoWait()"><!-- --></A><H3>
 661 getNoWait</H3>
 662 <PRE>
 663 public boolean <B>getNoWait</B>()</PRE>
 664 <DL>
 665 <DD>Return if the transaction is configured to not wait if a lock
 666     request cannot be immediately granted.
 667     <p>
 668 <P>
 669 <DD><DL>
 670 </DL>
 671 </DD>
 672 <DD><DL>
 673
 674 <DT><B>Returns:</B><DD>If the transaction is configured to not wait if a lock request
 675     cannot be immediately granted.</DL>
 676 </DD>
 677 </DL>
 678 <HR>
 679
 680 <A NAME="setSnapshot(boolean)"><!-- --></A><H3>
 681 setSnapshot</H3>
 682 <PRE>
 683 public void <B>setSnapshot</B>(boolean&nbsp;snapshot)</PRE>
 684 <DL>
 685 <DD>This transaction will execute with snapshot isolation.  For databases
 686     configured with <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMultiversion(boolean)"><CODE>DatabaseConfig.setMultiversion(boolean)</CODE></A>, data values
 687     will be read as they are when the transaction begins, without taking
 688     read locks.
 689     <p>
 690     Updates operations performed in the transaction will cause a
 691     <A HREF="../../../com/sleepycat/db/DeadlockException.html" title="class in com.sleepycat.db"><CODE>DeadlockException</CODE></A> to be thrown if data is modified
 692     between reading and writing it.
 693 <P>
 694 <DD><DL>
 695 </DL>
 696 </DD>
 697 <DD><DL>
 698 </DL>
 699 </DD>
 700 </DL>
 701 <HR>
 702
 703 <A NAME="getSnapshot()"><!-- --></A><H3>
 704 getSnapshot</H3>
 705 <PRE>
 706 public boolean <B>getSnapshot</B>()</PRE>
 707 <DL>
 708 <DD>Return true if the transaction is configured for Snapshot Isolation.
 709 <p>
 710 This method may be called at any time during the life of the application.
 711 <p>
 712 <P>
 713 <DD><DL>
 714 </DL>
 715 </DD>
 716 <DD><DL>
 717
 718 <DT><B>Returns:</B><DD>True if the transaction is configured for Snapshot Isolation.</DL>
 719 </DD>
 720 </DL>
 721 <HR>
 722
 723 <A NAME="setSync(boolean)"><!-- --></A><H3>
 724 setSync</H3>
 725 <PRE>
 726 public void <B>setSync</B>(boolean&nbsp;sync)</PRE>
 727 <DL>
 728 <DD>Configure the transaction to write and synchronously flush the log
 729     it when commits.
 730     <p>
 731     This behavior may be set for a database environment using the
 732     Environment.setMutableConfig method. Any value specified to this
 733     method overrides that setting.
 734     <p>
 735     The default is false for this class and true for the database
 736     environment.
 737     <p>
 738     If true is passed to both setSync and setNoSync, setSync will take
 739     precedence.
 740     <p>
 741 <P>
 742 <DD><DL>
 743 </DL>
 744 </DD>
 745 <DD><DL>
 746 <DT><B>Parameters:</B><DD><CODE>sync</CODE> - If true, transactions exhibit all the ACID (atomicity, consistency,
 747     isolation, and durability) properties.</DL>
 748 </DD>
 749 </DL>
 750 <HR>
 751
 752 <A NAME="getSync()"><!-- --></A><H3>
 753 getSync</H3>
 754 <PRE>
 755 public boolean <B>getSync</B>()</PRE>
 756 <DL>
 757 <DD>Return if the transaction is configured to write and synchronously
 758     flush the log it when commits.
 759     <p>
 760 <P>
 761 <DD><DL>
 762 </DL>
 763 </DD>
 764 <DD><DL>
 765
 766 <DT><B>Returns:</B><DD>If the transaction is configured to write and synchronously flush
 767     the log it when commits.</DL>
 768 </DD>
 769 </DL>
 770 <HR>
 771
 772 <A NAME="setWait(boolean)"><!-- --></A><H3>
 773 setWait</H3>
 774 <PRE>
 775 public void <B>setWait</B>(boolean&nbsp;wait)</PRE>
 776 <DL>
 777 <DD>Configure the transaction to wait if a lock request cannot be
 778     immediately granted.
 779     <p>
 780     The default is true unless <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnNoWait(boolean)"><CODE>EnvironmentConfig.setTxnNoWait(boolean)</CODE></A> is called.
 781     <p>
 782 <P>
 783 <DD><DL>
 784 </DL>
 785 </DD>
 786 <DD><DL>
 787 <DT><B>Parameters:</B><DD><CODE>wait</CODE> - If true, transactions will wait if a lock request cannot be
 788     immediately granted, instead <A HREF="../../../com/sleepycat/db/DeadlockException.html" title="class in com.sleepycat.db"><CODE>DeadlockException</CODE></A> will be thrown.</DL>
 789 </DD>
 790 </DL>
 791 <HR>
 792
 793 <A NAME="getWait()"><!-- --></A><H3>
 794 getWait</H3>
 795 <PRE>
 796 public boolean <B>getWait</B>()</PRE>
 797 <DL>
 798 <DD>Return if the transaction is configured to wait if a lock
 799     request cannot be immediately granted.
 800     <p>
 801 <P>
 802 <DD><DL>
 803 </DL>
 804 </DD>
 805 <DD><DL>
 806
 807 <DT><B>Returns:</B><DD>If the transaction is configured to wait if a lock request
 808     cannot be immediately granted.</DL>
 809 </DD>
 810 </DL>
 811 <HR>
 812
 813 <A NAME="setWriteNoSync(boolean)"><!-- --></A><H3>
 814 setWriteNoSync</H3>
 815 <PRE>
 816 public void <B>setWriteNoSync</B>(boolean&nbsp;writeNoSync)</PRE>
 817 <DL>
 818 <DD>Configure the transaction to write but not synchronously flush the log
 819     it when commits.
 820     <p>
 821     This behavior may be set for a database environment using the
 822     Environment.setMutableConfig method. Any value specified to this method
 823     overrides that setting.
 824     <p>
 825     The default is false for this class and the database environment.
 826     <p>
 827 <P>
 828 <DD><DL>
 829 </DL>
 830 </DD>
 831 <DD><DL>
 832 <DT><B>Parameters:</B><DD><CODE>writeNoSync</CODE> - If true, transactions exhibit the ACI (atomicity, consistency, and
 833     isolation) properties, but not D (durability); that is, database
 834     integrity will be maintained, but if the operating system
 835     fails, it is possible some number of the most recently committed
 836     transactions may be undone during recovery. The number of
 837     transactions at risk is governed by how often the operating system
 838     flushes dirty buffers to disk, and how often the log is
 839     checkpointed.</DL>
 840 </DD>
 841 </DL>
 842 <HR>
 843
 844 <A NAME="getWriteNoSync()"><!-- --></A><H3>
 845 getWriteNoSync</H3>
 846 <PRE>
 847 public boolean <B>getWriteNoSync</B>()</PRE>
 848 <DL>
 849 <DD>Return if the transaction is configured to write but not synchronously
 850     flush the log it when commits.
 851     <p>
 852 <P>
 853 <DD><DL>
 854 </DL>
 855 </DD>
 856 <DD><DL>
 857
 858 <DT><B>Returns:</B><DD>If the transaction is configured to not write or synchronously flush
 859     the log it when commits.</DL>
 860 </DD>
 861 </DL>
 862 <HR>
 863
 864 <A NAME="setBulk(boolean)"><!-- --></A><H3>
 865 setBulk</H3>
 866 <PRE>
 867 public void <B>setBulk</B>(boolean&nbsp;bulk)</PRE>
 868 <DL>
 869 <DD>Configures the transaction to enable the transactional bulk insert
 870     optimization.  When this attribute is set, the transaction will avoid
 871     logging the contents of insertions on newly allocated database pages.
 872     In a transaction that inserts a large number of new records, the I/O
 873     savings of choosing this option can be significant.  Users of this
 874     option should be aware of several issues.  When the optimization is in
 875     effect, page allocations that extend the database file are logged as
 876     usual; this allows transaction aborts to work correctly, both online
 877     and during recovery.  At commit time, the database's pages are flushed
 878     to disk, eliminating the need to roll-forward the transaction during
 879     normal recovery.  However, there are other recovery operations that
 880     depend on roll-forward, and care must be taken when Bulk-enabled
 881     transactions interact with them.  In particular, Bulk is
 882     incompatible with replication, and is simply ignored when replication
 883     is enabled.  Also, hot backup procedures must follow a particular
 884     protocol, introduced in 11gr2.5.1, to set a flag in the environment
 885     before starting to copy files.  It is especially important to note
 886     that incremental hot backups can be invalidated by use of the bulk
 887     insert optimization.  Please see the hot backup description in the
 888     <i>Getting Started with Transactions Guide</i>, and the description of the
 889     HotbackupInProgress attribute in
 890     <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html" title="class in com.sleepycat.db"><CODE>EnvironmentConfig</CODE></A>
 891     for further information.
 892     <p>
 893     The bulk insert optimization is effective only for
 894     top-level transactions.
 895     <p>
 896 <P>
 897 <DD><DL>
 898 </DL>
 899 </DD>
 900 <DD><DL>
 901 <DT><B>Parameters:</B><DD><CODE>bulk</CODE> - If true, configure the transaction to enable the bulk optimization.</DL>
 902 </DD>
 903 </DL>
 904 <HR>
 905
 906 <A NAME="getBulk()"><!-- --></A><H3>
 907 getBulk</H3>
 908 <PRE>
 909 public boolean <B>getBulk</B>()</PRE>
 910 <DL>
 911 <DD>Return true if the Bulk attribute is set.
 912     <p>
 913 <P>
 914 <DD><DL>
 915 </DL>
 916 </DD>
 917 <DD><DL>
 918
 919 <DT><B>Returns:</B><DD>The current setting of the Bulk attribute.</DL>
 920 </DD>
 921 </DL>
 922 <!-- ========= END OF CLASS DATA ========= -->
 923 <HR>
 924
 925
 926 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 927 <A NAME="navbar_bottom"><!-- --></A>
 928 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
 929 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
 930 <TR>
 931 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
 932 <A NAME="navbar_bottom_firstrow"><!-- --></A>
 933 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
 934   <TR ALIGN="center" VALIGN="top">
 935   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
 936   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 937   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 938   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransactionConfig.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
 939   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 940   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 941   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 942   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 943   </TR>
 944 </TABLE>
 945 </TD>
 946 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 947 <b>Berkeley DB</b><br><font size="-1"> version 5.3.21</font></EM>
 948 </TD>
 949 </TR>
 950
 951 <TR>
 952 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 953 &nbsp;<A HREF="../../../com/sleepycat/db/Transaction.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A>&nbsp;
 954 &nbsp;<A HREF="../../../com/sleepycat/db/TransactionStats.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD>
 955 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 956   <A HREF="../../../index.html?com/sleepycat/db/TransactionConfig.html" target="_top"><B>FRAMES</B></A>  &nbsp;
 957 &nbsp;<A HREF="TransactionConfig.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
 958 &nbsp;<SCRIPT type="text/javascript">
 959   <!--
 960   if(window==top) {
 961     document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
 962   }
 963   //-->
 964 </SCRIPT>
 965 <NOSCRIPT>
 966   <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
 967 </NOSCRIPT>
 968
 969
 970 </FONT></TD>
 971 </TR>
 972 <TR>
 973 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 974   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 975 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 976 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 977 </TR>
 978 </TABLE>
 979 <A NAME="skip-navbar_bottom"></A>
 980 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 981
 982 <HR>
 983 <font size=1>Copyright (c) 1996, 2012 Oracle and/or its affiliates.  All rights reserved.</font>
 984 </BODY>
 985 </HTML>