shard-crystal-db/api/0.2.2/DB/Database.html
2016-12-21 18:12:40 -03:00

379 lines
11 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta id="repository-name" content="github.com/crystal-lang/crystal-db">
<link href="../css/style.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="../js/doc.js"></script>
<title>DB::Database - github.com/crystal-lang/crystal-db</title>
</head>
<body>
<div id="types-list">
<div id="search-box">
<input type="search" id="search-input" placeholder="Search...">
</div>
<ul>
<li><a href="../index.html">README</a></li>
</ul>
<ul>
<li class="parent open current" data-id="github.com/crystal-lang/crystal-db/DB" data-name="db">
<a href="../DB.html">DB</a>
<ul>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Any" data-name="db::any">
<a href="../DB/Any.html">Any</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Connection" data-name="db::connection">
<a href="../DB/Connection.html">Connection</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/ConnectionLost" data-name="db::connectionlost">
<a href="../DB/ConnectionLost.html">ConnectionLost</a>
</li>
<li class=" current" data-id="github.com/crystal-lang/crystal-db/DB/Database" data-name="db::database">
<a href="../DB/Database.html">Database</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Disposable" data-name="db::disposable">
<a href="../DB/Disposable.html">Disposable</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Driver" data-name="db::driver">
<a href="../DB/Driver.html">Driver</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Error" data-name="db::error">
<a href="../DB/Error.html">Error</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/ExecResult" data-name="db::execresult">
<a href="../DB/ExecResult.html">ExecResult</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Mappable" data-name="db::mappable">
<a href="../DB/Mappable.html">Mappable</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/MappingException" data-name="db::mappingexception">
<a href="../DB/MappingException.html">MappingException</a>
</li>
<li class="parent " data-id="github.com/crystal-lang/crystal-db/DB/Pool" data-name="db::pool(t)">
<a href="../DB/Pool.html">Pool</a>
<ul>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Pool/TimeoutHelper" data-name="db::pool::timeouthelper">
<a href="../DB/Pool/TimeoutHelper.html">TimeoutHelper</a>
</li>
</ul>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/PoolRetryAttemptsExceeded" data-name="db::poolretryattemptsexceeded">
<a href="../DB/PoolRetryAttemptsExceeded.html">PoolRetryAttemptsExceeded</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/PoolStatement" data-name="db::poolstatement">
<a href="../DB/PoolStatement.html">PoolStatement</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/PoolTimeout" data-name="db::pooltimeout">
<a href="../DB/PoolTimeout.html">PoolTimeout</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/QueryMethods" data-name="db::querymethods">
<a href="../DB/QueryMethods.html">QueryMethods</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/ResultSet" data-name="db::resultset">
<a href="../DB/ResultSet.html">ResultSet</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/Statement" data-name="db::statement">
<a href="../DB/Statement.html">Statement</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/StatementMethods" data-name="db::statementmethods">
<a href="../DB/StatementMethods.html">StatementMethods</a>
</li>
<li class=" " data-id="github.com/crystal-lang/crystal-db/DB/StringKeyCache" data-name="db::stringkeycache(t)">
<a href="../DB/StringKeyCache.html">StringKeyCache</a>
</li>
</ul>
</li>
</ul>
</div>
<div id="main-content">
<h1 class="type-name">
<span class="kind">class</span> DB::Database
</h1>
<ul class="superclass-hierarchy"><li class="superclass"><a href="../DB/Database.html">DB::Database</a></li><li class="superclass">Reference</li><li class="superclass">Object</li></ul>
<h2>Overview</h2>
<p>Acts as an entry point for database access.
Connections are managed by a pool.
The connection pool can be configured from URI parameters:</p>
<ul><li>initial_pool_size (default 1)</li><li>max_pool_size (default 0 = unlimited)</li><li>max_idle_pool_size (default 1)</li><li>checkout_timeout (default 5.0)</li><li>retry_attempts (default 1)</li><li>retry_delay (in seconds, default 1.0)</li></ul></ul>
<p>It should be created from DB module. See <code><a href="../DB.html#open%28uri%3AURI%7CString%29-class-method">DB#open</a></code>.</p>
<p>Refer to <code><a href="../DB/QueryMethods.html">QueryMethods</a></code> for documentation about querying the database.</p>
<h2>Included Modules</h2>
<ul class="other-types-list">
<li class="other-type"><a href="../DB/QueryMethods.html">DB::QueryMethods</a></li>
</ul>
<h2>Defined in:</h2>
<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/database.cr#L19" target="_blank">db/database.cr</a>
<br/>
<h2>Instance Method Summary</h2>
<ul class="list-summary">
<li class="entry-summary">
<a href="#close-instance-method" class="signature"><strong>#close</strong></a>
<div class="summary"><p>Closes all connection to the database.</p></div>
</li>
<li class="entry-summary">
<a href="#setup_connection%28%26proc%3AConnection-%3ENil%29-instance-method" class="signature"><strong>#setup_connection</strong>(&proc : Connection -> Nil)</a>
</li>
<li class="entry-summary">
<a href="#uri%3AURI-instance-method" class="signature"><strong>#uri</strong> : URI</a>
<div class="summary"><p>Returns the uri with the connection settings to the database</p></div>
</li>
<li class="entry-summary">
<a href="#using_connection%28%26block%29-instance-method" class="signature"><strong>#using_connection</strong>(&block)</a>
<div class="summary"><p>yields a connection from the pool the connection is returned to the pool after when the block ends</p></div>
</li>
</ul>
<div class="methods-inherited">
<h3>Instance methods inherited from module <code><a href="../DB/QueryMethods.html">DB::QueryMethods</a></code></h3>
<a href="../DB/QueryMethods.html#exec%28query%2C%2Aargs%29-instance-method" class="tooltip">
<span>exec(query, *args)</span>
exec</a>,
<a href="../DB/QueryMethods.html#query%28query%2C%2Aargs%29-instance-method" class="tooltip">
<span>query(query, *args)<br/>query(query, *args, &block)</span>
query</a>,
<a href="../DB/QueryMethods.html#query_all%28query%2C%2Aargs%2C%26block%3AResultSet-%3EU%29%3AArray%28U%29-instance-method" class="tooltip">
<span>query_all(query, *args, &block : ResultSet -> U) : Array(U)<br/>query_all(query, *args, as types : Tuple)<br/>query_all(query, *args, as type : Class)</span>
query_all</a>,
<a href="../DB/QueryMethods.html#query_one%28query%2C%2Aargs%2C%26block%3AResultSet-%3EU%29%3AU-instance-method" class="tooltip">
<span>query_one(query, *args, &block : ResultSet -> U) : U<br/>query_one(query, *args, as types : Tuple)<br/>query_one(query, *args, as type : Class)</span>
query_one</a>,
<a href="../DB/QueryMethods.html#query_one%3F%28query%2C%2Aargs%2C%26block%3AResultSet-%3EU%29%3AU%3F-instance-method" class="tooltip">
<span>query_one?(query, *args, &block : ResultSet -> U) : U?<br/>query_one?(query, *args, as types : Tuple)<br/>query_one?(query, *args, as type : Class)</span>
query_one?</a>,
<a href="../DB/QueryMethods.html#scalar%28query%2C%2Aargs%29-instance-method" class="tooltip">
<span>scalar(query, *args)</span>
scalar</a>
</div>
<h2>Instance Method Detail</h2>
<div class="entry-detail" id="close-instance-method">
<div class="signature">
def <strong>close</strong>
<a class="method-permalink" href="#close-instance-method">#</a>
</div>
<div class="doc"><p>Closes all connection to the database.</p></div>
<br/>
<div>
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/database.cr#L54" target="_blank">View source</a>]
</div>
</div>
<div class="entry-detail" id="setup_connection&#40;&amp;proc:Connection-&gt;Nil&#41;-instance-method">
<div class="signature">
def <strong>setup_connection</strong>(&proc : <a href="../DB/Connection.html">Connection</a> -> Nil)
<a class="method-permalink" href="#setup_connection%28%26proc%3AConnection-%3ENil%29-instance-method">#</a>
</div>
<br/>
<div>
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/database.cr#L46" target="_blank">View source</a>]
</div>
</div>
<div class="entry-detail" id="uri:URI-instance-method">
<div class="signature">
def <strong>uri</strong> : URI
<a class="method-permalink" href="#uri%3AURI-instance-method">#</a>
</div>
<div class="doc"><p>Returns the uri with the connection settings to the database</p></div>
<br/>
<div>
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/database.cr#L26" target="_blank">View source</a>]
</div>
</div>
<div class="entry-detail" id="using_connection&#40;&amp;block&#41;-instance-method">
<div class="signature">
def <strong>using_connection</strong>(&block)
<a class="method-permalink" href="#using_connection%28%26block%29-instance-method">#</a>
</div>
<div class="doc"><p>yields a connection from the pool
the connection is returned to the pool after
when the block ends</p></div>
<br/>
<div>
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/database.cr#L79" target="_blank">View source</a>]
</div>
</div>
</div>
</body>
</html>