uTools-Manuals/docs/java/javax/sql/CommonDataSource.html

275 lines
11 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
javax.sql
</div>
<h2 class="title" title="Interface CommonDataSource">Interface CommonDataSource</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../javax/sql/ConnectionPoolDataSource.html" title="javax.sql中的接口">ConnectionPoolDataSource</a> <a href="../../javax/sql/DataSource.html" title="javax.sql中的接口">DataSource</a> <a href="../../javax/sql/XADataSource.html" title="javax.sql中的接口">XADataSource</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">CommonDataSource</span></pre>
<div class="block">
接口,定义它们之间的共同的方法
<code>DataSource</code>
<code>XADataSource</code>
<code>ConnectionPoolDataSource</code>
</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>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/sql/CommonDataSource.html#getLoginTimeout--">getLoginTimeout</a></span>()</code>
<div class="block">
获取此数据源在尝试连接到数据库时可以等待的最长时间(秒)。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../java/io/PrintWriter.html" title="class in java.io">PrintWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/sql/CommonDataSource.html#getLogWriter--">getLogWriter</a></span>()</code>
<div class="block">
检索此
<code>DataSource</code>对象的日志记录器。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../java/util/logging/Logger.html" title="class in java.util.logging">Logger</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/sql/CommonDataSource.html#getParentLogger--">getParentLogger</a></span>()</code>
<div class="block">
返回此数据源使用的所有日志记录器的父记录器。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/sql/CommonDataSource.html#setLoginTimeout-int-">setLoginTimeout</a></span>(int seconds)</code>
<div class="block">
设置该数据源在尝试连接到数据库时将等待的最长时间(秒)。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/sql/CommonDataSource.html#setLogWriter-java.io.PrintWriter-">setLogWriter</a></span>(<a href="../../java/io/PrintWriter.html" title="class in java.io">PrintWriter</a> out)</code>
<div class="block">
将此
<code>DataSource</code>对象的日志写入器设置为给定的
<code>java.io.PrintWriter</code>对象。
</div> </td>
</tr>
</tbody>
</table> </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>方法详细信息</h3> <a name="getLogWriter--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLogWriter</h4> <pre><a href="../../java/io/PrintWriter.html" title="class in java.io">PrintWriter</a> getLogWriter()
throws <a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<p> <span>检索此<code>DataSource</code>对象的日志记录器。</span> </p>
<p> <span>日志写入器是一个字符输出流,将为该数据源打印所有日志记录和跟踪消息。</span> <span>这包括通过该对象的方法打印的消息,由该对象制造的其他对象的方法打印的消息等等。</span> <span>打印到数据源特定日志记录器的消息不会打印到与<code>java.sql.DriverManager</code>类相关<code>java.sql.DriverManager</code>的日志记录器中。</span> <span>创建<code>DataSource</code>对象时,日志写入器最初为空;</span> <span>换句话说,默认是禁用日志记录。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此数据源的日志写入程序,如果禁用日志记录,则为空
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/sql/CommonDataSource.html#setLogWriter-java.io.PrintWriter-"><code>setLogWriter(java.io.PrintWriter)</code></a>
</dd>
</dl> </li>
</ul> <a name="setLogWriter-java.io.PrintWriter-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setLogWriter</h4> <pre>void setLogWriter(<a href="../../java/io/PrintWriter.html" title="class in java.io">PrintWriter</a> out)
throws <a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<p> <span>将此<code>DataSource</code>对象的日志记录器设置为给定的<code>java.io.PrintWriter</code>对象。</span> </p>
<p> <span>日志写入器是一个字符输出流,将为该数据源打印所有日志记录和跟踪消息。</span> <span>这包括通过该对象的方法打印的消息,由该对象制造的其他对象的方法打印的消息等等。</span> <span>打印到数据源特定日志记录器的消息不会打印到与<code>java.sql.DriverManager</code>类相关<code>java.sql.DriverManager</code>的日志记录器中。</span> <span>创建<code>DataSource</code>对象时,日志写入器最初为空;</span> <span>换句话说,默认是禁用日志记录。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>out</code> - 新的日志记录器</span>
<span>禁用日志记录设置为null</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/sql/CommonDataSource.html#getLogWriter--"><code>getLogWriter()</code></a>
</dd>
</dl> </li>
</ul> <a name="setLoginTimeout-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setLoginTimeout</h4> <pre>void setLoginTimeout(int seconds)
throws <a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<p> <span>设置该数据源在尝试连接到数据库时将等待的最长时间(秒)。</span> <span>值为零表示超时是默认的系统超时(如果有的话);</span> <span>否则,它指定没有超时。</span> <span>创建<code>DataSource</code>对象时,登录超时最初为零。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>seconds</code> - 数据源登录时间限制
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/sql/CommonDataSource.html#getLoginTimeout--"><code>getLoginTimeout()</code></a>
</dd>
</dl> </li>
</ul> <a name="getLoginTimeout--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLoginTimeout</h4> <pre>int getLoginTimeout()
throws <a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></pre>
<div class="block">
<span>获取此数据源在尝试连接到数据库时可以等待的最长时间(秒)。</span>
<span>值为零表示超时是默认的系统超时,如果有的话;</span>
<span>否则,这意味着没有超时。</span>
<span>创建<code>DataSource</code>对象时,登录超时最初为零。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
数据源登录时间限制
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/sql/SQLException.html" title="class in java.sql">SQLException</a></code> - 如果发生数据库访问错误。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/sql/CommonDataSource.html#setLoginTimeout-int-"><code>setLoginTimeout(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getParentLogger--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getParentLogger</h4> <pre><a href="../../java/util/logging/Logger.html" title="class in java.util.logging">Logger</a> getParentLogger()
throws <a href="../../java/sql/SQLFeatureNotSupportedException.html" title="class in java.sql">SQLFeatureNotSupportedException</a></pre>
<div class="block">
<span>返回此数据源使用的所有日志记录器的父记录器。</span>
<span>这应该是距离根记录器最远的记录器,该记录器仍然是此数据源使用的所有记录器的祖先。</span>
<span>配置此记录器将影响数据源生成的所有日志消息。</span>
<span>在最坏的情况下,这可能是根记录器。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该数据源的父记录器
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/sql/SQLFeatureNotSupportedException.html" title="class in java.sql">SQLFeatureNotSupportedException</a></code> - 如果数据源不使用
<code>java.util.logging</code>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.7
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>