|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.datastax.driver.core.Session
public class Session
A session holds connections to a Cassandra cluster, allowing to query it. Each session will maintain multiple connections to the cluster nodes, and provides policies to choose which node to use for each query (round-robin on all nodes of the cluster by default), handles retries for failed query (when it makes sense), etc...
Session instances are thread-safe and usually a single instance is enough per application. However, a given session can only be set to one keyspace at a time, so one instance per keyspace is necessary.
Method Summary | |
---|---|
ResultSet |
execute(Query query)
Execute the provided query. |
ResultSet |
execute(String query)
Execute the provided query. |
ResultSetFuture |
executeAsync(Query query)
Execute the provided query asynchronously. |
ResultSetFuture |
executeAsync(String query)
Execute the provided query asynchronously. |
Cluster |
getCluster()
The Cluster object this session is part of. |
PreparedStatement |
prepare(String query)
Prepare the provided query. |
void |
shutdown()
Shutdown this session instance. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public ResultSet execute(String query)
execute(new SimpleStatement(query))
.
query
- the CQL query to execute.
NoHostAvailableException
- if no host in the cluster can be
contacted successfully to execute this query.
QueryExecutionException
- if the query triggered an execution
exception, i.e. an exception thrown by Cassandra when it cannot execute
the query with the requested consistency level successfully.
QueryValidationException
- if the query if invalid (syntax error,
unauthorized or any other validation problem).public ResultSet execute(Query query)
query
- the CQL query to execute (that can be either a Statement
or a BoundStatement
). If it is a BoundStatement
, all variables must have been bound (the statement must
be ready).
NoHostAvailableException
- if no host in the cluster can be
contacted successfully to execute this query.
QueryExecutionException
- if the query triggered an execution
exception, i.e. an exception thrown by Cassandra when it cannot execute
the query with the requested consistency level successfully.
QueryValidationException
- if the query if invalid (syntax error,
unauthorized or any other validation problem).
IllegalStateException
- if query
is a BoundStatement
but !query.isReady()
.public ResultSetFuture executeAsync(String query)
executeAsync(new SimpleStatement(query))
.
query
- the CQL query to execute.
public ResultSetFuture executeAsync(Query query)
ResultSetFuture
.
Note that for queries that doesn't return a result (INSERT, UPDATE and
DELETE), you will need to access the ResultSetFuture (i.e. call one of
its get method to make sure the query was successful.
query
- the CQL query to execute (that can be either a Statement
or a BoundStatement
). If it is a BoundStatement
, all variables must have been bound (the statement must
be ready).
IllegalStateException
- if query
is a BoundStatement
but !query.isReady()
.public PreparedStatement prepare(String query)
query
- the CQL query to prepare
query
.
NoHostAvailableException
- if no host in the cluster can be
contacted successfully to execute this query.public void shutdown()
This closes all connections used by this sessions. Note that if you want
to shutdown the full Cluster
instance this session is part of,
you should use Cluster.shutdown()
instead (which will call this
method for all session but also release some additional ressources).
This method has no effect if the session was already shutdown.
public Cluster getCluster()
Cluster
object this session is part of.
Cluster
object this session is part of.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |