289 lines
8.2 KiB
HTML
289 lines
8.2 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::Driver - 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=" " 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=" current" 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">abstract class</span> DB::Driver
|
||
|
|
|
||
|
|
</h1>
|
||
|
|
|
||
|
|
|
||
|
|
<ul class="superclass-hierarchy"><li class="superclass"><a href="../DB/Driver.html">DB::Driver</a></li><li class="superclass">Reference</li><li class="superclass">Object</li></ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Overview</h2>
|
||
|
|
|
||
|
|
<p>Database driver implementors must subclass <code><a href="../DB/Driver.html">Driver</a></code>,
|
||
|
|
register with a driver_name using <code><a href="../DB.html#register_driver%28driver_name%2Cdriver_class%3ADriver.class%29-class-method">DB#register_driver</a></code> and
|
||
|
|
override the factory method <code><a href="../DB/Driver.html#build_connection%28db%3ADatabase%29%3AConnection-instance-method">#build_connection</a></code>.</p>
|
||
|
|
|
||
|
|
<pre><code><span class="k">require</span> <span class="s">"db"</span>
|
||
|
|
|
||
|
|
<span class="k">class</span> <span class="t">FakeDriver</span> <span class="o"><</span> <span class="t">Driver</span>
|
||
|
|
<span class="k">def</span> <span class="m">build_connection</span>(db)
|
||
|
|
<span class="t">FakeConnection</span>.<span class="k">new</span> db
|
||
|
|
<span class="k">end</span>
|
||
|
|
<span class="k">end</span>
|
||
|
|
|
||
|
|
<span class="t">DB</span>.register_driver <span class="s">"fake"</span>, <span class="t">FakeDriver</span></code></pre>
|
||
|
|
|
||
|
|
<p>Access to this fake datbase will be available with</p>
|
||
|
|
|
||
|
|
<pre><code><span class="t">DB</span>.open <span class="s">"fake://..."</span> <span class="k">do</span> <span class="o">|</span>db<span class="o">|</span>
|
||
|
|
<span class="c"># ... use db ...</span>
|
||
|
|
<span class="k">end</span></code></pre>
|
||
|
|
|
||
|
|
<p>Refer to <code><a href="../DB/Connection.html">Connection</a></code>, <code><a href="../DB/Statement.html">Statement</a></code> and <code><a href="../DB/ResultSet.html">ResultSet</a></code> for further
|
||
|
|
driver implementation instructions.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Defined in:</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/driver.cr#L28" target="_blank">db/driver.cr</a>
|
||
|
|
|
||
|
|
<br/>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Instance Method Summary</h2>
|
||
|
|
<ul class="list-summary">
|
||
|
|
|
||
|
|
<li class="entry-summary">
|
||
|
|
<a href="#build_connection%28db%3ADatabase%29%3AConnection-instance-method" class="signature"><strong>#build_connection</strong>(db : Database) : Connection</a>
|
||
|
|
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li class="entry-summary">
|
||
|
|
<a href="#connection_pool_options%28params%3AHTTP%3A%3AParams%29-instance-method" class="signature"><strong>#connection_pool_options</strong>(params : HTTP::Params)</a>
|
||
|
|
|
||
|
|
</li>
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<div class="methods-inherited">
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Instance Method Detail</h2>
|
||
|
|
|
||
|
|
<div class="entry-detail" id="build_connection(db:Database):Connection-instance-method">
|
||
|
|
<div class="signature">
|
||
|
|
abstract
|
||
|
|
def <strong>build_connection</strong>(db : <a href="../DB/Database.html">Database</a>) : <a href="../DB/Connection.html">Connection</a>
|
||
|
|
|
||
|
|
<a class="method-permalink" href="#build_connection%28db%3ADatabase%29%3AConnection-instance-method">#</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<br/>
|
||
|
|
<div>
|
||
|
|
|
||
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/driver.cr#L29" target="_blank">View source</a>]
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="entry-detail" id="connection_pool_options(params:HTTP::Params)-instance-method">
|
||
|
|
<div class="signature">
|
||
|
|
|
||
|
|
def <strong>connection_pool_options</strong>(params : HTTP::Params)
|
||
|
|
|
||
|
|
<a class="method-permalink" href="#connection_pool_options%28params%3AHTTP%3A%3AParams%29-instance-method">#</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<br/>
|
||
|
|
<div>
|
||
|
|
|
||
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/73108c169ec87d229c7b92d793748d9796d20802/src/db/driver.cr#L31" target="_blank">View source</a>]
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|