class PartitionedConnectionPool[T <: Connection] extends PartitionedAsyncObjectPool[T] with Connection
- Alphabetic
- By Inheritance
- PartitionedConnectionPool
- Connection
- PartitionedAsyncObjectPool
- AsyncObjectPool
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Instance Constructors
- new PartitionedConnectionPool(factory: ObjectFactory[T], configuration: PoolConfiguration, numberOfPartitions: Int, executionContext: ExecutionContext = ExecutorServiceUtils.CachedExecutionContext)
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##(): Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def availables: Iterable[T]
- Definition Classes
- PartitionedAsyncObjectPool
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- def close: Future[PartitionedAsyncObjectPool[T]]
Closes this pool and future calls to **take** will cause the scala.concurrent.Future to raise an com.github.mauricio.async.db.pool.PoolAlreadyTerminatedException.
Closes this pool and future calls to **take** will cause the scala.concurrent.Future to raise an com.github.mauricio.async.db.pool.PoolAlreadyTerminatedException.
- Definition Classes
- PartitionedAsyncObjectPool → AsyncObjectPool
- def connect: Future[Connection]
Connects this object to the database.
Connects this object to the database. Connection objects are not necessarily created with a connection to the database so you might have to call this method to be able to run queries against it.
- Definition Classes
- PartitionedConnectionPool → Connection
- def disconnect: Future[Connection]
Disconnects this object.
Disconnects this object. You should discard this object after calling this method. No more queries will be accepted.
- Definition Classes
- PartitionedConnectionPool → Connection
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def giveBack(item: T): Future[PartitionedAsyncObjectPool[T]]
Returns an object taken from the pool back to it.
Returns an object taken from the pool back to it. This object will become available for another client to use. If the object is invalid or can not be reused for some reason the scala.concurrent.Future returned will contain the error that prevented this object of being added back to the pool. The object is then discarded from the pool.
- Definition Classes
- PartitionedAsyncObjectPool → AsyncObjectPool
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def inTransaction[A](f: (Connection) => Future[A])(implicit context: ExecutionContext = executionContext): Future[A]
Executes an (asynchronous) function within a transaction block.
Executes an (asynchronous) function within a transaction block. If the function completes successfully, the transaction is committed, otherwise it is aborted.
- f
operation to execute on this connection
- returns
result of f, conditional on transaction operations succeeding
- Definition Classes
- PartitionedConnectionPool → Connection
- def inUse: Iterable[T]
- Definition Classes
- PartitionedAsyncObjectPool
- def isClosed: Boolean
- Attributes
- protected
- Definition Classes
- PartitionedAsyncObjectPool
- def isConnected: Boolean
Checks whether we are still connected to the database.
Checks whether we are still connected to the database.
- Definition Classes
- PartitionedConnectionPool → Connection
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- def queued: Iterable[Promise[T]]
- Definition Classes
- PartitionedAsyncObjectPool
- def sendPreparedStatement(query: String, values: Seq[Any] = List()): Future[QueryResult]
Sends a prepared statement to the database.
Sends a prepared statement to the database. Prepared statements are special statements that are pre-compiled by the database to run faster, they also allow you to avoid SQL injection attacks by not having to concatenate strings from possibly unsafe sources (like users) and sending them directy to the database.
When sending a prepared statement, you can insert ? signs in your statement and then provide values at the method call 'values' parameter, as in:
connection.sendPreparedStatement( "SELECT * FROM users WHERE users.login = ?", Array( "john-doe" ) )
As you are using the ? as the placeholder for the value, you don't have to perform any kind of manipulation to the value, just provide it as is and the database will clean it up. You must provide as many parameters as you have provided placeholders, so, if your query is as "INSERT INTO users (login,email) VALUES (?,?)" you have to provide an array with at least two values, as in:
Array("john-doe", "[email protected]")
You can still use this method if your statement doesn't take any parameters, the default is an empty collection.
- Definition Classes
- PartitionedConnectionPool → Connection
- def sendQuery(query: String): Future[QueryResult]
Sends a statement to the database.
Sends a statement to the database. The statement can be anything your database can execute. Not all statements will return a collection of rows, so check the returned object if there are rows available.
- Definition Classes
- PartitionedConnectionPool → Connection
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def take: Future[T]
Returns an object from the pool to the callee with the returned future.
Returns an object from the pool to the callee with the returned future. If the pool can not create or enqueue requests it will fill the returned scala.concurrent.Future with an com.github.mauricio.async.db.pool.PoolExhaustedException.
- returns
future that will eventually return a usable pool object.
- Definition Classes
- PartitionedAsyncObjectPool → AsyncObjectPool
- def toString(): String
- Definition Classes
- AnyRef → Any
- def use[A](f: (T) => Future[A])(implicit executionContext: ExecutionContext): Future[A]
Retrieve and use an object from the pool for a single computation, returning it when the operation completes.
Retrieve and use an object from the pool for a single computation, returning it when the operation completes.
- f
function that uses the object
- returns
f wrapped with take and giveBack
- Definition Classes
- AsyncObjectPool
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()