<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (version 1.7.0_75) on Fri May 13 13:32:16 PDT 2016 -->
<title>DatabaseConfig (Oracle - Berkeley DB Java API)</title>
<meta name="date" content="2016-05-13">
<link rel="stylesheet" type="text/css" href="../../../style.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="DatabaseConfig (Oracle - Berkeley DB Java API)";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!-- -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/DatabaseConfig.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><em><b>Berkeley DB</b><br><font size="-1"> version 6.1.29</font></em></div>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?com/sleepycat/db/DatabaseConfig.html" target="_top">Frames</a></li>
<li><a href="DatabaseConfig.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary: </li>
<li>Nested | </li>
<li><a href="#field_summary">Field</a> | </li>
<li><a href="#constructor_summary">Constr</a> | </li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
<li><a href="#field_detail">Field</a> | </li>
<li><a href="#constructor_detail">Constr</a> | </li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">com.sleepycat.db</div>
<h2 title="Class DatabaseConfig" class="title">Class DatabaseConfig</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li>com.sleepycat.db.DatabaseConfig</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd>java.lang.Cloneable</dd>
</dl>
<dl>
<dt>Direct Known Subclasses:</dt>
<dd><a href="../../../com/sleepycat/db/SecondaryConfig.html" title="class in com.sleepycat.db">SecondaryConfig</a></dd>
</dl>
<hr>
<br>
<pre>public class <span class="strong">DatabaseConfig</span>
extends java.lang.Object
implements java.lang.Cloneable</pre>
<div class="block">Specify the attributes of a database.</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd"> </span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#DEFAULT">DEFAULT</a></strong></code>
<div class="block">An instance created using the default constructor is initialized
with the system's default settings.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#DatabaseConfig()">DatabaseConfig</a></strong>()</code>
<div class="block">An instance created using the default constructor is initialized with
the system's default settings.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd"> </span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#cloneConfig()">cloneConfig</a></strong>()</code>
<div class="block">Returns a copy of this configuration object.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getAllowCreate()">getAllowCreate</a></strong>()</code>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to create the database if it does not already exist.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.io.File</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBlobDir()">getBlobDir</a></strong>()</code>
<div class="block">Returns the path of a directory where blobs are stored.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBlobThreshold()">getBlobThreshold</a></strong>()</code>
<div class="block">Return the threshold value in bytes beyond which data items are
stored as blobs.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.util.Comparator</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeComparator()">getBtreeComparator</a></strong>()</code>
<div class="block">Return the custom Comparator used for btree keys.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeCompressor()">getBtreeCompressor</a></strong>()</code>
<div class="block">Get the Btree compression callbacks.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeMinKey()">getBtreeMinKey</a></strong>()</code>
<div class="block">Return the minimum number of key/data pairs intended to be stored
on any single Btree leaf page.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBtreePrefixCalculator()">getBtreePrefixCalculator</a></strong>()</code>
<div class="block">Return the Btree prefix callback.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeRecordNumbers()">getBtreeRecordNumbers</a></strong>()</code>
<div class="block">Return true if the Btree is configured to support retrieval by record number.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getByteOrder()">getByteOrder</a></strong>()</code>
<div class="block">Return the database byte order; a byte order of 4,321 indicates a
big endian order, and a byte order of 1,234 indicates a little
endian order.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getByteSwapped()">getByteSwapped</a></strong>()</code>
<div class="block">Return if the underlying database files were created on an architecture
of the same byte order as the current one.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getCacheCount()">getCacheCount</a></strong>()</code>
<div class="block">Return the number of shared memory buffer pools, that is, the number
of caches.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getCacheSize()">getCacheSize</a></strong>()</code>
<div class="block">Return the size of the shared memory buffer pool, that is, the cache.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getChecksum()">getChecksum</a></strong>()</code>
<div class="block">Return true if the database environment is configured to do checksum
verification of pages read into the cache from the backing
filestore.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.io.File</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getCreateDir()">getCreateDir</a></strong>()</code>
<div class="block">Return the directory a database will/has been created in or looked for.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getDirtyRead()">getDirtyRead</a></strong>()</code>
<div class="block"><strong>Deprecated.</strong>
<div class="block"><i>This has been replaced by <a href="../../../com/sleepycat/db/DatabaseConfig.html#getReadUncommitted()"><code>getReadUncommitted()</code></a> to conform to ANSI
database isolation terminology.</i></div>
</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.util.Comparator</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getDuplicateComparator()">getDuplicateComparator</a></strong>()</code>
<div class="block">Return the duplicate data item comparison callback.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getEncrypted()">getEncrypted</a></strong>()</code>
<div class="block">Return true if the database has been configured to perform encryption.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getErrorHandler()">getErrorHandler</a></strong>()</code>
<div class="block">Return the function to be called if an error occurs.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>java.lang.String</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getErrorPrefix()">getErrorPrefix</a></strong>()</code>
<div class="block">Return the prefix string that appears before error messages.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.io.OutputStream</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getErrorStream()">getErrorStream</a></strong>()</code>
<div class="block">Return the an OutputStream for displaying error messages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getExclusiveCreate()">getExclusiveCreate</a></strong>()</code>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to fail if the database already exists.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getFeedbackHandler()">getFeedbackHandler</a></strong>()</code>
<div class="block">Return the object's methods to be called to provide feedback.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>java.util.Comparator</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHashComparator()">getHashComparator</a></strong>()</code>
<div class="block">Return the Comparator used to compare keys in a Hash database.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHasher()">getHasher</a></strong>()</code>
<div class="block">Return the database-specific hash function.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHashFillFactor()">getHashFillFactor</a></strong>()</code>
<div class="block">Return the hash table density.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHashNumElements()">getHashNumElements</a></strong>()</code>
<div class="block">Return the estimate of the final size of the hash table.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHeapRegionSize()">getHeapRegionSize</a></strong>()</code>
<div class="block">Return the number of pages in a region of the database.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getHeapsize()">getHeapsize</a></strong>()</code>
<div class="block">Return the maximum on-disk database file size.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getMessageHandler()">getMessageHandler</a></strong>()</code>
<div class="block">Return the function to be called with an informational message.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.io.OutputStream</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getMessageStream()">getMessageStream</a></strong>()</code>
<div class="block">Return the an OutputStream for displaying informational messages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>long</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getMode()">getMode</a></strong>()</code>
<div class="block">Return the mode used to create files.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getMultiversion()">getMultiversion</a></strong>()</code>
<div class="block">Return true if the database is configured for multiversion concurrency control.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getNoMMap()">getNoMMap</a></strong>()</code>
<div class="block">Return true if the library is configured to not map this database into
memory.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.lang.Boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getNoWaitDbExclusiveLock()">getNoWaitDbExclusiveLock</a></strong>()</code>
<div class="block">Return whether the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle is
configured to obtain a write lock on the entire database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPageSize()">getPageSize</a></strong>()</code>
<div class="block">Return the size of the pages used to hold items in the database, in bytes.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPanicHandler()">getPanicHandler</a></strong>()</code>
<div class="block">Return the function to be called if the database environment panics.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>java.io.File[]</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionDirs()">getPartitionDirs</a></strong>()</code>
<div class="block">Return the array of directories the database extents should be created in or
looked for.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionHandler()">getPartitionHandler</a></strong>()</code>
<div class="block">Return the function to be called to determine which partition a key resides in.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionKeys()">getPartitionKeys</a></strong>()</code>
<div class="block">Return the array of keys the database is configured to partition with.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionParts()">getPartitionParts</a></strong>()</code>
<div class="block">Return the number of partitions the database is configured for.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getPriority()">getPriority</a></strong>()</code>
<div class="block">Return the the cache priority for pages referenced by this handle.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getQueueExtentSize()">getQueueExtentSize</a></strong>()</code>
<div class="block">Return the size of the extents used to hold pages in a Queue database,
specified as a number of pages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getQueueInOrder()">getQueueInOrder</a></strong>()</code>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> method is configured to return
key/data pairs in order, always returning the key/data item from the
head of the queue.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getReadOnly()">getReadOnly</a></strong>()</code>
<div class="block">Return true if the database is configured in read-only mode.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getReadUncommitted()">getReadUncommitted</a></strong>()</code>
<div class="block">Return true if the database is configured to support read uncommitted.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRecordDelimiter()">getRecordDelimiter</a></strong>()</code>
<div class="block">Return the delimiting byte used to mark the end of a record in the
backing source file for the Recno access method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRecordLength()">getRecordLength</a></strong>()</code>
<div class="block">Return the database record length, in bytes.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRecordNumberAppender()">getRecordNumberAppender</a></strong>()</code>
<div class="block">Return the function to call after the record number has been
selected but before the data has been stored into the database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRecordPad()">getRecordPad</a></strong>()</code>
<div class="block">Return the padding character for short, fixed-length records for the
Queue and Recno access methods.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>java.io.File</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRecordSource()">getRecordSource</a></strong>()</code>
<div class="block">Return the name of an underlying flat text database file that is
read to initialize a transient record number index.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getRenumbering()">getRenumbering</a></strong>()</code>
<div class="block">Return true if the logical record numbers are mutable, and change as
records are added to and deleted from the database.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getReverseSplitOff()">getReverseSplitOff</a></strong>()</code>
<div class="block">Return true if the Btree has been configured to not do reverse splits.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getSnapshot()">getSnapshot</a></strong>()</code>
<div class="block">Return true if the any specified backing source file will be read in its
entirety when the database is opened.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getSortedDuplicates()">getSortedDuplicates</a></strong>()</code>
<div class="block">Return true if the database is configured to support sorted duplicate data
items.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getTransactional()">getTransactional</a></strong>()</code>
<div class="block">Return true if the database open is enclosed within a transaction.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getTransactionNotDurable()">getTransactionNotDurable</a></strong>()</code>
<div class="block">Return true if the database environment is configured to not write log
records for this database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getTruncate()">getTruncate</a></strong>()</code>
<div class="block">Return true if the database has been configured to be physically truncated
by truncating the underlying file, discarding all previous databases
it might have held.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</a></code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getType()">getType</a></strong>()</code>
<div class="block">Return the type of the database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#getUnsortedDuplicates()">getUnsortedDuplicates</a></strong>()</code>
<div class="block">Return true if the database is configured to support duplicate data items.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setAllowCreate(boolean)">setAllowCreate</a></strong>(boolean allowCreate)</code>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to create
the database if it does not already exist.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBlobDir(java.io.File)">setBlobDir</a></strong>(java.io.File dir)</code>
<div class="block">Sets the path of a directory where blobs are stored.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBlobThreshold(int)">setBlobThreshold</a></strong>(int value)</code>
<div class="block">Set the size in bytes which is used to determine when a data item will be
stored as a blob.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeComparator(java.util.Comparator)">setBtreeComparator</a></strong>(java.util.Comparator btreeComparator)</code>
<div class="block">By default, a byte by byte lexicographic comparison is used for
btree keys.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeCompressor(com.sleepycat.db.BtreeCompressor)">setBtreeCompressor</a></strong>(<a href="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</a> btreeCompressor)</code>
<div class="block">Set the Btree compression callbacks.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeMinKey(int)">setBtreeMinKey</a></strong>(int btMinKey)</code>
<div class="block">Set the minimum number of key/data pairs intended to be stored on any
single Btree leaf page.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBtreePrefixCalculator(com.sleepycat.db.BtreePrefixCalculator)">setBtreePrefixCalculator</a></strong>(<a href="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</a> btreePrefixCalculator)</code>
<div class="block">Set the Btree prefix callback.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeRecordNumbers(boolean)">setBtreeRecordNumbers</a></strong>(boolean btreeRecordNumbers)</code>
<div class="block">Configure the Btree to support retrieval by record number.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setByteOrder(int)">setByteOrder</a></strong>(int byteOrder)</code>
<div class="block">Set the byte order for integers in the stored database metadata.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setCacheCount(int)">setCacheCount</a></strong>(int cacheCount)</code>
<div class="block">Set the number of shared memory buffer pools, that is, the number of
caches.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setCacheSize(long)">setCacheSize</a></strong>(long cacheSize)</code>
<div class="block">Set the size of the shared memory buffer pool, that is, the size of the
cache.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setChecksum(boolean)">setChecksum</a></strong>(boolean checksum)</code>
<div class="block">Configure the database environment to do checksum verification of
pages read into the cache from the backing filestore.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setCreateDir(java.io.File)">setCreateDir</a></strong>(java.io.File createDir)</code>
<div class="block">Specify which directory a database should be created in or looked for.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setDirtyRead(boolean)">setDirtyRead</a></strong>(boolean dirtyRead)</code>
<div class="block"><strong>Deprecated.</strong>
<div class="block"><i>This has been replaced by <a href="../../../com/sleepycat/db/DatabaseConfig.html#setReadUncommitted(boolean)"><code>setReadUncommitted(boolean)</code></a> to conform to ANSI
database isolation terminology.</i></div>
</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setDuplicateComparator(java.util.Comparator)">setDuplicateComparator</a></strong>(java.util.Comparator duplicateComparator)</code>
<div class="block">Set the duplicate data item comparison callback.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setEncrypted(java.lang.String)">setEncrypted</a></strong>(java.lang.String password)</code>
<div class="block">Set the password used to perform encryption and decryption.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)">setErrorHandler</a></strong>(<a href="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</a> errorHandler)</code>
<div class="block">Set the function to be called if an error occurs.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorPrefix(java.lang.String)">setErrorPrefix</a></strong>(java.lang.String errorPrefix)</code>
<div class="block">Set the prefix string that appears before error messages.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)">setErrorStream</a></strong>(java.io.OutputStream errorStream)</code>
<div class="block">Set an OutputStream for displaying error messages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setExclusiveCreate(boolean)">setExclusiveCreate</a></strong>(boolean exclusiveCreate)</code>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to fail if
the database already exists.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setFeedbackHandler(com.sleepycat.db.FeedbackHandler)">setFeedbackHandler</a></strong>(<a href="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</a> feedbackHandler)</code>
<div class="block">Set an object whose methods are called to provide feedback.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHashComparator(java.util.Comparator)">setHashComparator</a></strong>(java.util.Comparator hashComparator)</code>
<div class="block">Set the Hash key comparison function.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHasher(com.sleepycat.db.Hasher)">setHasher</a></strong>(<a href="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</a> hasher)</code>
<div class="block">Set a database-specific hash function.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHashFillFactor(int)">setHashFillFactor</a></strong>(int hashFillFactor)</code>
<div class="block">Set the desired density within the hash table.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHashNumElements(int)">setHashNumElements</a></strong>(int hashNumElements)</code>
<div class="block">Set an estimate of the final size of the hash table.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHeapRegionSize(int)">setHeapRegionSize</a></strong>(int npages)</code>
<div class="block">Sets the number of pages in a region of a database configured to use
the Heap access method.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setHeapsize(long)">setHeapsize</a></strong>(long bytes)</code>
<div class="block">Set the maximum on-disk database file size used by a database configured to
use the Heap access method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)">setMessageHandler</a></strong>(<a href="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</a> messageHandler)</code>
<div class="block">Set a function to be called with an informational message.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)">setMessageStream</a></strong>(java.io.OutputStream messageStream)</code>
<div class="block">Set an OutputStream for displaying informational messages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setMode(int)">setMode</a></strong>(int mode)</code>
<div class="block">On UNIX systems or in IEEE/ANSI Std 1003.1 (POSIX) environments, files
created by the database open are created with mode <code>mode</code>
(as described in the <code>chmod</code>(2) manual page) and modified
by the process' umask value at the time of creation (see the
<code>umask</code>(2) manual page).</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setMsgfile(java.io.File)">setMsgfile</a></strong>(java.io.File file)</code>
<div class="block">Sets the path of a file to store statistical information.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setMultiversion(boolean)">setMultiversion</a></strong>(boolean multiversion)</code>
<div class="block">Configured the database with support for multiversion concurrency control.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setNoMMap(boolean)">setNoMMap</a></strong>(boolean noMMap)</code>
<div class="block">Configure the library to not map this database into memory.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setNoWaitDbExclusiveLock(java.lang.Boolean)">setNoWaitDbExclusiveLock</a></strong>(java.lang.Boolean noWaitDbExclLock)</code>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle to obtain a
write lock on the entire database.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPageSize(int)">setPageSize</a></strong>(int pageSize)</code>
<div class="block">Set the size of the pages used to hold items in the database, in bytes.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPanicHandler(com.sleepycat.db.PanicHandler)">setPanicHandler</a></strong>(<a href="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</a> panicHandler)</code>
<div class="block">Set the function to be called if the database environment panics.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionByCallback(int,%20com.sleepycat.db.PartitionHandler)">setPartitionByCallback</a></strong>(int parts,
<a href="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</a> partitionHandler)</code>
<div class="block">Enable or disable database partitioning, and set the callback that will
be used for the partitioning.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionByRange(int,%20com.sleepycat.db.MultipleDataEntry)">setPartitionByRange</a></strong>(int parts,
<a href="../../../com/sleepycat/db/MultipleDataEntry.html" title="class in com.sleepycat.db">MultipleDataEntry</a> keys)</code>
<div class="block">Enable or disable database partitioning, and set key ranges that will be
used for the partitioning.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionDirs(java.io.File[])">setPartitionDirs</a></strong>(java.io.File[] dirs)</code>
<div class="block">Specify the array of directories the database extents should be created in or
looked for.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setPriority(com.sleepycat.db.CacheFilePriority)">setPriority</a></strong>(<a href="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a> priority)</code>
<div class="block">Set the cache priority for pages referenced by the DB handle.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setQueueExtentSize(int)">setQueueExtentSize</a></strong>(int queueExtentSize)</code>
<div class="block">Set the size of the extents used to hold pages in a Queue database,
specified as a number of pages.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setQueueInOrder(boolean)">setQueueInOrder</a></strong>(boolean queueInOrder)</code>
<div class="block">Configure <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> to return key/data pairs in
order, always returning the key/data item from the head of the
queue.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setReadOnly(boolean)">setReadOnly</a></strong>(boolean readOnly)</code>
<div class="block">Configure the database in read-only mode.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setReadUncommitted(boolean)">setReadUncommitted</a></strong>(boolean readUncommitted)</code>
<div class="block">Configure the database to support read uncommitted.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordDelimiter(int)">setRecordDelimiter</a></strong>(int recordDelimiter)</code>
<div class="block">Set the delimiting byte used to mark the end of a record in the backing
source file for the Recno access method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordLength(int)">setRecordLength</a></strong>(int recordLength)</code>
<div class="block">Specify the database record length, in bytes.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordNumberAppender(com.sleepycat.db.RecordNumberAppender)">setRecordNumberAppender</a></strong>(<a href="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</a> recnoAppender)</code>
<div class="block">Configure <a href="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry)"><code>Database.append</code></a> to call the function after the
record number has been selected but before the data has been stored
into the database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordPad(int)">setRecordPad</a></strong>(int recordPad)</code>
<div class="block">Set the padding character for short, fixed-length records for the Queue
and Recno access methods.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordSource(java.io.File)">setRecordSource</a></strong>(java.io.File recordSource)</code>
<div class="block">Set the underlying source file for the Recno access method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setRenumbering(boolean)">setRenumbering</a></strong>(boolean renumbering)</code>
<div class="block">Configure the logical record numbers to be mutable, and change as
records are added to and deleted from the database.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setReverseSplitOff(boolean)">setReverseSplitOff</a></strong>(boolean reverseSplitOff)</code>
<div class="block">Configure the Btree to not do reverse splits.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setSnapshot(boolean)">setSnapshot</a></strong>(boolean snapshot)</code>
<div class="block">Specify that any specified backing source file be read in its entirety
when the database is opened.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setSortedDuplicates(boolean)">setSortedDuplicates</a></strong>(boolean sortedDuplicates)</code>
<div class="block">Configure the database to support sorted, duplicate data items.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setTransactional(boolean)">setTransactional</a></strong>(boolean transactional)</code>
<div class="block">Enclose the database open within a transaction.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setTransactionNotDurable(boolean)">setTransactionNotDurable</a></strong>(boolean transactionNotDurable)</code>
<div class="block">Configure the database environment to not write log records for this
database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setTruncate(boolean)">setTruncate</a></strong>(boolean truncate)</code>
<div class="block">Configure the database to be physically truncated by truncating the
underlying file, discarding all previous databases it might have
held.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setType(com.sleepycat.db.DatabaseType)">setType</a></strong>(<a href="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</a> type)</code>
<div class="block">Configure the type of the database.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../com/sleepycat/db/DatabaseConfig.html#setUnsortedDuplicates(boolean)">setUnsortedDuplicates</a></strong>(boolean unsortedDuplicates)</code>
<div class="block">Configure the database to support unsorted duplicate data items.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a name="DEFAULT">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>DEFAULT</h4>
<pre>public static final <a href="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</a> DEFAULT</pre>
<div class="block">An instance created using the default constructor is initialized
with the system's default settings.</div>
</li>
</ul>
</li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="DatabaseConfig()">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>DatabaseConfig</h4>
<pre>public DatabaseConfig()</pre>
<div class="block">An instance created using the default constructor is initialized with
the system's default settings.</div>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="cloneConfig()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>cloneConfig</h4>
<pre>public <a href="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</a> cloneConfig()</pre>
<div class="block">Returns a copy of this configuration object.</div>
</li>
</ul>
<a name="setAllowCreate(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setAllowCreate</h4>
<pre>public void setAllowCreate(boolean allowCreate)</pre>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to create
the database if it does not already exist.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>allowCreate</code> - If true, configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to
create the database if it does not already exist.</dd></dl>
</li>
</ul>
<a name="getAllowCreate()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getAllowCreate</h4>
<pre>public boolean getAllowCreate()</pre>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to create the database if it does not already exist.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to create the database if it does not already exist.</dd></dl>
</li>
</ul>
<a name="setBlobDir(java.io.File)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBlobDir</h4>
<pre>public void setBlobDir(java.io.File dir)</pre>
<div class="block">Sets the path of a directory where blobs are stored.
<p>
If the database is opened within an environment, this path setting is
ignored in
<a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a>.
Use <a href="../../../com/sleepycat/db/Database.html#getConfig()"><code>Database.getConfig</code></a> and
<a href="../../../com/sleepycat/db/DatabaseConfig.html#getBlobDir()"><code>DatabaseConfig.getBlobDir</code></a>
to identify the current storage location of blobs after opening
the database.
<p>
This path can not be set after opening the database.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>dir</code> - The path of a directory where blobs are stored.</dd></dl>
</li>
</ul>
<a name="getBlobDir()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBlobDir</h4>
<pre>public java.io.File getBlobDir()</pre>
<div class="block">Returns the path of a directory where blobs are stored.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The path of a directory where blobs are stored.</dd></dl>
</li>
</ul>
<a name="setBlobThreshold(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBlobThreshold</h4>
<pre>public void setBlobThreshold(int value)</pre>
<div class="block">Set the size in bytes which is used to determine when a data item will be
stored as a blob.
<p>
Any data item that is equal to or larger in size than the
threshold value will automatically be stored as a blob.
<p>
It is illegal to enable blob in the database which is configured
as in-memory database or with chksum, encryption, duplicates, sorted
duplicates, compression, multiversion concurrency control and
transactional read operations with degree 1 isolation.
<p>
This threshold value can not be set after opening the database.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - The size in bytes which is used to determine when a data item will be
stored as a blob. If 0, blob will be never used by the database.</dd></dl>
</li>
</ul>
<a name="getBlobThreshold()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBlobThreshold</h4>
<pre>public int getBlobThreshold()</pre>
<div class="block">Return the threshold value in bytes beyond which data items are
stored as blobs.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The threshold value in bytes beyond which data items are
stored as blobs. If 0, blob is not used by the database.</dd></dl>
</li>
</ul>
<a name="setBtreeComparator(java.util.Comparator)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBtreeComparator</h4>
<pre>public void setBtreeComparator(java.util.Comparator btreeComparator)</pre>
<div class="block">By default, a byte by byte lexicographic comparison is used for
btree keys. To customize the comparison, supply a different
Comparator.
<p>
The <code>compare</code> method is passed the byte arrays representing
keys that are stored in the database. If you know how your data is
organized in the byte array, then you can write a comparison routine that
directly examines the contents of the arrays. Otherwise, you have to
reconstruct your original objects, and then perform the comparison.</div>
</li>
</ul>
<a name="getBtreeComparator()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBtreeComparator</h4>
<pre>public java.util.Comparator getBtreeComparator()</pre>
<div class="block">Return the custom Comparator used for btree keys.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>the custom Comparator used for btree keys, or null if the default
comparison function will be used.</dd></dl>
</li>
</ul>
<a name="setBtreeMinKey(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBtreeMinKey</h4>
<pre>public void setBtreeMinKey(int btMinKey)</pre>
<div class="block">Set the minimum number of key/data pairs intended to be stored on any
single Btree leaf page.
<p>
This value is used to determine if key or data items will be stored
on overflow pages instead of Btree leaf pages. The value must be
at least 2; if the value is not explicitly set, a value of 2 is used.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>btMinKey</code> - The minimum number of key/data pairs intended to be stored on any
single Btree leaf page.</dd></dl>
</li>
</ul>
<a name="getBtreeMinKey()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBtreeMinKey</h4>
<pre>public int getBtreeMinKey()</pre>
<div class="block">Return the minimum number of key/data pairs intended to be stored
on any single Btree leaf page.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The minimum number of key/data pairs intended to be stored
on any single Btree leaf page.</dd></dl>
</li>
</ul>
<a name="setByteOrder(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setByteOrder</h4>
<pre>public void setByteOrder(int byteOrder)</pre>
<div class="block">Set the byte order for integers in the stored database metadata.
<p>
The host byte order of the machine where the process is running will
be used if no byte order is set.
<p>
<b>
The access methods provide no guarantees about the byte ordering of the
application data stored in the database, and applications are
responsible for maintaining any necessary ordering.
</b>
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
If creating additional databases in a single physical file, information
specified to this method will be ignored and the byte order of the
existing databases will be used.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>byteOrder</code> - The byte order as an integer; for example, big endian order is the
number 4,321, and little endian order is the number 1,234.</dd></dl>
</li>
</ul>
<a name="getByteOrder()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByteOrder</h4>
<pre>public int getByteOrder()</pre>
<div class="block">Return the database byte order; a byte order of 4,321 indicates a
big endian order, and a byte order of 1,234 indicates a little
endian order.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The database byte order; a byte order of 4,321 indicates a
big endian order, and a byte order of 1,234 indicates a little
endian order.</dd></dl>
</li>
</ul>
<a name="getByteSwapped()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByteSwapped</h4>
<pre>public boolean getByteSwapped()</pre>
<div class="block">Return if the underlying database files were created on an architecture
of the same byte order as the current one.
<p>
This information may be used to determine whether application data
needs to be adjusted for this architecture or not.
<p>
This method may not be called before the
database has been opened.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>Return false if the underlying database files were created on an
architecture of the same byte order as the current one, and true if
they were not (that is, big-endian on a little-endian machine, or
vice versa).</dd></dl>
</li>
</ul>
<a name="setBtreeCompressor(com.sleepycat.db.BtreeCompressor)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBtreeCompressor</h4>
<pre>public void setBtreeCompressor(<a href="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</a> btreeCompressor)</pre>
<div class="block">Set the Btree compression callbacks.</div>
</li>
</ul>
<a name="getBtreeCompressor()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBtreeCompressor</h4>
<pre>public <a href="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</a> getBtreeCompressor()</pre>
<div class="block">Get the Btree compression callbacks.</div>
</li>
</ul>
<a name="setBtreePrefixCalculator(com.sleepycat.db.BtreePrefixCalculator)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBtreePrefixCalculator</h4>
<pre>public void setBtreePrefixCalculator(<a href="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</a> btreePrefixCalculator)</pre>
<div class="block">Set the Btree prefix callback. The prefix callback is used to determine
the amount by which keys stored on the Btree internal pages can be
safely truncated without losing their uniqueness. See the
<a href="../../../../programmer_reference/bt_conf.html#am_conf_bt_prefix" target="_top">Btree prefix
comparison</a> section of the Berkeley DB Reference Guide for more
details about how this works. The usefulness of this is data-dependent,
but can produce significantly reduced tree sizes and search times in
some data sets.
<p>
If no prefix callback or key comparison callback is specified by the
application, a default lexical comparison function is used to calculate
prefixes. If no prefix callback is specified and a key comparison
callback is specified, no prefix function is used. It is an error to
specify a prefix function without also specifying a Btree key comparison
function.</div>
</li>
</ul>
<a name="getBtreePrefixCalculator()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBtreePrefixCalculator</h4>
<pre>public <a href="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</a> getBtreePrefixCalculator()</pre>
<div class="block">Return the Btree prefix callback.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The Btree prefix callback.</dd></dl>
</li>
</ul>
<a name="setCacheSize(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setCacheSize</h4>
<pre>public void setCacheSize(long cacheSize)</pre>
<div class="block">Set the size of the shared memory buffer pool, that is, the size of the
cache.
<p>
The cache should be the size of the normal working data set of the
application, with some small amount of additional memory for unusual
situations. (Note: the working set is not the same as the number of
pages accessed simultaneously, and is usually much larger.)
<p>
The default cache size is 256KB, and may not be specified as less than
20KB. Any cache size less than 500MB is automatically increased by 25%
to account for buffer pool overhead; cache sizes larger than 500MB are
used as specified. The current maximum size of a single cache is 4GB.
(All sizes are in powers-of-two, that is, 256KB is 2^18 not 256,000.)
<p>
Because databases opened within database environments use the cache
specified to the environment, it is an error to attempt to configure a
cache size in a database created within an environment.
<p>
This method may not be called after the database is opened.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>cacheSize</code> - The size of the shared memory buffer pool, that is, the size of the
cache.
<p>
<p></dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl>
</li>
</ul>
<a name="getCacheSize()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getCacheSize</h4>
<pre>public long getCacheSize()</pre>
<div class="block">Return the size of the shared memory buffer pool, that is, the cache.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The size of the shared memory buffer pool, that is, the cache.</dd></dl>
</li>
</ul>
<a name="setCreateDir(java.io.File)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setCreateDir</h4>
<pre>public void setCreateDir(java.io.File createDir)</pre>
<div class="block">Specify which directory a database should be created in or looked for.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>createDir</code> - The directory will be used to create or locate the database file specified in
the openDatabase method call. The directory must be one of the directories
in the environment list specified by EnvironmentConfig.addDataDirectory.
<p>
<p></dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl>
</li>
</ul>
<a name="getCreateDir()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getCreateDir</h4>
<pre>public java.io.File getCreateDir()</pre>
<div class="block">Return the directory a database will/has been created in or looked for.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The directory a database will/has been created in or looked for.</dd></dl>
</li>
</ul>
<a name="setCacheCount(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setCacheCount</h4>
<pre>public void setCacheCount(int cacheCount)</pre>
<div class="block">Set the number of shared memory buffer pools, that is, the number of
caches.
<p>
It is possible to specify caches larger than 4GB and/or large enough
they cannot be allocated contiguously on some architectures. For
example, some releases of Solaris limit the amount of memory that may
be allocated contiguously by a process. This method allows applications
to break the cache broken up into a number of equally sized, separate
pieces of memory.
<p>
<p>
Because databases opened within database environments use the cache
specified to the environment, it is an error to attempt to configure
multiple caches in a database created within an environment.
<p>
This method may not be called after the database is opened.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>cacheCount</code> - The number of shared memory buffer pools, that is, the number of caches.
<p>
<p></dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd></dl>
</li>
</ul>
<a name="getCacheCount()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getCacheCount</h4>
<pre>public int getCacheCount()</pre>
<div class="block">Return the number of shared memory buffer pools, that is, the number
of caches.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The number of shared memory buffer pools, that is, the number
of caches.</dd></dl>
</li>
</ul>
<a name="setChecksum(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setChecksum</h4>
<pre>public void setChecksum(boolean checksum)</pre>
<div class="block">Configure the database environment to do checksum verification of
pages read into the cache from the backing filestore.
<p>
Berkeley DB uses the SHA1 Secure Hash Algorithm if encryption is
also configured for this database, and a general hash algorithm if
it is not.
<p>
Calling this method only affects the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle
(and any other library handles opened within the scope of that handle).
<p>
If the database already exists when the database is opened, any database
configuration specified by this method
will be ignored.
If creating additional databases in a file, the checksum behavior
specified must be consistent with the existing databases in the file or
an error will be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>checksum</code> - If true, configure the database environment to do checksum verification
of pages read into the cache from the backing filestore.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getChecksum()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getChecksum</h4>
<pre>public boolean getChecksum()</pre>
<div class="block">Return true if the database environment is configured to do checksum
verification of pages read into the cache from the backing
filestore.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database environment is configured to do checksum
verification of pages read into the cache from the backing
filestore.</dd></dl>
</li>
</ul>
<a name="setReadUncommitted(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setReadUncommitted</h4>
<pre>public void setReadUncommitted(boolean readUncommitted)</pre>
<div class="block">Configure the database to support read uncommitted.
<p>
Read operations on the database may request the return of modified
but not yet committed data. This flag must be specified on all
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles used to perform read uncommitted or database
updates, otherwise requests for read uncommitted may not be honored and
the read may block.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>readUncommitted</code> - If true, configure the database to support read uncommitted.</dd></dl>
</li>
</ul>
<a name="getReadUncommitted()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getReadUncommitted</h4>
<pre>public boolean getReadUncommitted()</pre>
<div class="block">Return true if the database is configured to support read uncommitted.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured to support read uncommitted.</dd></dl>
</li>
</ul>
<a name="setDirtyRead(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setDirtyRead</h4>
<pre>public void setDirtyRead(boolean dirtyRead)</pre>
<div class="block"><span class="strong">Deprecated.</span> <i>This has been replaced by <a href="../../../com/sleepycat/db/DatabaseConfig.html#setReadUncommitted(boolean)"><code>setReadUncommitted(boolean)</code></a> to conform to ANSI
database isolation terminology.</i></div>
<div class="block">Configure the database to support read uncommitted.
<p>
Read operations on the database may request the return of modified
but not yet committed data. This flag must be specified on all
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles used to perform read uncommitted or database
updates, otherwise requests for read uncommitted may not be honored and
the read may block.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>dirtyRead</code> - If true, configure the database to support read uncommitted.
<p></dd></dl>
</li>
</ul>
<a name="getDirtyRead()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDirtyRead</h4>
<pre>public boolean getDirtyRead()</pre>
<div class="block"><span class="strong">Deprecated.</span> <i>This has been replaced by <a href="../../../com/sleepycat/db/DatabaseConfig.html#getReadUncommitted()"><code>getReadUncommitted()</code></a> to conform to ANSI
database isolation terminology.</i></div>
<div class="block">Return true if the database is configured to support read uncommitted.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured to support read uncommitted.
<p></dd></dl>
</li>
</ul>
<a name="setDuplicateComparator(java.util.Comparator)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setDuplicateComparator</h4>
<pre>public void setDuplicateComparator(java.util.Comparator duplicateComparator)</pre>
<div class="block">Set the duplicate data item comparison callback. The comparison
function is called whenever it is necessary to compare a data item
specified by the application with a data item currently stored in the
database. This comparator is only used if
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setSortedDuplicates(boolean)"><code>DatabaseConfig.setSortedDuplicates</code></a> is also configured.
<p>
If no comparison function is specified, the data items are compared
lexically, with shorter data items collating before longer data items.
<p>
The <code>compare</code> method is passed the byte arrays representing
data items in the database. If you know how your data is organized in
the byte array, then you can write a comparison routine that directly
examines the contents of the arrays. Otherwise, you have to
reconstruct your original objects, and then perform the comparison.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>duplicateComparator</code> - the comparison callback for duplicate data items.</dd></dl>
</li>
</ul>
<a name="getDuplicateComparator()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDuplicateComparator</h4>
<pre>public java.util.Comparator getDuplicateComparator()</pre>
<div class="block">Return the duplicate data item comparison callback.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>the duplicate data item Comparator, or null if the default Comparator
will be used.</dd></dl>
</li>
</ul>
<a name="setEncrypted(java.lang.String)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setEncrypted</h4>
<pre>public void setEncrypted(java.lang.String password)</pre>
<div class="block">Set the password used to perform encryption and decryption.
<p>
Because databases opened within environments use the password
specified to the environment, it is an error to attempt to set a
password in a database created within an environment.
<p>
Berkeley DB uses the Rijndael/AES (also known as the Advanced
Encryption Standard and Federal Information Processing
Standard (FIPS) 197) algorithm for encryption or decryption.</div>
</li>
</ul>
<a name="getEncrypted()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getEncrypted</h4>
<pre>public boolean getEncrypted()</pre>
<div class="block">Return true if the database has been configured to perform encryption.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database has been configured to perform encryption.</dd></dl>
</li>
</ul>
<a name="setErrorHandler(com.sleepycat.db.ErrorHandler)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setErrorHandler</h4>
<pre>public void setErrorHandler(<a href="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</a> errorHandler)</pre>
<div class="block">Set the function to be called if an error occurs.
<p>
When an error occurs in the Berkeley DB library, an exception is thrown.
In some cases, however, the error information returned to the
application may be insufficient to completely describe the cause of the
error, especially during initial application debugging.
<p>
The <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><code>EnvironmentConfig.setErrorHandler</code></a> and <a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><code>DatabaseConfig.setErrorHandler</code></a> methods are used to enhance the mechanism for reporting
error messages to the application. In some cases, when an error occurs,
Berkeley DB will invoke the ErrorHandler's object error method. It is
up to this method to display the error message in an appropriate manner.
<p>
Alternatively, applications can use <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorStream(java.io.OutputStream)"><code>EnvironmentConfig.setErrorStream</code></a> and <a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)"><code>DatabaseConfig.setErrorStream</code></a> to
display the additional information via an output stream. Applications
should not mix these approaches.
<p>
This error-logging enhancement does not slow performance or significantly
increase application size, and may be run during normal operation as well
as during application debugging.
<p>
For <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles opened inside of database environments,
calling this method affects the entire environment and is equivalent to
calling <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><code>EnvironmentConfig.setErrorHandler</code></a>.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>errorHandler</code> - The function to be called if an error occurs.</dd></dl>
</li>
</ul>
<a name="getErrorHandler()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getErrorHandler</h4>
<pre>public <a href="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</a> getErrorHandler()</pre>
<div class="block">Return the function to be called if an error occurs.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The function to be called if an error occurs.</dd></dl>
</li>
</ul>
<a name="setErrorPrefix(java.lang.String)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setErrorPrefix</h4>
<pre>public void setErrorPrefix(java.lang.String errorPrefix)</pre>
<div class="block">Set the prefix string that appears before error messages.
<p>
For <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles opened inside of database environments,
calling this method affects the entire environment and is equivalent to
calling <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorPrefix(java.lang.String)"><code>EnvironmentConfig.setErrorPrefix</code></a>.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>errorPrefix</code> - The prefix string that appears before error messages.</dd></dl>
</li>
</ul>
<a name="getErrorPrefix()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getErrorPrefix</h4>
<pre>public java.lang.String getErrorPrefix()</pre>
<div class="block">Return the prefix string that appears before error messages.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The prefix string that appears before error messages.</dd></dl>
</li>
</ul>
<a name="setErrorStream(java.io.OutputStream)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setErrorStream</h4>
<pre>public void setErrorStream(java.io.OutputStream errorStream)</pre>
<div class="block">Set an OutputStream for displaying error messages.
<p>
When an error occurs in the Berkeley DB library, an exception is thrown.
In some cases, however, the error information returned to the
application may be insufficient to completely describe the cause of the
error, especially during initial application debugging.
<p>
The <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorStream(java.io.OutputStream)"><code>EnvironmentConfig.setErrorStream</code></a> and
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)"><code>DatabaseConfig.setErrorStream</code></a> methods are used to enhance
the mechanism for reporting error messages to the application by setting
a OutputStream to be used for displaying additional Berkeley DB error
messages. In some cases, when an error occurs, Berkeley DB will output
an additional error message to the specified stream.
<p>
The error message will consist of the prefix string and a colon
("<b>:</b>") (if a prefix string was previously specified using
<a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorPrefix(java.lang.String)"><code>EnvironmentConfig.setErrorPrefix</code></a> or <a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorPrefix(java.lang.String)"><code>DatabaseConfig.setErrorPrefix</code></a>), an error string, and a trailing newline character.
<p>
Setting errorStream to null unconfigures the interface.
<p>
Alternatively, applications can use <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><code>EnvironmentConfig.setErrorHandler</code></a> and <a href="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><code>DatabaseConfig.setErrorHandler</code></a> to capture
the additional error information in a way that does not use output
streams. Applications should not mix these approaches.
<p>
This error-logging enhancement does not slow performance or significantly
increase application size, and may be run during normal operation as well
as during application debugging.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>errorStream</code> - The application-specified OutputStream for error messages.</dd></dl>
</li>
</ul>
<a name="getErrorStream()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getErrorStream</h4>
<pre>public java.io.OutputStream getErrorStream()</pre>
<div class="block">Return the an OutputStream for displaying error messages.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The an OutputStream for displaying error messages.</dd></dl>
</li>
</ul>
<a name="setExclusiveCreate(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setExclusiveCreate</h4>
<pre>public void setExclusiveCreate(boolean exclusiveCreate)</pre>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to fail if
the database already exists.
<p>
The exclusiveCreate mode is only meaningful if specified with the
allowCreate mode.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>exclusiveCreate</code> - If true, configure the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method to
fail if the database already exists.</dd></dl>
</li>
</ul>
<a name="getExclusiveCreate()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getExclusiveCreate</h4>
<pre>public boolean getExclusiveCreate()</pre>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to fail if the database already exists.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the <a href="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction,%20java.lang.String,%20java.lang.String,%20com.sleepycat.db.DatabaseConfig)"><code>Environment.openDatabase</code></a> method is configured
to fail if the database already exists.</dd></dl>
</li>
</ul>
<a name="setFeedbackHandler(com.sleepycat.db.FeedbackHandler)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setFeedbackHandler</h4>
<pre>public void setFeedbackHandler(<a href="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</a> feedbackHandler)</pre>
<div class="block">Set an object whose methods are called to provide feedback.
<p>
Some operations performed by the Berkeley DB library can take
non-trivial amounts of time. This method can be used by applications
to monitor progress within these operations. When an operation is
likely to take a long time, Berkeley DB will call the object's methods
with progress information.
<p>
It is up to the object's methods to display this information in an
appropriate manner.
<p>
This method configures only operations performed using a single a
<a href="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><code>Environment</code></a> handle
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>feedbackHandler</code> - An object whose methods are called to provide feedback.</dd></dl>
</li>
</ul>
<a name="getFeedbackHandler()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFeedbackHandler</h4>
<pre>public <a href="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</a> getFeedbackHandler()</pre>
<div class="block">Return the object's methods to be called to provide feedback.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The object's methods to be called to provide feedback.</dd></dl>
</li>
</ul>
<a name="setHashFillFactor(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHashFillFactor</h4>
<pre>public void setHashFillFactor(int hashFillFactor)</pre>
<div class="block">Set the desired density within the hash table.
<p>
If no value is specified, the fill factor will be selected dynamically
as pages are filled.
<p>
The density is an approximation of the number of keys allowed to
accumulate in any one bucket, determining when the hash table grows or
shrinks. If you know the average sizes of the keys and data in your
data set, setting the fill factor can enhance performance. A reasonable
rule computing fill factor is to set it to the following:
<blockquote><pre>
(pagesize - 32) / (average_key_size + average_data_size + 8)
</pre></blockquote>
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>hashFillFactor</code> - The desired density within the hash table.</dd></dl>
</li>
</ul>
<a name="getHashFillFactor()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHashFillFactor</h4>
<pre>public int getHashFillFactor()</pre>
<div class="block">Return the hash table density.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The hash table density.</dd></dl>
</li>
</ul>
<a name="setHashComparator(java.util.Comparator)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHashComparator</h4>
<pre>public void setHashComparator(java.util.Comparator hashComparator)</pre>
<div class="block">Set the Hash key comparison function. The comparison function is called
whenever it is necessary to compare a key specified by the application with
a key currently stored in the database.
<p>
If no comparison function is specified, a byte-by-byte comparison is
performed.
<p>
The <code>compare</code> method is passed the byte arrays representing
keys that are stored in the database. If you know how your data is
organized in the byte array, then you can write a comparison routine that
directly examines the contents of the arrays. Otherwise, you have to
reconstruct your original objects, and then perform the comparison.</div>
</li>
</ul>
<a name="getHashComparator()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHashComparator</h4>
<pre>public java.util.Comparator getHashComparator()</pre>
<div class="block">Return the Comparator used to compare keys in a Hash database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The Comparator used to compare keys in a Hash database.</dd></dl>
</li>
</ul>
<a name="setHasher(com.sleepycat.db.Hasher)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHasher</h4>
<pre>public void setHasher(<a href="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</a> hasher)</pre>
<div class="block">Set a database-specific hash function.
<p>
If no hash function is specified, a default hash function is used.
Because no hash function performs equally well on all possible data,
the user may find that the built-in hash function performs poorly
with a particular data set.
<p>
This method configures operations performed using the specified
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> object, not all operations performed on the underlying
database.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method must be the same as that
historically used to create the database or corruption can occur.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>hasher</code> - A database-specific hash function.</dd></dl>
</li>
</ul>
<a name="getHasher()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHasher</h4>
<pre>public <a href="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</a> getHasher()</pre>
<div class="block">Return the database-specific hash function.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The database-specific hash function.</dd></dl>
</li>
</ul>
<a name="setHashNumElements(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHashNumElements</h4>
<pre>public void setHashNumElements(int hashNumElements)</pre>
<div class="block">Set an estimate of the final size of the hash table.
<p>
In order for the estimate to be used when creating the database, the
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setHashFillFactor(int)"><code>DatabaseConfig.setHashFillFactor</code></a> method must also be called.
If the estimate or fill factor are not set or are set too low, hash
tables will still expand gracefully as keys are entered, although a
slight performance degradation may be noticed.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>hashNumElements</code> - An estimate of the final size of the hash table.</dd></dl>
</li>
</ul>
<a name="getHashNumElements()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHashNumElements</h4>
<pre>public int getHashNumElements()</pre>
<div class="block">Return the estimate of the final size of the hash table.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The estimate of the final size of the hash table.</dd></dl>
</li>
</ul>
<a name="setHeapsize(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHeapsize</h4>
<pre>public void setHeapsize(long bytes)</pre>
<div class="block">Set the maximum on-disk database file size used by a database configured to
use the Heap access method. If this method is never called, the database's
file size can grow without bound. If this method is called, then the heap
file can never grow larger than the limit defined by this method. In that
case, attempts to update or create records in a Heap database that has
reached its maximum size will throw a <a href="../../../com/sleepycat/db/HeapFullException.html" title="class in com.sleepycat.db"><code>HeapFullException</code></a>.
<p>
The size specified to this method must be at least three times the database
page size. That is, a Heap database must contain at least three database
pages. You can set the database page size using <a href="../../../com/sleepycat/db/DatabaseConfig.html#setPageSize(int)"><code>setPageSize(int)</code></a>.
<p>
This method may not be called after the database is opened. Further, if this
method is called on an existing Heap database, the size specified here must
match the size used to create the database. Note, however, that specifying
an incorrect size to this method will not result in an error return until
the database is opened.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bytes</code> - The maximum on-disk database file size.</dd></dl>
</li>
</ul>
<a name="getHeapsize()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHeapsize</h4>
<pre>public long getHeapsize()</pre>
<div class="block">Return the maximum on-disk database file size.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The maximum on-disk database file size.</dd></dl>
</li>
</ul>
<a name="setHeapRegionSize(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setHeapRegionSize</h4>
<pre>public void setHeapRegionSize(int npages)</pre>
<div class="block">Sets the number of pages in a region of a database configured to use
the Heap access method. If this method is never called, the default region
size for the database's page size will be used. You can set the database
page size using <a href="../../../com/sleepycat/db/DatabaseConfig.html#setPageSize(int)"><code>setPageSize(int)</code></a>.
<p>
This method may not be called after the database is opened. Further, if this
method is called on an existing Heap database, the value specified here will
be ignored. If the specified region size is larger than the maximum region
size for the database's page size, an error will be returned when the
database is opened. The maximum allowable region size will be included in
the error message.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>npages</code> - The size of the region, in pages.</dd></dl>
</li>
</ul>
<a name="getHeapRegionSize()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getHeapRegionSize</h4>
<pre>public long getHeapRegionSize()</pre>
<div class="block">Return the number of pages in a region of the database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The size of the region, in pages.</dd></dl>
</li>
</ul>
<a name="setMessageHandler(com.sleepycat.db.MessageHandler)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMessageHandler</h4>
<pre>public void setMessageHandler(<a href="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</a> messageHandler)</pre>
<div class="block">Set a function to be called with an informational message.
<p>
There are interfaces in the Berkeley DB library which either directly
output informational messages or statistical information, or configure
the library to output such messages when performing other operations,
<a href="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseDeadlock(boolean)"><code>EnvironmentConfig.setVerboseDeadlock</code></a> for example.
<p>
The <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><code>EnvironmentConfig.setMessageHandler</code></a> and
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><code>DatabaseConfig.setMessageHandler</code></a> methods are used to display
these messages for the application.
<p>
Setting messageHandler to null unconfigures the interface.
<p>
Alternatively, you can use <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)"><code>EnvironmentConfig.setMessageStream</code></a>
and <a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)"><code>DatabaseConfig.setMessageStream</code></a> to send the additional
information directly to an output streams. You should not mix these
approaches.
<p>
For <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles opened inside of database environments,
calling this method affects the entire environment and is equivalent to
calling <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><code>EnvironmentConfig.setMessageHandler</code></a>.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>messageHandler</code> - The application-specified function for informational messages.</dd></dl>
</li>
</ul>
<a name="getMessageHandler()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMessageHandler</h4>
<pre>public <a href="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</a> getMessageHandler()</pre>
<div class="block">Return the function to be called with an informational message.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The function to be called with an informational message.</dd></dl>
</li>
</ul>
<a name="setMsgfile(java.io.File)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMsgfile</h4>
<pre>public void setMsgfile(java.io.File file)</pre>
<div class="block">Sets the path of a file to store statistical information.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>file</code> - The path of a file to store statistical information.</dd></dl>
</li>
</ul>
<a name="setMessageStream(java.io.OutputStream)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMessageStream</h4>
<pre>public void setMessageStream(java.io.OutputStream messageStream)</pre>
<div class="block">Set an OutputStream for displaying informational messages.
<p>
There are interfaces in the Berkeley DB library which either directly
output informational messages or statistical information, or configure
the library to output such messages when performing other operations,
<a href="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseDeadlock(boolean)"><code>EnvironmentConfig.setVerboseDeadlock</code></a> for example.
<p>
The <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)"><code>EnvironmentConfig.setMessageStream</code></a> and
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)"><code>DatabaseConfig.setMessageStream</code></a> methods are used to display
these messages for the application. In this case, the message will
include a trailing newline character.
<p>
Setting messageStream to null unconfigures the interface.
<p>
Alternatively, you can use <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><code>EnvironmentConfig.setMessageHandler</code></a>
and <a href="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><code>DatabaseConfig.setMessageHandler</code></a> to capture the additional
information in a way that does not use output streams. You should not
mix these approaches.
<p>
For <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles opened inside of database environments,
calling this method affects the entire environment and is equivalent to
calling <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)"><code>EnvironmentConfig.setMessageStream</code></a>.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>messageStream</code> - The application-specified OutputStream for informational messages.</dd></dl>
</li>
</ul>
<a name="getMessageStream()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMessageStream</h4>
<pre>public java.io.OutputStream getMessageStream()</pre>
<div class="block">Return the an OutputStream for displaying informational messages.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The an OutputStream for displaying informational messages.</dd></dl>
</li>
</ul>
<a name="setMode(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMode</h4>
<pre>public void setMode(int mode)</pre>
<div class="block">On UNIX systems or in IEEE/ANSI Std 1003.1 (POSIX) environments, files
created by the database open are created with mode <code>mode</code>
(as described in the <code>chmod</code>(2) manual page) and modified
by the process' umask value at the time of creation (see the
<code>umask</code>(2) manual page). Created files are owned by the
process owner; the group ownership of created files is based on the
system and directory defaults, and is not further specified by Berkeley
DB. System shared memory segments created by the database open are
created with mode <code>mode</code>, unmodified by the process' umask
value. If <code>mode</code> is 0, the database open will use a default
mode of readable and writable by both owner and group.
<p>
On Windows systems, the mode parameter is ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>mode</code> - the mode used to create files</dd></dl>
</li>
</ul>
<a name="getMode()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMode</h4>
<pre>public long getMode()</pre>
<div class="block">Return the mode used to create files.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The mode used to create files.</dd></dl>
</li>
</ul>
<a name="setMultiversion(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMultiversion</h4>
<pre>public void setMultiversion(boolean multiversion)</pre>
<div class="block">Configured the database with support for multiversion concurrency control.
This will cause updates to the database to follow a copy-on-write
protocol, which is required to support Snapshot Isolation. See
<a href="../../../com/sleepycat/db/TransactionConfig.html#setSnapshot(boolean)"><code>TransactionConfig.setSnapshot(boolean)</code></a>) for more information.
Multiversion access requires that the database be opened
in a transaction and is not supported for queue databases.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>multiversion</code> - If true, configure the database with support for multiversion concurrency
control.</dd></dl>
</li>
</ul>
<a name="getMultiversion()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMultiversion</h4>
<pre>public boolean getMultiversion()</pre>
<div class="block">Return true if the database is configured for multiversion concurrency control.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured for multiversion concurrency control.</dd></dl>
</li>
</ul>
<a name="setNoMMap(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setNoMMap</h4>
<pre>public void setNoMMap(boolean noMMap)</pre>
<div class="block">Configure the library to not map this database into memory.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>noMMap</code> - If true, configure the library to not map this database into memory.</dd></dl>
</li>
</ul>
<a name="getNoMMap()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getNoMMap</h4>
<pre>public boolean getNoMMap()</pre>
<div class="block">Return true if the library is configured to not map this database into
memory.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the library is configured to not map this database into
memory.</dd></dl>
</li>
</ul>
<a name="setNoWaitDbExclusiveLock(java.lang.Boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setNoWaitDbExclusiveLock</h4>
<pre>public void setNoWaitDbExclusiveLock(java.lang.Boolean noWaitDbExclLock)</pre>
<div class="block">Configure the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle to obtain a
write lock on the entire database.
<p>
This method may not be called after the database is opened.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>noWaitDbExclLock</code> - If True, configure the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle to
obtain a write lock on the entire database. When the database is opened it will
immediately throw
<a href="../../../com/sleepycat/db/LockNotGrantedException.html" title="class in com.sleepycat.db"><code>LockNotGrantedException</code></a> if it
cannot obtain the exclusive lock immediately. If False, configure the
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle to obtain a write lock on the
entire database. When the database is opened, it will block until it can obtain
the exclusive lock. If null, do not configure the
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle to obtain a write lock on the
entire database.
<p>
Handles configured for a write lock on the entire database can only have one
active transaction at a time.</dd></dl>
</li>
</ul>
<a name="getNoWaitDbExclusiveLock()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getNoWaitDbExclusiveLock</h4>
<pre>public java.lang.Boolean getNoWaitDbExclusiveLock()</pre>
<div class="block">Return whether the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle is
configured to obtain a write lock on the entire database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle is configured for
immediate exclusive database locking. In this case, the locking operation will
error out if it cannot immediately obtain an exclusive lock. False if the
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle is configured for exclusive
database locking. In this case, it will block until it can obtain the exclusive
database lock when database is opened. Null if the
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle is not configured for
exclusive locking.</dd></dl>
</li>
</ul>
<a name="setPageSize(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPageSize</h4>
<pre>public void setPageSize(int pageSize)</pre>
<div class="block">Set the size of the pages used to hold items in the database, in bytes.
<p>
The minimum page size is 512 bytes, the maximum page size is 64K bytes,
and the page size must be a power-of-two. If the page size is not
explicitly set, one is selected based on the underlying filesystem I/O
block size. The automatically selected size has a lower limit of 512
bytes and an upper limit of 16K bytes.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
If creating additional databases in a file, the page size specified must
be consistent with the existing databases in the file or an error will
be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pageSize</code> - The size of the pages used to hold items in the database, in bytes.</dd></dl>
</li>
</ul>
<a name="getPageSize()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPageSize</h4>
<pre>public int getPageSize()</pre>
<div class="block">Return the size of the pages used to hold items in the database, in bytes.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The size of the pages used to hold items in the database, in bytes.</dd></dl>
</li>
</ul>
<a name="setPanicHandler(com.sleepycat.db.PanicHandler)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPanicHandler</h4>
<pre>public void setPanicHandler(<a href="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</a> panicHandler)</pre>
<div class="block">Set the function to be called if the database environment panics.
<p>
Errors can occur in the Berkeley DB library where the only solution is
to shut down the application and run recovery (for example, if Berkeley
DB is unable to allocate heap memory). In such cases, the Berkeley DB
methods will throw a <a href="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><code>RunRecoveryException</code></a>. It is often easier
to simply exit the application when such errors occur rather than
gracefully return up the stack. This method specifies a function to be
called when <a href="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><code>RunRecoveryException</code></a> is about to be thrown from a
Berkeley DB method.
<p>
For <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handles opened inside of database environments,
calling this method affects the entire environment and is equivalent to
calling <a href="../../../com/sleepycat/db/EnvironmentConfig.html#setPanicHandler(com.sleepycat.db.PanicHandler)"><code>EnvironmentConfig.setPanicHandler</code></a>.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>panicHandler</code> - The function to be called if the database environment panics.</dd></dl>
</li>
</ul>
<a name="getPanicHandler()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPanicHandler</h4>
<pre>public <a href="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</a> getPanicHandler()</pre>
<div class="block">Return the function to be called if the database environment panics.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The function to be called if the database environment panics.</dd></dl>
</li>
</ul>
<a name="setPartitionByCallback(int, com.sleepycat.db.PartitionHandler)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPartitionByCallback</h4>
<pre>public void setPartitionByCallback(int parts,
<a href="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</a> partitionHandler)</pre>
<div class="block">Enable or disable database partitioning, and set the callback that will
be used for the partitioning.
<p>
This method may only be called before opening a database.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>parts</code> - The number of partitions that will be created.
<p></dd><dd><code>partitionHandler</code> - The function to be called to determine which partition a key resides in.</dd></dl>
</li>
</ul>
<a name="setPartitionByRange(int, com.sleepycat.db.MultipleDataEntry)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPartitionByRange</h4>
<pre>public void setPartitionByRange(int parts,
<a href="../../../com/sleepycat/db/MultipleDataEntry.html" title="class in com.sleepycat.db">MultipleDataEntry</a> keys)</pre>
<div class="block">Enable or disable database partitioning, and set key ranges that will be
used for the partitioning.
<p>
This method may only be called before opening a database.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>parts</code> - The number of partitions that will be created.
<p></dd><dd><code>keys</code> - A MultipleDatabaseEntry that contains the boundary keys for partitioning.
<p></dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code>java.lang.IllegalArgumentException</code> - if parts is not equal to the size of key array plus 1.</dd></dl>
</li>
</ul>
<a name="getPartitionHandler()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPartitionHandler</h4>
<pre>public <a href="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</a> getPartitionHandler()</pre>
<div class="block">Return the function to be called to determine which partition a key resides in.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The function to be called to determine which partition a key resides in.</dd></dl>
</li>
</ul>
<a name="getPartitionParts()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPartitionParts</h4>
<pre>public int getPartitionParts()</pre>
<div class="block">Return the number of partitions the database is configured for.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The number of partitions the database is configured for.</dd></dl>
</li>
</ul>
<a name="getPartitionKeys()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPartitionKeys</h4>
<pre>public <a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</a> getPartitionKeys()</pre>
<div class="block">Return the array of keys the database is configured to partition with.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The array of keys the database is configured to partition with.</dd></dl>
</li>
</ul>
<a name="setPartitionDirs(java.io.File[])">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPartitionDirs</h4>
<pre>public void setPartitionDirs(java.io.File[] dirs)</pre>
<div class="block">Specify the array of directories the database extents should be created in or
looked for. If the number of directories is less than the number of partitions,
the directories will be used in a round robin fasion.
<p>
This method may only be called before the database is opened.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>dirs</code> - The array of directories the database extents should be created in or looked
for.</dd></dl>
</li>
</ul>
<a name="getPartitionDirs()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPartitionDirs</h4>
<pre>public java.io.File[] getPartitionDirs()</pre>
<div class="block">Return the array of directories the database extents should be created in or
looked for. If the number of directories is less than the number of partitions,
the directories will be used in a round robin fasion.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The array of directories the database extents should be created in or looked
for.</dd></dl>
</li>
</ul>
<a name="setPriority(com.sleepycat.db.CacheFilePriority)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPriority</h4>
<pre>public void setPriority(<a href="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a> priority)</pre>
<div class="block">Set the cache priority for pages referenced by the DB handle.
<p>
The priority of a page biases the replacement algorithm to be more or less
likely to discard a page when space is needed in the buffer pool. The bias
is temporary, and pages will eventually be discarded if they are not
referenced again. The priority setting is only advisory, and does not
guarantee pages will be treated in a specific way.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>priority</code> - The desired cache priority.</dd></dl>
</li>
</ul>
<a name="getPriority()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPriority</h4>
<pre>public <a href="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a> getPriority()</pre>
<div class="block">Return the the cache priority for pages referenced by this handle.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The the cache priority for pages referenced by this handle.</dd></dl>
</li>
</ul>
<a name="setQueueExtentSize(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setQueueExtentSize</h4>
<pre>public void setQueueExtentSize(int queueExtentSize)</pre>
<div class="block">Set the size of the extents used to hold pages in a Queue database,
specified as a number of pages.
<p>
Each extent is created as a separate physical file. If no extent
size is set, the default behavior is to create only a single
underlying database file.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>queueExtentSize</code> - The number of pages in a Queue database extent.</dd></dl>
</li>
</ul>
<a name="getQueueExtentSize()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getQueueExtentSize</h4>
<pre>public int getQueueExtentSize()</pre>
<div class="block">Return the size of the extents used to hold pages in a Queue database,
specified as a number of pages.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The size of the extents used to hold pages in a Queue database,
specified as a number of pages.</dd></dl>
</li>
</ul>
<a name="setQueueInOrder(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setQueueInOrder</h4>
<pre>public void setQueueInOrder(boolean queueInOrder)</pre>
<div class="block">Configure <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> to return key/data pairs in
order, always returning the key/data item from the head of the
queue.
<p>
The default behavior of queue databases is optimized for multiple
readers, and does not guarantee that record will be retrieved in the
order they are added to the queue. Specifically, if a writing
thread adds multiple records to an empty queue, reading threads may
skip some of the initial records when the next call to retrieve a
key/data pair returns.
<p>
This flag configures the <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> method to verify
that the record being returned is in fact the head of the queue.
This will increase contention and reduce concurrency when there are
many reading threads.
<p>
Calling this method only affects the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle
(and any other library handles opened within the scope of that handle).
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>queueInOrder</code> - If true, configure the <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> method to return
key/data pairs in order, always returning the key/data item from the
head of the queue.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getQueueInOrder()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getQueueInOrder</h4>
<pre>public boolean getQueueInOrder()</pre>
<div class="block">Return true if the <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> method is configured to return
key/data pairs in order, always returning the key/data item from the
head of the queue.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the <a href="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry,%20boolean)"><code>Database.consume</code></a> method is configured to return
key/data pairs in order, always returning the key/data item from the
head of the queue.</dd></dl>
</li>
</ul>
<a name="setReadOnly(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setReadOnly</h4>
<pre>public void setReadOnly(boolean readOnly)</pre>
<div class="block">Configure the database in read-only mode.
<p>
Any attempt to modify items in the database will fail, regardless
of the actual permissions of any underlying files.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>readOnly</code> - If true, configure the database in read-only mode.</dd></dl>
</li>
</ul>
<a name="getReadOnly()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getReadOnly</h4>
<pre>public boolean getReadOnly()</pre>
<div class="block">Return true if the database is configured in read-only mode.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured in read-only mode.</dd></dl>
</li>
</ul>
<a name="setRecordNumberAppender(com.sleepycat.db.RecordNumberAppender)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRecordNumberAppender</h4>
<pre>public void setRecordNumberAppender(<a href="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</a> recnoAppender)</pre>
<div class="block">Configure <a href="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction,%20com.sleepycat.db.DatabaseEntry,%20com.sleepycat.db.DatabaseEntry)"><code>Database.append</code></a> to call the function after the
record number has been selected but before the data has been stored
into the database.
<p>
This method configures operations performed using the specified
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> object, not all operations performed on the underlying
database.
<p>
This method may not be called after the database is opened.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>recnoAppender</code> - The function to call after the record number has been selected but
before the data has been stored into the database.</dd></dl>
</li>
</ul>
<a name="getRecordNumberAppender()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRecordNumberAppender</h4>
<pre>public <a href="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</a> getRecordNumberAppender()</pre>
<div class="block">Return the function to call after the record number has been
selected but before the data has been stored into the database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The function to call after the record number has been
selected but before the data has been stored into the database.</dd></dl>
</li>
</ul>
<a name="setRecordDelimiter(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRecordDelimiter</h4>
<pre>public void setRecordDelimiter(int recordDelimiter)</pre>
<div class="block">Set the delimiting byte used to mark the end of a record in the backing
source file for the Recno access method.
<p>
This byte is used for variable length records if a backing source
file is specified. If a backing source file is specified and no
delimiting byte was specified, newline characters (that is, ASCII
0x0a) are interpreted as end-of-record markers.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>recordDelimiter</code> - The delimiting byte used to mark the end of a record in the backing
source file for the Recno access method.</dd></dl>
</li>
</ul>
<a name="getRecordDelimiter()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRecordDelimiter</h4>
<pre>public int getRecordDelimiter()</pre>
<div class="block">Return the delimiting byte used to mark the end of a record in the
backing source file for the Recno access method.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The delimiting byte used to mark the end of a record in the
backing source file for the Recno access method.</dd></dl>
</li>
</ul>
<a name="setRecordLength(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRecordLength</h4>
<pre>public void setRecordLength(int recordLength)</pre>
<div class="block">Specify the database record length, in bytes.
<p>
For the Queue access method, specify the record length. For the
Queue access method, the record length must be enough smaller than
the database's page size that at least one record plus the database
page's metadata information can fit on each database page.
<p>
For the Recno access method, specify the records are fixed-length,
not byte-delimited, and the record length.
<p>
Any records added to the database that are less than the specified
length are automatically padded (see
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordPad(int)"><code>DatabaseConfig.setRecordPad</code></a> for more information).
<p>
Any attempt to insert records into the database that are greater
than the specified length will cause the call to fail.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>recordLength</code> - The database record length, in bytes.</dd></dl>
</li>
</ul>
<a name="getRecordLength()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRecordLength</h4>
<pre>public int getRecordLength()</pre>
<div class="block">Return the database record length, in bytes.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The database record length, in bytes.</dd></dl>
</li>
</ul>
<a name="setBtreeRecordNumbers(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setBtreeRecordNumbers</h4>
<pre>public void setBtreeRecordNumbers(boolean btreeRecordNumbers)</pre>
<div class="block">Configure the Btree to support retrieval by record number.
<p>
Logical record numbers in Btree databases are mutable in the face of
record insertion or deletion.
<p>
Maintaining record counts within a Btree introduces a serious point
of contention, namely the page locations where the record counts are
stored. In addition, the entire database must be locked during both
insertions and deletions, effectively single-threading the database
for those operations. Configuring a Btree for retrieval by record
number can result in serious performance degradation for some
applications and data sets.
<p>
Retrieval by record number may not be configured for a Btree that also
supports duplicate data items.
<p>
Calling this method affects the database, including all threads of
control accessing the database.
<p>
If the database already exists when the database is opened, any database
configuration specified by this method
must be the same as the existing database or an error
will be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>btreeRecordNumbers</code> - If true, configure the Btree to support retrieval by record number.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getBtreeRecordNumbers()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBtreeRecordNumbers</h4>
<pre>public boolean getBtreeRecordNumbers()</pre>
<div class="block">Return true if the Btree is configured to support retrieval by record number.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the Btree is configured to support retrieval by record number.</dd></dl>
</li>
</ul>
<a name="setRecordPad(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRecordPad</h4>
<pre>public void setRecordPad(int recordPad)</pre>
<div class="block">Set the padding character for short, fixed-length records for the Queue
and Recno access methods.
<p>
If no pad character is specified, "space" characters (that is, ASCII
0x20) are used for padding.
<p>
This method configures a database, not only operations performed using
the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method will be ignored.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>recordPad</code> - The padding character for short, fixed-length records for the Queue
and Recno access methods.</dd></dl>
</li>
</ul>
<a name="getRecordPad()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRecordPad</h4>
<pre>public int getRecordPad()</pre>
<div class="block">Return the padding character for short, fixed-length records for the
Queue and Recno access methods.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The padding character for short, fixed-length records for the
Queue and Recno access methods.</dd></dl>
</li>
</ul>
<a name="setRecordSource(java.io.File)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRecordSource</h4>
<pre>public void setRecordSource(java.io.File recordSource)</pre>
<div class="block">Set the underlying source file for the Recno access method.
<p>
The purpose of the source file is to provide fast access and
modification to databases that are normally stored as flat text
files.
<p>
The recordSource parameter specifies an underlying flat text
database file that is read to initialize a transient record number
index. In the case of variable length records, the records are
separated, as specified by the
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordDelimiter(int)"><code>DatabaseConfig.setRecordDelimiter</code></a> method. For example,
standard UNIX byte stream files can be interpreted as a sequence of
variable length records separated by newline characters (that is, ASCII
0x0a).
<p>
In addition, when cached data would normally be written back to the
underlying database file (for example, the <a href="../../../com/sleepycat/db/Database.html#close(boolean)"><code>Database.close</code></a>
or <a href="../../../com/sleepycat/db/Database.html#sync()"><code>Database.sync</code></a> methods are called), the in-memory copy
of the database will be written back to the source file.
<p>
By default, the backing source file is read lazily; that is, records
are not read from the file until they are requested by the application.
<b>
If multiple processes (not threads) are accessing a Recno database
concurrently, and are either inserting or deleting records, the backing
source file must be read in its entirety before more than a single
process accesses the database, and only that process should specify
the backing source file as part of opening the database. See the
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setSnapshot(boolean)"><code>DatabaseConfig.setSnapshot</code></a> method for more information.
</b>
<p>
<b>
Reading and writing the backing source file cannot be
transaction-protected because it involves filesystem operations that
are not part of the <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> transaction methodology. For
this reason, if a temporary database is used to hold the records,
it is possible to lose the contents of the source file, for example,
if the system crashes at the right instant. If a file is used to
hold the database, normal database recovery on that file can be used
to prevent information loss, although it is still possible that the
contents of the source file will be lost if the system crashes.
</b>
<p>
The source file must already exist (but may be zero-length) when
the database is opened.
<p>
It is not an error to specify a read-only source file when creating
a database, nor is it an error to modify the resulting database.
However, any attempt to write the changes to the backing source file
using either the <a href="../../../com/sleepycat/db/Database.html#sync()"><code>Database.sync</code></a> or <a href="../../../com/sleepycat/db/Database.html#close(boolean)"><code>Database.close</code></a>
methods will fail, of course. Specify the noSync argument to the
<a href="../../../com/sleepycat/db/Database.html#close(boolean)"><code>Database.close</code></a> method to stop it from attempting to write
the changes to the backing file; instead, they will be silently
discarded.
<p>
For all of the previous reasons, the source file is generally used
to specify databases that are read-only for Berkeley DB
applications; and that are either generated on the fly by software
tools or modified using a different mechanism -- for example, a text
editor.
<p>
This method configures operations performed using the specified
<a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> object, not all operations performed on the underlying
database.
<p>
This method may not be called after the database is opened.
If the database already exists when it is opened,
the information specified to this method must be the same as that
historically used to create the database or corruption can occur.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>recordSource</code> - The name of an underlying flat text database file that is read to
initialize a transient record number index. In the case of variable
length records, the records are separated, as specified by the
<a href="../../../com/sleepycat/db/DatabaseConfig.html#setRecordDelimiter(int)"><code>DatabaseConfig.setRecordDelimiter</code></a> method. For example,
standard UNIX byte stream files can be interpreted as a sequence of
variable length records separated by newline characters (that is, ASCII
0x0a).</dd></dl>
</li>
</ul>
<a name="getRecordSource()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRecordSource</h4>
<pre>public java.io.File getRecordSource()</pre>
<div class="block">Return the name of an underlying flat text database file that is
read to initialize a transient record number index.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The name of an underlying flat text database file that is
read to initialize a transient record number index.</dd></dl>
</li>
</ul>
<a name="setRenumbering(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRenumbering</h4>
<pre>public void setRenumbering(boolean renumbering)</pre>
<div class="block">Configure the logical record numbers to be mutable, and change as
records are added to and deleted from the database.
<p>
For example, the deletion of record number 4 causes records numbered
5 and greater to be renumbered downward by one. If a cursor was
positioned to record number 4 before the deletion, it will refer to
the new record number 4, if any such record exists, after the
deletion. If a cursor was positioned after record number 4 before
the deletion, it will be shifted downward one logical record,
continuing to refer to the same record as it did before.
<p>
Creating new records will cause the creation of multiple records if
the record number is more than one greater than the largest record
currently in the database. For example, creating record 28, when
record 25 was previously the last record in the database, will
create records 26 and 27 as well as 28. Attempts to retrieve
records that were created in this manner will result in an error
return of <a href="../../../com/sleepycat/db/OperationStatus.html#KEYEMPTY"><code>OperationStatus.KEYEMPTY</code></a>.
<p>
If a created record is not at the end of the database, all records
following the new record will be automatically renumbered upward by one.
For example, the creation of a new record numbered 8 causes records
numbered 8 and greater to be renumbered upward by one. If a cursor was
positioned to record number 8 or greater before the insertion, it will
be shifted upward one logical record, continuing to refer to the same
record as it did before.
<p>
For these reasons, concurrent access to a Recno database configured
with mutable record numbers may be largely meaningless, although it
is supported.
<p>
Calling this method affects the database, including all threads of
control accessing the database.
<p>
If the database already exists when the database is opened, any database
configuration specified by this method
must be the same as the existing database or an error
will be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>renumbering</code> - If true, configure the logical record numbers to be mutable, and
change as records are added to and deleted from the database.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getRenumbering()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRenumbering</h4>
<pre>public boolean getRenumbering()</pre>
<div class="block">Return true if the logical record numbers are mutable, and change as
records are added to and deleted from the database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the logical record numbers are mutable, and change as
records are added to and deleted from the database.</dd></dl>
</li>
</ul>
<a name="setReverseSplitOff(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setReverseSplitOff</h4>
<pre>public void setReverseSplitOff(boolean reverseSplitOff)</pre>
<div class="block">Configure the Btree to not do reverse splits.
<p>
As pages are emptied in a database, the Btree implementation
attempts to coalesce empty pages into higher-level pages in order
to keep the database as small as possible and minimize search time.
This can hurt performance in applications with cyclical data
demands; that is, applications where the database grows and shrinks
repeatedly. For example, because Berkeley DB does page-level locking,
the maximum level of concurrency in a database of two pages is far
smaller than that in a database of 100 pages, so a database that has
shrunk to a minimal size can cause severe deadlocking when a new
cycle of data insertion begins.
<p>
Calling this method only affects the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle
(and any other library handles opened within the scope of that handle).
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>reverseSplitOff</code> - If true, configure the Btree to not do reverse splits.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getReverseSplitOff()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getReverseSplitOff</h4>
<pre>public boolean getReverseSplitOff()</pre>
<div class="block">Return true if the Btree has been configured to not do reverse splits.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the Btree has been configured to not do reverse splits.</dd></dl>
</li>
</ul>
<a name="setSortedDuplicates(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setSortedDuplicates</h4>
<pre>public void setSortedDuplicates(boolean sortedDuplicates)</pre>
<div class="block">Configure the database to support sorted, duplicate data items.
<p>
Insertion when the key of the key/data pair being inserted already
exists in the database will be successful. The ordering of
duplicates in the database is determined by the duplicate comparison
function.
<p>
If the application does not specify a duplicate data item comparison
function, a default lexical comparison will be used.
<p>
If a primary database is to be associated with one or more secondary
databases, it may not be configured for duplicates.
<p>
A Btree that supports duplicate data items cannot also be configured
for retrieval by record number.
<p>
Calling this method affects the database, including all threads of
control accessing the database.
<p>
If the database already exists when the database is opened, any database
configuration specified by this method
must be the same as the existing database or an error
will be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>sortedDuplicates</code> - If true, configure the database to support duplicate data items.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getSortedDuplicates()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getSortedDuplicates</h4>
<pre>public boolean getSortedDuplicates()</pre>
<div class="block">Return true if the database is configured to support sorted duplicate data
items.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured to support sorted duplicate data
items.</dd></dl>
</li>
</ul>
<a name="setUnsortedDuplicates(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setUnsortedDuplicates</h4>
<pre>public void setUnsortedDuplicates(boolean unsortedDuplicates)</pre>
<div class="block">Configure the database to support unsorted duplicate data items.
<p>
Insertion when the key of the key/data pair being inserted already
exists in the database will be successful. The ordering of
duplicates in the database is determined by the order of insertion,
unless the ordering is otherwise specified by use of a database
cursor operation.
<p>
If a primary database is to be associated with one or more secondary
databases, it may not be configured for duplicates.
<p>
Sorted duplicates are preferred to unsorted duplicates for
performance reasons. Unsorted duplicates should only be used by
applications wanting to order duplicate data items manually.
<p>
Calling this method affects the database, including all threads of
control accessing the database.
<p>
If the database already exists when the database is opened, any database
configuration specified by this method
must be the same as the existing database or an error
will be returned.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>unsortedDuplicates</code> - If true, configure the database to support unsorted duplicate data items.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getUnsortedDuplicates()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getUnsortedDuplicates</h4>
<pre>public boolean getUnsortedDuplicates()</pre>
<div class="block">Return true if the database is configured to support duplicate data items.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database is configured to support duplicate data items.</dd></dl>
</li>
</ul>
<a name="setSnapshot(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setSnapshot</h4>
<pre>public void setSnapshot(boolean snapshot)</pre>
<div class="block">Specify that any specified backing source file be read in its entirety
when the database is opened.
<p>
If this flag is not specified, the backing source file may be read
lazily.
<p>
Calling this method only affects the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle
(and any other library handles opened within the scope of that handle).
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>snapshot</code> - If true, any specified backing source file will be read in its entirety
when the database is opened.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getSnapshot()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getSnapshot</h4>
<pre>public boolean getSnapshot()</pre>
<div class="block">Return true if the any specified backing source file will be read in its
entirety when the database is opened.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the any specified backing source file will be read in its
entirety when the database is opened.</dd></dl>
</li>
</ul>
<a name="getTransactional()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getTransactional</h4>
<pre>public boolean getTransactional()</pre>
<div class="block">Return true if the database open is enclosed within a transaction.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database open is enclosed within a transaction.</dd></dl>
</li>
</ul>
<a name="setTransactional(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setTransactional</h4>
<pre>public void setTransactional(boolean transactional)</pre>
<div class="block">Enclose the database open within a transaction.
<p>
If the call succeeds, the open operation will be recoverable. If
the call fails, no database will have been created.
<p>
All future operations on this database, which are not explicitly
enclosed in a transaction by the application, will be enclosed in
in a transaction within the library.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>transactional</code> - If true, enclose the database open within a transaction.</dd></dl>
</li>
</ul>
<a name="setTransactionNotDurable(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setTransactionNotDurable</h4>
<pre>public void setTransactionNotDurable(boolean transactionNotDurable)</pre>
<div class="block">Configure the database environment to not write log records for this
database.
<p>
This means that updates of this database exhibit the ACI (atomicity,
consistency, and isolation) properties, but not D (durability); that
is, database integrity will be maintained, but if the application
or system fails, integrity will not persist. The database file must
be verified and/or restored from backup after a failure. In order
to ensure integrity after application shut down, the database
must be flushed to disk before the database handles are closed,
or all
database changes must be flushed from the database environment cache
using <a href="../../../com/sleepycat/db/Environment.html#checkpoint(com.sleepycat.db.CheckpointConfig)"><code>Environment.checkpoint</code></a>.
<p>
All database handles for a single physical file must call this method,
including database handles for different databases in a physical file.
<p>
Calling this method only affects the specified <a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><code>Database</code></a> handle
(and any other library handles opened within the scope of that handle).
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>transactionNotDurable</code> - If true, configure the database environment to not write log records
for this database.
A value of false is illegal to this method, that is, once set, the
configuration cannot be cleared.</dd></dl>
</li>
</ul>
<a name="getTransactionNotDurable()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getTransactionNotDurable</h4>
<pre>public boolean getTransactionNotDurable()</pre>
<div class="block">Return true if the database environment is configured to not write log
records for this database.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database environment is configured to not write log
records for this database.</dd></dl>
</li>
</ul>
<a name="setTruncate(boolean)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setTruncate</h4>
<pre>public void setTruncate(boolean truncate)</pre>
<div class="block">Configure the database to be physically truncated by truncating the
underlying file, discarding all previous databases it might have
held.
<p>
Underlying filesystem primitives are used to implement this
configuration. For this reason, it is applicable only to a physical
file and cannot be used to discard databases within a file.
<p>
This configuration option cannot be lock or transaction-protected, and
it is an error to specify it in a locking or transaction-protected
database environment.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>truncate</code> - If true, configure the database to be physically truncated by truncating
the underlying file, discarding all previous databases it might have
held.</dd></dl>
</li>
</ul>
<a name="getTruncate()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getTruncate</h4>
<pre>public boolean getTruncate()</pre>
<div class="block">Return true if the database has been configured to be physically truncated
by truncating the underlying file, discarding all previous databases
it might have held.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>True if the database has been configured to be physically truncated
by truncating the underlying file, discarding all previous databases
it might have held.</dd></dl>
</li>
</ul>
<a name="setType(com.sleepycat.db.DatabaseType)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setType</h4>
<pre>public void setType(<a href="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</a> type)</pre>
<div class="block">Configure the type of the database.
<p>
If they type is DB_UNKNOWN, the database must already exist.
<p></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>type</code> - The type of the database.</dd></dl>
</li>
</ul>
<a name="getType()">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>getType</h4>
<pre>public <a href="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</a> getType()</pre>
<div class="block">Return the type of the database.
<p>
This method may be used to determine the type of the database after
opening it.
<p>
This method may not be called before the
database has been opened.
<p></div>
<dl><dt><span class="strong">Returns:</span></dt><dd>The type of the database.</dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!-- -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/DatabaseConfig.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><em><b>Berkeley DB</b><br><font size="-1"> version 6.1.29</font></em></div>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?com/sleepycat/db/DatabaseConfig.html" target="_top">Frames</a></li>
<li><a href="DatabaseConfig.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary: </li>
<li>Nested | </li>
<li><a href="#field_summary">Field</a> | </li>
<li><a href="#constructor_summary">Constr</a> | </li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
<li><a href="#field_detail">Field</a> | </li>
<li><a href="#constructor_detail">Constr</a> | </li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small><font size=1>Copyright (c) 1996, 2016 Oracle and/or its affiliates. All rights reserved.</font></small></p>
</body>
</html>
