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