Files
Yasuhiro KIMURA 9678929700 Update to 18.1.40
2020-07-24 01:10:28 +09:00

496 lines
18 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (11.0.7) on Mon Jun 01 06:40:53 PDT 2020 -->
<title>CacheFile (Oracle - Berkeley DB Java API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="date" content="2020-06-01">
<link rel="stylesheet" type="text/css" href="../../../style.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../jquery/jquery-ui.css" title="Style">
<script type="text/javascript" src="../../../script.js"></script>
<script type="text/javascript" src="../../../jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="../../../jquery/jquery-3.4.1.js"></script>
<script type="text/javascript" src="../../../jquery/jquery-ui.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="CacheFile (Oracle - Berkeley DB Java API)";
}
}
catch(err) {
}
//-->
var data = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
var pathtoroot = "../../../";
var useModuleDirectories = true;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/CacheFile.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><b>Berkeley DB</b><br><font size="-1"> version 18.1.40</font></div>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding">&nbsp;</div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle"><span class="packageLabelInType">Package</span>&nbsp;<a href="package-summary.html">com.sleepycat.db</a></div>
<h2 title="Class CacheFile" class="title">Class CacheFile</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li>com.sleepycat.db.CacheFile</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<pre>public class <span class="typeNameLabel">CacheFile</span>
extends java.lang.Object</pre>
<div class="block">This class allows applications to modify settings for
a <a href="Database.html" title="class in com.sleepycat.db"><code>Database</code></a> using the <a href="Database.html#getCacheFile--"><code>Database.getCacheFile</code></a>.</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colSecond" scope="col">Method</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>long</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getMaximumSize--">getMaximumSize</a></span>()</code></th>
<td class="colLast">
<div class="block">Return the maximum size for the file backing the database, or 0 if
no maximum file size has been configured.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getNoFile--">getNoFile</a></span>()</code></th>
<td class="colLast">
<div class="block">Return true if the opening of backing temporary files for in-memory
databases has been disallowed.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code><a href="CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getPriority--">getPriority</a></span>()</code></th>
<td class="colLast">
<div class="block">Return the cache priority for pages from the specified file.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getUnlink--">getUnlink</a></span>()</code></th>
<td class="colLast">
<div class="block">Return true if the file will be removed when the last reference to it is
closed.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setMaximumSize-long-">setMaximumSize</a></span>&#8203;(long&nbsp;bytes)</code></th>
<td class="colLast">
<div class="block">Set the
maximum size for the file backing the database.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setNoFile-boolean-">setNoFile</a></span>&#8203;(boolean&nbsp;onoff)</code></th>
<td class="colLast">
<div class="block">Disallow opening backing temporary files for in-memory
databases, even if they expand to fill the entire cache.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setPriority-com.sleepycat.db.CacheFilePriority-">setPriority</a></span>&#8203;(<a href="CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a>&nbsp;priority)</code></th>
<td class="colLast">
<div class="block">Set the
cache priority for pages from the specified file.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setUnlink-boolean-">setUnlink</a></span>&#8203;(boolean&nbsp;onoff)</code></th>
<td class="colLast">
<div class="block">Remove the file when the last reference to it is closed.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="getPriority--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPriority</h4>
<pre class="methodSignature">public&nbsp;<a href="CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a>&nbsp;getPriority()
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Return the cache priority for pages from the specified file.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The cache priority for pages from the specified file.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="setPriority-com.sleepycat.db.CacheFilePriority-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPriority</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setPriority&#8203;(<a href="CacheFilePriority.html" title="class in com.sleepycat.db">CacheFilePriority</a>&nbsp;priority)
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Set the
cache priority for pages from the specified file.
<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. Setting the priority is only
advisory, and does not guarantee pages will be treated in a specific
way.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>priority</code> - The cache priority for pages from the specified file.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="getMaximumSize--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMaximumSize</h4>
<pre class="methodSignature">public&nbsp;long&nbsp;getMaximumSize()
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Return the maximum size for the file backing the database, or 0 if
no maximum file size has been configured.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The maximum size for the file backing the database, or 0 if
no maximum file size has been configured.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="setMaximumSize-long-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setMaximumSize</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setMaximumSize&#8203;(long&nbsp;bytes)
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Set the
maximum size for the file backing the database.
<p>Attempts to allocate new pages in the file after the limit has been
reached will fail.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>bytes</code> - The maximum size for the file backing the database.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="getNoFile--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getNoFile</h4>
<pre class="methodSignature">public&nbsp;boolean&nbsp;getNoFile()
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Return true if the opening of backing temporary files for in-memory
databases has been disallowed.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>True if the opening of backing temporary files for in-memory
databases has been disallowed.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="setNoFile-boolean-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setNoFile</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setNoFile&#8203;(boolean&nbsp;onoff)
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Disallow opening backing temporary files for in-memory
databases, even if they expand to fill the entire cache.
<p>Attempts to create new file pages after the cache has been filled
will fail.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>onoff</code> - If true,
disallow opening backing temporary files for in-memory
databases, even if they expand to fill the entire cache.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="getUnlink--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getUnlink</h4>
<pre class="methodSignature">public&nbsp;boolean&nbsp;getUnlink()
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Return true if the file will be removed when the last reference to it is
closed.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>True if the file will be removed when the last reference to it is
closed.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
<a name="setUnlink-boolean-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>setUnlink</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setUnlink&#8203;(boolean&nbsp;onoff)
throws <a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></pre>
<div class="block">Remove the file when the last reference to it is closed.
<p>
This method may be called at any time during the life of the application.
<p></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>onoff</code> - If true,
remove the file when the last reference to it is closed.
<p></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</a></code> - if a failure occurs.</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/CacheFile.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-all.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><b>Berkeley DB</b><br><font size="-1"> version 18.1.40</font></div>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small><font size=1>Copyright (c) 1996, 2020 Oracle and/or its affiliates. All rights reserved.</font></small></p>
</body>
</html>