1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>Preface</title> 7 <link rel="stylesheet" href="gettingStarted.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" /> 10 <link rel="up" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" /> 11 <link rel="prev" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" /> 12 <link rel="next" href="introduction.html" title="Chapter��1.��Introduction" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Preface</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a>��</td> 22 <th width="60%" align="center">��</th> 23 <td width="20%" align="right">��<a accesskey="n" href="introduction.html">Next</a></td> 24 </tr> 25 </table> 26 <hr /> 27 </div> 28 <div class="preface" lang="en" xml:lang="en"> 29 <div class="titlepage"> 30 <div> 31 <div> 32 <h2 class="title"><a id="preface"></a>Preface</h2> 33 </div> 34 </div> 35 </div> 36 <div class="toc"> 37 <p> 38 <b>Table of Contents</b> 39 </p> 40 <dl> 41 <dt> 42 <span class="sect1"> 43 <a href="preface.html#conventions">Conventions Used in this Book</a> 44 </span> 45 </dt> 46 <dd> 47 <dl> 48 <dt> 49 <span class="sect2"> 50 <a href="preface.html#moreinfo">For More Information</a> 51 </span> 52 </dt> 53 </dl> 54 </dd> 55 </dl> 56 </div> 57 <p> 58 This document describes how to use transactions with your Berkeley DB 59 applications. It is intended to describe how to 60 transaction protect your application's data. The APIs used to perform this task 61 are described here, as are the environment infrastructure and administrative tasks 62 required by a transactional application. This book also 63 describes multi-threaded <span>and 64 multi-process</span> DB applications and the requirements they 65 have for deadlock detection. 66 </p> 67 <p> 68 This book describes for Berkeley DB version 4.8. 69 </p> 70 <p> 71 This book is aimed at the software engineer responsible for writing a 72 transactional DB application. 73 </p> 74 <p> 75 This book assumes that you have already read and understood the 76 concepts contained in the 77 <span><em class="citetitle">Getting Started with Berkeley DB</em> 78 guide.</span> 79 80 81 </p> 82 <div class="sect1" lang="en" xml:lang="en"> 83 <div class="titlepage"> 84 <div> 85 <div> 86 <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2> 87 </div> 88 </div> 89 </div> 90 <div class="toc"> 91 <dl> 92 <dt> 93 <span class="sect2"> 94 <a href="preface.html#moreinfo">For More Information</a> 95 </span> 96 </dt> 97 </dl> 98 </div> 99 <p> 100 The following typographical conventions are used within in this manual: 101 </p> 102 <p> 103 Class names are represented in <code class="classname">monospaced font</code>, as are <code class="methodname">method 104 names</code>. For example: 105 106 107 108 <span>"The <code class="methodname">Environment()</code> 109 constructor returns an <code class="classname">Environment</code> class object."</span> 110 111 112 </p> 113 <p> 114 Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your 115 <span class="emphasis"><em>DB_INSTALL</em></span> directory." 116 </p> 117 <p> 118 Program examples are displayed in a <code class="classname">monospaced font</code> on a shaded background. 119 For example: 120 </p> 121 <pre class="programlisting">import com.sleepycat.db.DatabaseConfig; 122 123... 124 125// Allow the database to be created. 126DatabaseConfig myDbConfig = new DatabaseConfig(); 127myDbConfig.setAllowCreate(true);</pre> 128 <p> 129 In some situations, programming examples are updated from one chapter to the next. When 130 this occurs, the new code is presented in <strong class="userinput"><code>monospaced bold</code></strong> font. For example: 131 </p> 132 <pre class="programlisting"><strong class="userinput"><code>import com.sleepycat.db.Database;</code></strong> 133import com.sleepycat.db.DatabaseConfig; 134 135... 136 137// Allow the database to be created. 138DatabaseConfig myDbConfig = new DatabaseConfig(); 139myDbConfig.setAllowCreate(true); 140<strong class="userinput"><code>Database myDb = new Database("mydb.db", null, myDbConfig);</code></strong> </pre> 141 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 142 <h3 class="title">Note</h3> 143 <p> 144 Finally, notes of special interest are represented using a note block such 145 as this. 146 </p> 147 </div> 148 <div class="sect2" lang="en" xml:lang="en"> 149 <div class="titlepage"> 150 <div> 151 <div> 152 <h3 class="title"><a id="moreinfo"></a>For More Information</h3> 153 </div> 154 </div> 155 </div> 156 <p> 157 Beyond this manual, you may also find the following sources of information useful when building a 158 transactional DB application: 159 </p> 160 <div class="itemizedlist"> 161 <ul type="disc"> 162 <li> 163 <p> 164 165 166 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg/JAVA/index.html" target="_top"> 167 Getting Started with Berkeley DB for Java 168 </a> 169 170 171 172 173 174 </p> 175 </li> 176 <li> 177 <p> 178 179 180 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_db_rep/JAVA/index.html" target="_top"> 181 Berkeley DB Getting Started with Replicated Applications for Java 182 </a> 183 </p> 184 </li> 185 <li> 186 <p> 187 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/index.html" target="_top"> 188 Berkeley DB Programmer's Reference Guide 189 </a> 190 </p> 191 </li> 192 <li> 193 <p> 194 <span> 195 196 197 </span> 198 199 200 201 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/java/index.html" target="_top"> 202 Berkeley DB Javadoc 203 </a> 204 205 206 </p> 207 </li> 208 <li> 209 <p> 210 211 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/collections/tutorial/index.html" target="_top"> 212 Berkeley DB Collections Tutorial 213 </a> 214 </p> 215 </li> 216 </ul> 217 </div> 218 </div> 219 </div> 220 </div> 221 <div class="navfooter"> 222 <hr /> 223 <table width="100%" summary="Navigation footer"> 224 <tr> 225 <td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a>��</td> 226 <td width="20%" align="center">��</td> 227 <td width="40%" align="right">��<a accesskey="n" href="introduction.html">Next</a></td> 228 </tr> 229 <tr> 230 <td width="40%" align="left" valign="top">Getting Started with Berkeley DB Transaction Processing��</td> 231 <td width="20%" align="center"> 232 <a accesskey="h" href="index.html">Home</a> 233 </td> 234 <td width="40%" align="right" valign="top">��Chapter��1.��Introduction</td> 235 </tr> 236 </table> 237 </div> 238 </body> 239</html> 240