<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage--> <HTML> <HEAD> <!-- Generated by javadoc (build 1.6.0_18) on Thu May 12 21:54:59 GMT 2011 --> <TITLE> DatabaseConfig </TITLE> <META NAME="date" CONTENT="2011-05-12"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { parent.document.title="DatabaseConfig"; } } </SCRIPT> <NOSCRIPT> </NOSCRIPT> </HEAD> <BODY BGCOLOR="white" onload="windowTitle();"> <HR> <!-- ========= START OF TOP NAVBAR ======= --> <A NAME="navbar_top"><!-- --></A> <A HREF="#skip-navbar_top" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_top_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?com/sleepycat/db/DatabaseConfig.html" target="_top"><B>FRAMES</B></A> <A HREF="DatabaseConfig.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <!-- ======== START OF CLASS DATA ======== --> <H2> <FONT SIZE="-1"> com.sleepycat.db</FONT> <BR> Class DatabaseConfig</H2> <PRE> java.lang.Object <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.db.DatabaseConfig</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD>java.lang.Cloneable</DD> </DL> <DL> <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../com/sleepycat/db/SecondaryConfig.html" title="class in com.sleepycat.db">SecondaryConfig</A></DD> </DL> <HR> <DL> <DT><PRE>public class <B>DatabaseConfig</B><DT>extends java.lang.Object<DT>implements java.lang.Cloneable</DL> </PRE> <P> Specify the attributes of a database. <P> <P> <HR> <P> <!-- =========== FIELD SUMMARY =========== --> <A NAME="field_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Field Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static <A HREF="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#DEFAULT">DEFAULT</A></B></CODE> <BR> An instance created using the default constructor is initialized with the system's default settings.</TD> </TR> </TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#DatabaseConfig()">DatabaseConfig</A></B>()</CODE> <BR> An instance created using the default constructor is initialized with the system's default settings.</TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Method Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#cloneConfig()">cloneConfig</A></B>()</CODE> <BR> Returns a copy of this configuration object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getAllowCreate()">getAllowCreate</A></B>()</CODE> <BR> Return true if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method is configured to create the database if it does not already exist.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.util.Comparator</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeComparator()">getBtreeComparator</A></B>()</CODE> <BR> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeCompressor()">getBtreeCompressor</A></B>()</CODE> <BR> Get the Btree compression callbacks.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeMinKey()">getBtreeMinKey</A></B>()</CODE> <BR> Return the minimum number of key/data pairs intended to be stored on any single Btree leaf page.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getBtreePrefixCalculator()">getBtreePrefixCalculator</A></B>()</CODE> <BR> Return the Btree prefix callback.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getBtreeRecordNumbers()">getBtreeRecordNumbers</A></B>()</CODE> <BR> Return true if the Btree is configured to support retrieval by record number.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getByteOrder()">getByteOrder</A></B>()</CODE> <BR> 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.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getByteSwapped()">getByteSwapped</A></B>()</CODE> <BR> Return if the underlying database files were created on an architecture of the same byte order as the current one.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getCacheCount()">getCacheCount</A></B>()</CODE> <BR> Return the number of shared memory buffer pools, that is, the number of caches.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> long</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getCacheSize()">getCacheSize</A></B>()</CODE> <BR> Return the size of the shared memory buffer pool, that is, the cache.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getChecksum()">getChecksum</A></B>()</CODE> <BR> Return true if the database environment is configured to do checksum verification of pages read into the cache from the backing filestore.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.io.File</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getCreateDir()">getCreateDir</A></B>()</CODE> <BR> Return the directory a database will/has been created in or looked for.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getDirtyRead()">getDirtyRead</A></B>()</CODE> <BR> <B>Deprecated.</B> <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></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.util.Comparator</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getDuplicateComparator()">getDuplicateComparator</A></B>()</CODE> <BR> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getEncrypted()">getEncrypted</A></B>()</CODE> <BR> Return true if the database has been configured to perform encryption.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getErrorHandler()">getErrorHandler</A></B>()</CODE> <BR> Return the function to be called if an error occurs.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getErrorPrefix()">getErrorPrefix</A></B>()</CODE> <BR> Return the prefix string that appears before error messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.io.OutputStream</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getErrorStream()">getErrorStream</A></B>()</CODE> <BR> Return the an OutputStream for displaying error messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getExclusiveCreate()">getExclusiveCreate</A></B>()</CODE> <BR> Return true if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method is configured to fail if the database already exists.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getFeedbackHandler()">getFeedbackHandler</A></B>()</CODE> <BR> Return the object's methods to be called to provide feedback.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.util.Comparator</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getHashComparator()">getHashComparator</A></B>()</CODE> <BR> Return the Comparator used to compare keys in a Hash database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getHasher()">getHasher</A></B>()</CODE> <BR> Return the database-specific hash function.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getHashFillFactor()">getHashFillFactor</A></B>()</CODE> <BR> Return the hash table density.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getHashNumElements()">getHashNumElements</A></B>()</CODE> <BR> Return the estimate of the final size of the hash table.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getMessageHandler()">getMessageHandler</A></B>()</CODE> <BR> Return the function to be called with an informational message.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.io.OutputStream</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getMessageStream()">getMessageStream</A></B>()</CODE> <BR> Return the an OutputStream for displaying informational messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> long</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getMode()">getMode</A></B>()</CODE> <BR> Return the mode used to create files.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getMultiversion()">getMultiversion</A></B>()</CODE> <BR> Return true if the database is configured for multiversion concurrency control.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getNoMMap()">getNoMMap</A></B>()</CODE> <BR> Return true if the library is configured to not map this database into memory.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPageSize()">getPageSize</A></B>()</CODE> <BR> Return the size of the pages used to hold items in the database, in bytes.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPanicHandler()">getPanicHandler</A></B>()</CODE> <BR> Return the function to be called if the database environment panics.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.io.File[]</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionDirs()">getPartitionDirs</A></B>()</CODE> <BR> Return the array of directories the database extents should be created in or looked for.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionHandler()">getPartitionHandler</A></B>()</CODE> <BR> Return the function to be called to determine which partition a key resides in.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionKeys()">getPartitionKeys</A></B>()</CODE> <BR> Return the array of keys the database is configured to partition with.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPartitionParts()">getPartitionParts</A></B>()</CODE> <BR> Return the number of partitions the database is configured for.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getPriority()">getPriority</A></B>()</CODE> <BR> Return the the cache priority for pages referenced by this handle.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getQueueExtentSize()">getQueueExtentSize</A></B>()</CODE> <BR> Return the size of the extents used to hold pages in a Queue database, specified as a number of pages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getQueueInOrder()">getQueueInOrder</A></B>()</CODE> <BR> Return true if the <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getReadOnly()">getReadOnly</A></B>()</CODE> <BR> Return true if the database is configured in read-only mode.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getReadUncommitted()">getReadUncommitted</A></B>()</CODE> <BR> Return true if the database is configured to support read uncommitted.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRecordDelimiter()">getRecordDelimiter</A></B>()</CODE> <BR> Return the delimiting byte used to mark the end of a record in the backing source file for the Recno access method.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRecordLength()">getRecordLength</A></B>()</CODE> <BR> Return the database record length, in bytes.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRecordNumberAppender()">getRecordNumberAppender</A></B>()</CODE> <BR> Return the function to call after the record number has been selected but before the data has been stored into the database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRecordPad()">getRecordPad</A></B>()</CODE> <BR> Return the padding character for short, fixed-length records for the Queue and Recno access methods.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.io.File</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRecordSource()">getRecordSource</A></B>()</CODE> <BR> Return the name of an underlying flat text database file that is read to initialize a transient record number index.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getRenumbering()">getRenumbering</A></B>()</CODE> <BR> Return true if the logical record numbers are mutable, and change as records are added to and deleted from the database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getReverseSplitOff()">getReverseSplitOff</A></B>()</CODE> <BR> Return true if the Btree has been configured to not do reverse splits.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getSnapshot()">getSnapshot</A></B>()</CODE> <BR> Return true if the any specified backing source file will be read in its entirety when the database is opened.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getSortedDuplicates()">getSortedDuplicates</A></B>()</CODE> <BR> Return true if the database is configured to support sorted duplicate data items.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getTransactional()">getTransactional</A></B>()</CODE> <BR> Return true if the database open is enclosed within a transaction.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getTransactionNotDurable()">getTransactionNotDurable</A></B>()</CODE> <BR> Return true if the database environment is configured to not write log records for this database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getTruncate()">getTruncate</A></B>()</CODE> <BR> 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.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getType()">getType</A></B>()</CODE> <BR> Return the type of the database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#getUnsortedDuplicates()">getUnsortedDuplicates</A></B>()</CODE> <BR> Return true if the database is configured to support duplicate data items.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setAllowCreate(boolean)">setAllowCreate</A></B>(boolean allowCreate)</CODE> <BR> Configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method to create the database if it does not already exist.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeComparator(java.util.Comparator)">setBtreeComparator</A></B>(java.util.Comparator btreeComparator)</CODE> <BR> By default, a byte by byte lexicographic comparison is used for btree keys.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeCompressor(com.sleepycat.db.BtreeCompressor)">setBtreeCompressor</A></B>(<A HREF="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</A> btreeCompressor)</CODE> <BR> Set the Btree compression callbacks.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeMinKey(int)">setBtreeMinKey</A></B>(int btMinKey)</CODE> <BR> Set the minimum number of key/data pairs intended to be stored on any single Btree leaf page.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setBtreePrefixCalculator(com.sleepycat.db.BtreePrefixCalculator)">setBtreePrefixCalculator</A></B>(<A HREF="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</A> btreePrefixCalculator)</CODE> <BR> Set the Btree prefix callback.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setBtreeRecordNumbers(boolean)">setBtreeRecordNumbers</A></B>(boolean btreeRecordNumbers)</CODE> <BR> Configure the Btree to support retrieval by record number.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setByteOrder(int)">setByteOrder</A></B>(int byteOrder)</CODE> <BR> Set the byte order for integers in the stored database metadata.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setCacheCount(int)">setCacheCount</A></B>(int cacheCount)</CODE> <BR> Set the number of shared memory buffer pools, that is, the number of caches.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setCacheSize(long)">setCacheSize</A></B>(long cacheSize)</CODE> <BR> Set the size of the shared memory buffer pool, that is, the size of the cache.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setChecksum(boolean)">setChecksum</A></B>(boolean checksum)</CODE> <BR> Configure the database environment to do checksum verification of pages read into the cache from the backing filestore.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setCreateDir(java.io.File)">setCreateDir</A></B>(java.io.File createDir)</CODE> <BR> Specify which directory a database should be created in or looked for.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setDirtyRead(boolean)">setDirtyRead</A></B>(boolean dirtyRead)</CODE> <BR> <B>Deprecated.</B> <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></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setDuplicateComparator(java.util.Comparator)">setDuplicateComparator</A></B>(java.util.Comparator duplicateComparator)</CODE> <BR> Set the duplicate data item comparison callback.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setEncrypted(java.lang.String)">setEncrypted</A></B>(java.lang.String password)</CODE> <BR> Set the password used to perform encryption and decryption.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)">setErrorHandler</A></B>(<A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> errorHandler)</CODE> <BR> Set the function to be called if an error occurs.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorPrefix(java.lang.String)">setErrorPrefix</A></B>(java.lang.String errorPrefix)</CODE> <BR> Set the prefix string that appears before error messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)">setErrorStream</A></B>(java.io.OutputStream errorStream)</CODE> <BR> Set an OutputStream for displaying error messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setExclusiveCreate(boolean)">setExclusiveCreate</A></B>(boolean exclusiveCreate)</CODE> <BR> Configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method to fail if the database already exists.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setFeedbackHandler(com.sleepycat.db.FeedbackHandler)">setFeedbackHandler</A></B>(<A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> feedbackHandler)</CODE> <BR> Set an object whose methods are called to provide feedback.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setHashComparator(java.util.Comparator)">setHashComparator</A></B>(java.util.Comparator hashComparator)</CODE> <BR> Set the Hash key comparison function.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setHasher(com.sleepycat.db.Hasher)">setHasher</A></B>(<A HREF="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</A> hasher)</CODE> <BR> Set a database-specific hash function.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setHashFillFactor(int)">setHashFillFactor</A></B>(int hashFillFactor)</CODE> <BR> Set the desired density within the hash table.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setHashNumElements(int)">setHashNumElements</A></B>(int hashNumElements)</CODE> <BR> Set an estimate of the final size of the hash table.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)">setMessageHandler</A></B>(<A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> messageHandler)</CODE> <BR> Set a function to be called with an informational message.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)">setMessageStream</A></B>(java.io.OutputStream messageStream)</CODE> <BR> Set an OutputStream for displaying informational messages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMode(int)">setMode</A></B>(int mode)</CODE> <BR> 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).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMultiversion(boolean)">setMultiversion</A></B>(boolean multiversion)</CODE> <BR> Configured the database with support for multiversion concurrency control.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setNoMMap(boolean)">setNoMMap</A></B>(boolean noMMap)</CODE> <BR> Configure the library to not map this database into memory.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPageSize(int)">setPageSize</A></B>(int pageSize)</CODE> <BR> Set the size of the pages used to hold items in the database, in bytes.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPanicHandler(com.sleepycat.db.PanicHandler)">setPanicHandler</A></B>(<A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> panicHandler)</CODE> <BR> Set the function to be called if the database environment panics.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionByCallback(int, com.sleepycat.db.PartitionHandler)">setPartitionByCallback</A></B>(int parts, <A HREF="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</A> partitionHandler)</CODE> <BR> Enable or disable database partitioning, and set the callback that will be used for the partitioning.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionByRange(int, com.sleepycat.db.MultipleDataEntry)">setPartitionByRange</A></B>(int parts, <A HREF="../../../com/sleepycat/db/MultipleDataEntry.html" title="class in com.sleepycat.db">MultipleDataEntry</A> keys)</CODE> <BR> Enable or disable database partitioning, and set key ranges that will be used for the partitioning.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPartitionDirs(java.io.File[])">setPartitionDirs</A></B>(java.io.File[] dirs)</CODE> <BR> Specify the array of directories the database extents should be created in or looked for.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setPriority(com.sleepycat.db.CacheFilePriority)">setPriority</A></B>(<A HREF="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</A> priority)</CODE> <BR> Set the cache priority for pages referenced by the DB handle.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setQueueExtentSize(int)">setQueueExtentSize</A></B>(int queueExtentSize)</CODE> <BR> Set the size of the extents used to hold pages in a Queue database, specified as a number of pages.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setQueueInOrder(boolean)">setQueueInOrder</A></B>(boolean queueInOrder)</CODE> <BR> Configure <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><CODE>Database.consume</CODE></A> to return key/data pairs in order, always returning the key/data item from the head of the queue.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setReadOnly(boolean)">setReadOnly</A></B>(boolean readOnly)</CODE> <BR> Configure the database in read-only mode.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setReadUncommitted(boolean)">setReadUncommitted</A></B>(boolean readUncommitted)</CODE> <BR> Configure the database to support read uncommitted.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRecordDelimiter(int)">setRecordDelimiter</A></B>(int recordDelimiter)</CODE> <BR> Set the delimiting byte used to mark the end of a record in the backing source file for the Recno access method.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRecordLength(int)">setRecordLength</A></B>(int recordLength)</CODE> <BR> Specify the database record length, in bytes.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRecordNumberAppender(com.sleepycat.db.RecordNumberAppender)">setRecordNumberAppender</A></B>(<A HREF="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</A> recnoAppender)</CODE> <BR> Configure <A HREF="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.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.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRecordPad(int)">setRecordPad</A></B>(int recordPad)</CODE> <BR> Set the padding character for short, fixed-length records for the Queue and Recno access methods.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRecordSource(java.io.File)">setRecordSource</A></B>(java.io.File recordSource)</CODE> <BR> Set the underlying source file for the Recno access method.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setRenumbering(boolean)">setRenumbering</A></B>(boolean renumbering)</CODE> <BR> Configure the logical record numbers to be mutable, and change as records are added to and deleted from the database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setReverseSplitOff(boolean)">setReverseSplitOff</A></B>(boolean reverseSplitOff)</CODE> <BR> Configure the Btree to not do reverse splits.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setSnapshot(boolean)">setSnapshot</A></B>(boolean snapshot)</CODE> <BR> Specify that any specified backing source file be read in its entirety when the database is opened.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setSortedDuplicates(boolean)">setSortedDuplicates</A></B>(boolean sortedDuplicates)</CODE> <BR> Configure the database to support sorted, duplicate data items.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setTransactional(boolean)">setTransactional</A></B>(boolean transactional)</CODE> <BR> Enclose the database open within a transaction.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setTransactionNotDurable(boolean)">setTransactionNotDurable</A></B>(boolean transactionNotDurable)</CODE> <BR> Configure the database environment to not write log records for this database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setTruncate(boolean)">setTruncate</A></B>(boolean truncate)</CODE> <BR> Configure the database to be physically truncated by truncating the underlying file, discarding all previous databases it might have held.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setType(com.sleepycat.db.DatabaseType)">setType</A></B>(<A HREF="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</A> type)</CODE> <BR> Configure the type of the database.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setUnsortedDuplicates(boolean)">setUnsortedDuplicates</A></B>(boolean unsortedDuplicates)</CODE> <BR> Configure the database to support unsorted duplicate data items.</TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD> </TR> </TABLE> <P> <!-- ============ FIELD DETAIL =========== --> <A NAME="field_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Field Detail</B></FONT></TH> </TR> </TABLE> <A NAME="DEFAULT"><!-- --></A><H3> DEFAULT</H3> <PRE> public static final <A HREF="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</A> <B>DEFAULT</B></PRE> <DL> <DD>An instance created using the default constructor is initialized with the system's default settings. <P> <DL> </DL> </DL> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TH> </TR> </TABLE> <A NAME="DatabaseConfig()"><!-- --></A><H3> DatabaseConfig</H3> <PRE> public <B>DatabaseConfig</B>()</PRE> <DL> <DD>An instance created using the default constructor is initialized with the system's default settings. <P> </DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Method Detail</B></FONT></TH> </TR> </TABLE> <A NAME="cloneConfig()"><!-- --></A><H3> cloneConfig</H3> <PRE> public <A HREF="../../../com/sleepycat/db/DatabaseConfig.html" title="class in com.sleepycat.db">DatabaseConfig</A> <B>cloneConfig</B>()</PRE> <DL> <DD>Returns a copy of this configuration object. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setAllowCreate(boolean)"><!-- --></A><H3> setAllowCreate</H3> <PRE> public void <B>setAllowCreate</B>(boolean allowCreate)</PRE> <DL> <DD>Configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method to create the database if it does not already exist. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>allowCreate</CODE> - If true, configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method to create the database if it does not already exist.</DL> </DD> </DL> <HR> <A NAME="getAllowCreate()"><!-- --></A><H3> getAllowCreate</H3> <PRE> public boolean <B>getAllowCreate</B>()</PRE> <DL> <DD>Return true if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method is configured to create the database if it does not already exist.</DL> </DD> </DL> <HR> <A NAME="setBtreeComparator(java.util.Comparator)"><!-- --></A><H3> setBtreeComparator</H3> <PRE> public void <B>setBtreeComparator</B>(java.util.Comparator btreeComparator)</PRE> <DL> <DD>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. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getBtreeComparator()"><!-- --></A><H3> getBtreeComparator</H3> <PRE> public java.util.Comparator <B>getBtreeComparator</B>()</PRE> <DL> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setBtreeMinKey(int)"><!-- --></A><H3> setBtreeMinKey</H3> <PRE> public void <B>setBtreeMinKey</B>(int btMinKey)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>btMinKey</CODE> - The minimum number of key/data pairs intended to be stored on any single Btree leaf page.</DL> </DD> </DL> <HR> <A NAME="getBtreeMinKey()"><!-- --></A><H3> getBtreeMinKey</H3> <PRE> public int <B>getBtreeMinKey</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The minimum number of key/data pairs intended to be stored on any single Btree leaf page.</DL> </DD> </DL> <HR> <A NAME="setByteOrder(int)"><!-- --></A><H3> setByteOrder</H3> <PRE> public void <B>setByteOrder</B>(int byteOrder)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getByteOrder()"><!-- --></A><H3> getByteOrder</H3> <PRE> public int <B>getByteOrder</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><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.</DL> </DD> </DL> <HR> <A NAME="getByteSwapped()"><!-- --></A><H3> getByteSwapped</H3> <PRE> public boolean <B>getByteSwapped</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><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).</DL> </DD> </DL> <HR> <A NAME="setBtreeCompressor(com.sleepycat.db.BtreeCompressor)"><!-- --></A><H3> setBtreeCompressor</H3> <PRE> public void <B>setBtreeCompressor</B>(<A HREF="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</A> btreeCompressor)</PRE> <DL> <DD>Set the Btree compression callbacks. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getBtreeCompressor()"><!-- --></A><H3> getBtreeCompressor</H3> <PRE> public <A HREF="../../../com/sleepycat/db/BtreeCompressor.html" title="interface in com.sleepycat.db">BtreeCompressor</A> <B>getBtreeCompressor</B>()</PRE> <DL> <DD>Get the Btree compression callbacks. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setBtreePrefixCalculator(com.sleepycat.db.BtreePrefixCalculator)"><!-- --></A><H3> setBtreePrefixCalculator</H3> <PRE> public void <B>setBtreePrefixCalculator</B>(<A HREF="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</A> btreePrefixCalculator)</PRE> <DL> <DD>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. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getBtreePrefixCalculator()"><!-- --></A><H3> getBtreePrefixCalculator</H3> <PRE> public <A HREF="../../../com/sleepycat/db/BtreePrefixCalculator.html" title="interface in com.sleepycat.db">BtreePrefixCalculator</A> <B>getBtreePrefixCalculator</B>()</PRE> <DL> <DD>Return the Btree prefix callback. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The Btree prefix callback.</DL> </DD> </DL> <HR> <A NAME="setCacheSize(long)"><!-- --></A><H3> setCacheSize</H3> <PRE> public void <B>setCacheSize</B>(long cacheSize)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>cacheSize</CODE> - The size of the shared memory buffer pool, that is, the size of the cache. <p> <p> <DT><B>Throws:</B> <DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> </DD> </DL> <HR> <A NAME="getCacheSize()"><!-- --></A><H3> getCacheSize</H3> <PRE> public long <B>getCacheSize</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The size of the shared memory buffer pool, that is, the cache.</DL> </DD> </DL> <HR> <A NAME="setCreateDir(java.io.File)"><!-- --></A><H3> setCreateDir</H3> <PRE> public void <B>setCreateDir</B>(java.io.File createDir)</PRE> <DL> <DD>Specify which directory a database should be created in or looked for. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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> <DT><B>Throws:</B> <DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> </DD> </DL> <HR> <A NAME="getCreateDir()"><!-- --></A><H3> getCreateDir</H3> <PRE> public java.io.File <B>getCreateDir</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The directory a database will/has been created in or looked for.</DL> </DD> </DL> <HR> <A NAME="setCacheCount(int)"><!-- --></A><H3> setCacheCount</H3> <PRE> public void <B>setCacheCount</B>(int cacheCount)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>cacheCount</CODE> - The number of shared memory buffer pools, that is, the number of caches. <p> <p> <DT><B>Throws:</B> <DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> </DD> </DL> <HR> <A NAME="getCacheCount()"><!-- --></A><H3> getCacheCount</H3> <PRE> public int <B>getCacheCount</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The number of shared memory buffer pools, that is, the number of caches.</DL> </DD> </DL> <HR> <A NAME="setChecksum(boolean)"><!-- --></A><H3> setChecksum</H3> <PRE> public void <B>setChecksum</B>(boolean checksum)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getChecksum()"><!-- --></A><H3> getChecksum</H3> <PRE> public boolean <B>getChecksum</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database environment is configured to do checksum verification of pages read into the cache from the backing filestore.</DL> </DD> </DL> <HR> <A NAME="setReadUncommitted(boolean)"><!-- --></A><H3> setReadUncommitted</H3> <PRE> public void <B>setReadUncommitted</B>(boolean readUncommitted)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>readUncommitted</CODE> - If true, configure the database to support read uncommitted.</DL> </DD> </DL> <HR> <A NAME="getReadUncommitted()"><!-- --></A><H3> getReadUncommitted</H3> <PRE> public boolean <B>getReadUncommitted</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured to support read uncommitted.</DL> </DD> </DL> <HR> <A NAME="setDirtyRead(boolean)"><!-- --></A><H3> setDirtyRead</H3> <PRE> public void <B>setDirtyRead</B>(boolean dirtyRead)</PRE> <DL> <DD><B>Deprecated.</B> <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> <P> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>dirtyRead</CODE> - If true, configure the database to support read uncommitted. <p></DL> </DD> </DL> <HR> <A NAME="getDirtyRead()"><!-- --></A><H3> getDirtyRead</H3> <PRE> public boolean <B>getDirtyRead</B>()</PRE> <DL> <DD><B>Deprecated.</B> <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> <P> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured to support read uncommitted. <p></DL> </DD> </DL> <HR> <A NAME="setDuplicateComparator(java.util.Comparator)"><!-- --></A><H3> setDuplicateComparator</H3> <PRE> public void <B>setDuplicateComparator</B>(java.util.Comparator duplicateComparator)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>duplicateComparator</CODE> - the comparison callback for duplicate data items.</DL> </DD> </DL> <HR> <A NAME="getDuplicateComparator()"><!-- --></A><H3> getDuplicateComparator</H3> <PRE> public java.util.Comparator <B>getDuplicateComparator</B>()</PRE> <DL> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setEncrypted(java.lang.String)"><!-- --></A><H3> setEncrypted</H3> <PRE> public void <B>setEncrypted</B>(java.lang.String password)</PRE> <DL> <DD>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. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getEncrypted()"><!-- --></A><H3> getEncrypted</H3> <PRE> public boolean <B>getEncrypted</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database has been configured to perform encryption.</DL> </DD> </DL> <HR> <A NAME="setErrorHandler(com.sleepycat.db.ErrorHandler)"><!-- --></A><H3> setErrorHandler</H3> <PRE> public void <B>setErrorHandler</B>(<A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> errorHandler)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>errorHandler</CODE> - The function to be called if an error occurs.</DL> </DD> </DL> <HR> <A NAME="getErrorHandler()"><!-- --></A><H3> getErrorHandler</H3> <PRE> public <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> <B>getErrorHandler</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The function to be called if an error occurs.</DL> </DD> </DL> <HR> <A NAME="setErrorPrefix(java.lang.String)"><!-- --></A><H3> setErrorPrefix</H3> <PRE> public void <B>setErrorPrefix</B>(java.lang.String errorPrefix)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>errorPrefix</CODE> - The prefix string that appears before error messages.</DL> </DD> </DL> <HR> <A NAME="getErrorPrefix()"><!-- --></A><H3> getErrorPrefix</H3> <PRE> public java.lang.String <B>getErrorPrefix</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The prefix string that appears before error messages.</DL> </DD> </DL> <HR> <A NAME="setErrorStream(java.io.OutputStream)"><!-- --></A><H3> setErrorStream</H3> <PRE> public void <B>setErrorStream</B>(java.io.OutputStream errorStream)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>errorStream</CODE> - The application-specified OutputStream for error messages.</DL> </DD> </DL> <HR> <A NAME="getErrorStream()"><!-- --></A><H3> getErrorStream</H3> <PRE> public java.io.OutputStream <B>getErrorStream</B>()</PRE> <DL> <DD>Return the an OutputStream for displaying error messages. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The an OutputStream for displaying error messages.</DL> </DD> </DL> <HR> <A NAME="setExclusiveCreate(boolean)"><!-- --></A><H3> setExclusiveCreate</H3> <PRE> public void <B>setExclusiveCreate</B>(boolean exclusiveCreate)</PRE> <DL> <DD>Configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>exclusiveCreate</CODE> - If true, configure the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method to fail if the database already exists.</DL> </DD> </DL> <HR> <A NAME="getExclusiveCreate()"><!-- --></A><H3> getExclusiveCreate</H3> <PRE> public boolean <B>getExclusiveCreate</B>()</PRE> <DL> <DD>Return true if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> method is configured to fail if the database already exists.</DL> </DD> </DL> <HR> <A NAME="setFeedbackHandler(com.sleepycat.db.FeedbackHandler)"><!-- --></A><H3> setFeedbackHandler</H3> <PRE> public void <B>setFeedbackHandler</B>(<A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> feedbackHandler)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>feedbackHandler</CODE> - An object whose methods are called to provide feedback.</DL> </DD> </DL> <HR> <A NAME="getFeedbackHandler()"><!-- --></A><H3> getFeedbackHandler</H3> <PRE> public <A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> <B>getFeedbackHandler</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The object's methods to be called to provide feedback.</DL> </DD> </DL> <HR> <A NAME="setHashFillFactor(int)"><!-- --></A><H3> setHashFillFactor</H3> <PRE> public void <B>setHashFillFactor</B>(int hashFillFactor)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>hashFillFactor</CODE> - The desired density within the hash table.</DL> </DD> </DL> <HR> <A NAME="getHashFillFactor()"><!-- --></A><H3> getHashFillFactor</H3> <PRE> public int <B>getHashFillFactor</B>()</PRE> <DL> <DD>Return the hash table density. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The hash table density.</DL> </DD> </DL> <HR> <A NAME="setHashComparator(java.util.Comparator)"><!-- --></A><H3> setHashComparator</H3> <PRE> public void <B>setHashComparator</B>(java.util.Comparator hashComparator)</PRE> <DL> <DD>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. <P> <DD><DL> </DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getHashComparator()"><!-- --></A><H3> getHashComparator</H3> <PRE> public java.util.Comparator <B>getHashComparator</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The Comparator used to compare keys in a Hash database.</DL> </DD> </DL> <HR> <A NAME="setHasher(com.sleepycat.db.Hasher)"><!-- --></A><H3> setHasher</H3> <PRE> public void <B>setHasher</B>(<A HREF="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</A> hasher)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>hasher</CODE> - A database-specific hash function.</DL> </DD> </DL> <HR> <A NAME="getHasher()"><!-- --></A><H3> getHasher</H3> <PRE> public <A HREF="../../../com/sleepycat/db/Hasher.html" title="interface in com.sleepycat.db">Hasher</A> <B>getHasher</B>()</PRE> <DL> <DD>Return the database-specific hash function. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The database-specific hash function.</DL> </DD> </DL> <HR> <A NAME="setHashNumElements(int)"><!-- --></A><H3> setHashNumElements</H3> <PRE> public void <B>setHashNumElements</B>(int hashNumElements)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>hashNumElements</CODE> - An estimate of the final size of the hash table.</DL> </DD> </DL> <HR> <A NAME="getHashNumElements()"><!-- --></A><H3> getHashNumElements</H3> <PRE> public int <B>getHashNumElements</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The estimate of the final size of the hash table.</DL> </DD> </DL> <HR> <A NAME="setMessageHandler(com.sleepycat.db.MessageHandler)"><!-- --></A><H3> setMessageHandler</H3> <PRE> public void <B>setMessageHandler</B>(<A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> messageHandler)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>messageHandler</CODE> - The application-specified function for informational messages.</DL> </DD> </DL> <HR> <A NAME="getMessageHandler()"><!-- --></A><H3> getMessageHandler</H3> <PRE> public <A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> <B>getMessageHandler</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The function to be called with an informational message.</DL> </DD> </DL> <HR> <A NAME="setMessageStream(java.io.OutputStream)"><!-- --></A><H3> setMessageStream</H3> <PRE> public void <B>setMessageStream</B>(java.io.OutputStream messageStream)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>messageStream</CODE> - The application-specified OutputStream for informational messages.</DL> </DD> </DL> <HR> <A NAME="getMessageStream()"><!-- --></A><H3> getMessageStream</H3> <PRE> public java.io.OutputStream <B>getMessageStream</B>()</PRE> <DL> <DD>Return the an OutputStream for displaying informational messages. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The an OutputStream for displaying informational messages.</DL> </DD> </DL> <HR> <A NAME="setMode(int)"><!-- --></A><H3> setMode</H3> <PRE> public void <B>setMode</B>(int mode)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>mode</CODE> - the mode used to create files</DL> </DD> </DL> <HR> <A NAME="getMode()"><!-- --></A><H3> getMode</H3> <PRE> public long <B>getMode</B>()</PRE> <DL> <DD>Return the mode used to create files. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The mode used to create files.</DL> </DD> </DL> <HR> <A NAME="setMultiversion(boolean)"><!-- --></A><H3> setMultiversion</H3> <PRE> public void <B>setMultiversion</B>(boolean multiversion)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>multiversion</CODE> - If true, configure the database with support for multiversion concurrency control.</DL> </DD> </DL> <HR> <A NAME="getMultiversion()"><!-- --></A><H3> getMultiversion</H3> <PRE> public boolean <B>getMultiversion</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured for multiversion concurrency control.</DL> </DD> </DL> <HR> <A NAME="setNoMMap(boolean)"><!-- --></A><H3> setNoMMap</H3> <PRE> public void <B>setNoMMap</B>(boolean noMMap)</PRE> <DL> <DD>Configure the library to not map this database into memory. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>noMMap</CODE> - If true, configure the library to not map this database into memory.</DL> </DD> </DL> <HR> <A NAME="getNoMMap()"><!-- --></A><H3> getNoMMap</H3> <PRE> public boolean <B>getNoMMap</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the library is configured to not map this database into memory.</DL> </DD> </DL> <HR> <A NAME="setPageSize(int)"><!-- --></A><H3> setPageSize</H3> <PRE> public void <B>setPageSize</B>(int pageSize)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>pageSize</CODE> - The size of the pages used to hold items in the database, in bytes.</DL> </DD> </DL> <HR> <A NAME="getPageSize()"><!-- --></A><H3> getPageSize</H3> <PRE> public int <B>getPageSize</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The size of the pages used to hold items in the database, in bytes.</DL> </DD> </DL> <HR> <A NAME="setPanicHandler(com.sleepycat.db.PanicHandler)"><!-- --></A><H3> setPanicHandler</H3> <PRE> public void <B>setPanicHandler</B>(<A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> panicHandler)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>panicHandler</CODE> - The function to be called if the database environment panics.</DL> </DD> </DL> <HR> <A NAME="getPanicHandler()"><!-- --></A><H3> getPanicHandler</H3> <PRE> public <A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> <B>getPanicHandler</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The function to be called if the database environment panics.</DL> </DD> </DL> <HR> <A NAME="setPartitionByCallback(int, com.sleepycat.db.PartitionHandler)"><!-- --></A><H3> setPartitionByCallback</H3> <PRE> public void <B>setPartitionByCallback</B>(int parts, <A HREF="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</A> partitionHandler)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>parts</CODE> - The number of partitions that will be created. <p><DD><CODE>partitionHandler</CODE> - The function to be called to determine which partition a key resides in.</DL> </DD> </DL> <HR> <A NAME="setPartitionByRange(int, com.sleepycat.db.MultipleDataEntry)"><!-- --></A><H3> setPartitionByRange</H3> <PRE> public void <B>setPartitionByRange</B>(int parts, <A HREF="../../../com/sleepycat/db/MultipleDataEntry.html" title="class in com.sleepycat.db">MultipleDataEntry</A> keys)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>parts</CODE> - The number of partitions that will be created. <p><DD><CODE>keys</CODE> - A MultipleDatabaseEntry that contains the boundary keys for partitioning.</DL> </DD> </DL> <HR> <A NAME="getPartitionHandler()"><!-- --></A><H3> getPartitionHandler</H3> <PRE> public <A HREF="../../../com/sleepycat/db/PartitionHandler.html" title="interface in com.sleepycat.db">PartitionHandler</A> <B>getPartitionHandler</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The function to be called to determine which partition a key resides in.</DL> </DD> </DL> <HR> <A NAME="getPartitionParts()"><!-- --></A><H3> getPartitionParts</H3> <PRE> public int <B>getPartitionParts</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The number of partitions the database is configured for.</DL> </DD> </DL> <HR> <A NAME="getPartitionKeys()"><!-- --></A><H3> getPartitionKeys</H3> <PRE> public <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db">DatabaseEntry</A> <B>getPartitionKeys</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The array of keys the database is configured to partition with.</DL> </DD> </DL> <HR> <A NAME="setPartitionDirs(java.io.File[])"><!-- --></A><H3> setPartitionDirs</H3> <PRE> public void <B>setPartitionDirs</B>(java.io.File[] dirs)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>dirs</CODE> - The array of directories the database extents should be created in or looked for.</DL> </DD> </DL> <HR> <A NAME="getPartitionDirs()"><!-- --></A><H3> getPartitionDirs</H3> <PRE> public java.io.File[] <B>getPartitionDirs</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The array of directories the database extents should be created in or looked for.</DL> </DD> </DL> <HR> <A NAME="setPriority(com.sleepycat.db.CacheFilePriority)"><!-- --></A><H3> setPriority</H3> <PRE> public void <B>setPriority</B>(<A HREF="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</A> priority)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>priority</CODE> - The desired cache priority.</DL> </DD> </DL> <HR> <A NAME="getPriority()"><!-- --></A><H3> getPriority</H3> <PRE> public <A HREF="../../../com/sleepycat/db/CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</A> <B>getPriority</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The the cache priority for pages referenced by this handle.</DL> </DD> </DL> <HR> <A NAME="setQueueExtentSize(int)"><!-- --></A><H3> setQueueExtentSize</H3> <PRE> public void <B>setQueueExtentSize</B>(int queueExtentSize)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>queueExtentSize</CODE> - The number of pages in a Queue database extent.</DL> </DD> </DL> <HR> <A NAME="getQueueExtentSize()"><!-- --></A><H3> getQueueExtentSize</H3> <PRE> public int <B>getQueueExtentSize</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The size of the extents used to hold pages in a Queue database, specified as a number of pages.</DL> </DD> </DL> <HR> <A NAME="setQueueInOrder(boolean)"><!-- --></A><H3> setQueueInOrder</H3> <PRE> public void <B>setQueueInOrder</B>(boolean queueInOrder)</PRE> <DL> <DD>Configure <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>queueInOrder</CODE> - If true, configure the <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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.</DL> </DD> </DL> <HR> <A NAME="getQueueInOrder()"><!-- --></A><H3> getQueueInOrder</H3> <PRE> public boolean <B>getQueueInOrder</B>()</PRE> <DL> <DD>Return true if the <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the <A HREF="../../../com/sleepycat/db/Database.html#consume(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, boolean)"><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.</DL> </DD> </DL> <HR> <A NAME="setReadOnly(boolean)"><!-- --></A><H3> setReadOnly</H3> <PRE> public void <B>setReadOnly</B>(boolean readOnly)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>readOnly</CODE> - If true, configure the database in read-only mode.</DL> </DD> </DL> <HR> <A NAME="getReadOnly()"><!-- --></A><H3> getReadOnly</H3> <PRE> public boolean <B>getReadOnly</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured in read-only mode.</DL> </DD> </DL> <HR> <A NAME="setRecordNumberAppender(com.sleepycat.db.RecordNumberAppender)"><!-- --></A><H3> setRecordNumberAppender</H3> <PRE> public void <B>setRecordNumberAppender</B>(<A HREF="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</A> recnoAppender)</PRE> <DL> <DD>Configure <A HREF="../../../com/sleepycat/db/Database.html#append(com.sleepycat.db.Transaction, com.sleepycat.db.DatabaseEntry, com.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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getRecordNumberAppender()"><!-- --></A><H3> getRecordNumberAppender</H3> <PRE> public <A HREF="../../../com/sleepycat/db/RecordNumberAppender.html" title="interface in com.sleepycat.db">RecordNumberAppender</A> <B>getRecordNumberAppender</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The function to call after the record number has been selected but before the data has been stored into the database.</DL> </DD> </DL> <HR> <A NAME="setRecordDelimiter(int)"><!-- --></A><H3> setRecordDelimiter</H3> <PRE> public void <B>setRecordDelimiter</B>(int recordDelimiter)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getRecordDelimiter()"><!-- --></A><H3> getRecordDelimiter</H3> <PRE> public int <B>getRecordDelimiter</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The delimiting byte used to mark the end of a record in the backing source file for the Recno access method.</DL> </DD> </DL> <HR> <A NAME="setRecordLength(int)"><!-- --></A><H3> setRecordLength</H3> <PRE> public void <B>setRecordLength</B>(int recordLength)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>recordLength</CODE> - The database record length, in bytes.</DL> </DD> </DL> <HR> <A NAME="getRecordLength()"><!-- --></A><H3> getRecordLength</H3> <PRE> public int <B>getRecordLength</B>()</PRE> <DL> <DD>Return the database record length, in bytes. <p> This method may be called at any time during the life of the application. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The database record length, in bytes.</DL> </DD> </DL> <HR> <A NAME="setBtreeRecordNumbers(boolean)"><!-- --></A><H3> setBtreeRecordNumbers</H3> <PRE> public void <B>setBtreeRecordNumbers</B>(boolean btreeRecordNumbers)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getBtreeRecordNumbers()"><!-- --></A><H3> getBtreeRecordNumbers</H3> <PRE> public boolean <B>getBtreeRecordNumbers</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the Btree is configured to support retrieval by record number.</DL> </DD> </DL> <HR> <A NAME="setRecordPad(int)"><!-- --></A><H3> setRecordPad</H3> <PRE> public void <B>setRecordPad</B>(int recordPad)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>recordPad</CODE> - The padding character for short, fixed-length records for the Queue and Recno access methods.</DL> </DD> </DL> <HR> <A NAME="getRecordPad()"><!-- --></A><H3> getRecordPad</H3> <PRE> public int <B>getRecordPad</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The padding character for short, fixed-length records for the Queue and Recno access methods.</DL> </DD> </DL> <HR> <A NAME="setRecordSource(java.io.File)"><!-- --></A><H3> setRecordSource</H3> <PRE> public void <B>setRecordSource</B>(java.io.File recordSource)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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).</DL> </DD> </DL> <HR> <A NAME="getRecordSource()"><!-- --></A><H3> getRecordSource</H3> <PRE> public java.io.File <B>getRecordSource</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The name of an underlying flat text database file that is read to initialize a transient record number index.</DL> </DD> </DL> <HR> <A NAME="setRenumbering(boolean)"><!-- --></A><H3> setRenumbering</H3> <PRE> public void <B>setRenumbering</B>(boolean renumbering)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getRenumbering()"><!-- --></A><H3> getRenumbering</H3> <PRE> public boolean <B>getRenumbering</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the logical record numbers are mutable, and change as records are added to and deleted from the database.</DL> </DD> </DL> <HR> <A NAME="setReverseSplitOff(boolean)"><!-- --></A><H3> setReverseSplitOff</H3> <PRE> public void <B>setReverseSplitOff</B>(boolean reverseSplitOff)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getReverseSplitOff()"><!-- --></A><H3> getReverseSplitOff</H3> <PRE> public boolean <B>getReverseSplitOff</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the Btree has been configured to not do reverse splits.</DL> </DD> </DL> <HR> <A NAME="setSortedDuplicates(boolean)"><!-- --></A><H3> setSortedDuplicates</H3> <PRE> public void <B>setSortedDuplicates</B>(boolean sortedDuplicates)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getSortedDuplicates()"><!-- --></A><H3> getSortedDuplicates</H3> <PRE> public boolean <B>getSortedDuplicates</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured to support sorted duplicate data items.</DL> </DD> </DL> <HR> <A NAME="setUnsortedDuplicates(boolean)"><!-- --></A><H3> setUnsortedDuplicates</H3> <PRE> public void <B>setUnsortedDuplicates</B>(boolean unsortedDuplicates)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getUnsortedDuplicates()"><!-- --></A><H3> getUnsortedDuplicates</H3> <PRE> public boolean <B>getUnsortedDuplicates</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database is configured to support duplicate data items.</DL> </DD> </DL> <HR> <A NAME="setSnapshot(boolean)"><!-- --></A><H3> setSnapshot</H3> <PRE> public void <B>setSnapshot</B>(boolean snapshot)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getSnapshot()"><!-- --></A><H3> getSnapshot</H3> <PRE> public boolean <B>getSnapshot</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the any specified backing source file will be read in its entirety when the database is opened.</DL> </DD> </DL> <HR> <A NAME="getTransactional()"><!-- --></A><H3> getTransactional</H3> <PRE> public boolean <B>getTransactional</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database open is enclosed within a transaction.</DL> </DD> </DL> <HR> <A NAME="setTransactional(boolean)"><!-- --></A><H3> setTransactional</H3> <PRE> public void <B>setTransactional</B>(boolean transactional)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>transactional</CODE> - If true, enclose the database open within a transaction.</DL> </DD> </DL> <HR> <A NAME="setTransactionNotDurable(boolean)"><!-- --></A><H3> setTransactionNotDurable</H3> <PRE> public void <B>setTransactionNotDurable</B>(boolean transactionNotDurable)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getTransactionNotDurable()"><!-- --></A><H3> getTransactionNotDurable</H3> <PRE> public boolean <B>getTransactionNotDurable</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>True if the database environment is configured to not write log records for this database.</DL> </DD> </DL> <HR> <A NAME="setTruncate(boolean)"><!-- --></A><H3> setTruncate</H3> <PRE> public void <B>setTruncate</B>(boolean truncate)</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><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.</DL> </DD> </DL> <HR> <A NAME="getTruncate()"><!-- --></A><H3> getTruncate</H3> <PRE> public boolean <B>getTruncate</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><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.</DL> </DD> </DL> <HR> <A NAME="setType(com.sleepycat.db.DatabaseType)"><!-- --></A><H3> setType</H3> <PRE> public void <B>setType</B>(<A HREF="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</A> type)</PRE> <DL> <DD>Configure the type of the database. <p> If they type is DB_UNKNOWN, the database must already exist. <p> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>type</CODE> - The type of the database.</DL> </DD> </DL> <HR> <A NAME="getType()"><!-- --></A><H3> getType</H3> <PRE> public <A HREF="../../../com/sleepycat/db/DatabaseType.html" title="class in com.sleepycat.db">DatabaseType</A> <B>getType</B>()</PRE> <DL> <DD>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> <P> <DD><DL> </DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>The type of the database.</DL> </DD> </DL> <!-- ========= END OF CLASS DATA ========= --> <HR> <!-- ======= START OF BOTTOM NAVBAR ====== --> <A NAME="navbar_bottom"><!-- --></A> <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_bottom_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../com/sleepycat/db/Database.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> <A HREF="../../../com/sleepycat/db/DatabaseEntry.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?com/sleepycat/db/DatabaseConfig.html" target="_top"><B>FRAMES</B></A> <A HREF="DatabaseConfig.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> </BODY> </HTML>