Files
deb-python-cassandra-driver/cassandra/connection.py
2013-05-06 14:42:03 -05:00

420 lines
14 KiB
Python

import pyev
import errno
from collections import defaultdict, deque
from functools import partial
import itertools
import logging
import socket
from threading import RLock, Event, Lock, Thread
import traceback
from cassandra import ConsistencyLevel
from cassandra.marshal import (int8_unpack, int32_unpack)
from cassandra.decoder import (OptionsMessage, ReadyMessage, AuthenticateMessage,
StartupMessage, ErrorMessage, CredentialsMessage,
QueryMessage, ResultMessage, decode_response)
log = logging.getLogger(__name__)
locally_supported_compressions = {}
try:
import snappy
except ImportError:
pass
else:
# work around apparently buggy snappy decompress
def decompress(byts):
if byts == '\x00':
return ''
return snappy.decompress(byts)
locally_supported_compressions['snappy'] = (snappy.compress, decompress)
MAX_STREAM_PER_CONNECTION = 128
PROTOCOL_VERSION = 0x01
PROTOCOL_VERSION_MASK = 0x7f
HEADER_DIRECTION_FROM_CLIENT = 0x00
HEADER_DIRECTION_TO_CLIENT = 0x80
HEADER_DIRECTION_MASK = 0x80
NONBLOCKING = (errno.EAGAIN, errno.EWOULDBLOCK)
class ConnectionException(Exception):
def __init__(self, message, host=None):
Exception.__init__(self, message)
self.host = host
class ProgrammingError(Exception):
pass
class InternalError(Exception):
pass
class ProtocolError(Exception):
pass
_loop = pyev.default_loop(pyev.EVBACKEND_SELECT)
_loop_notifier = _loop.async(lambda *a, **kw: None)
_loop_notifier.start()
# prevent _loop_notifier from keeping the loop from returning
_loop.unref()
_loop_started = None
_loop_lock = Lock()
def _run_loop():
while True:
end_condition = _loop.start()
# there are still active watchers, no deadlock
with _loop_lock:
if end_condition:
log.debug("Restarting event loop")
continue
else:
# all Connections have been closed, no active watchers
log.debug("All Connections currently closed, event loop ended")
global _loop_started
_loop_started = False
break
def _start_loop():
global _loop_started
should_start = False
with _loop_lock:
if not _loop_started:
log.debug("Starting pyev event loop")
_loop_started = True
should_start = True
if should_start:
t = Thread(target=_run_loop, name="async_event_loop")
t.daemon = False
t.start()
return should_start
class Connection(object):
in_buffer_size = 4096
out_buffer_size = 4096
cql_version = "3.0.1"
read_watcher = None
write_watcher = None
keyspace = None
compressor = None
decompressor = None
connect_error = None
in_flight = 0
is_defunct = False
is_closed = False
buf = ""
total_reqd_bytes = 0
@classmethod
def factory(cls, *args, **kwargs):
conn = cls(*args, **kwargs)
conn.connected_event.wait()
if conn.connect_error:
raise conn.connect_error
else:
return conn
def __init__(self, host='127.0.0.1', port=9042, credentials=None, sockopts=None, compression=True):
self.host = host
self.port = port
self.credentials = credentials
self.compression = compression
self.connected_event = Event()
self.make_request_id = itertools.cycle(xrange(127)).next
self._callbacks = {}
self._push_watchers = defaultdict(set)
self._lock = RLock()
self.deque = deque()
self.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
self.socket.connect((host, port))
self.socket.setblocking(0)
if sockopts:
for args in sockopts:
self.socket.setsockopt(*args)
self.read_watcher = pyev.Io(self.socket._sock, pyev.EV_READ, _loop, self.handle_read)
self.write_watcher = pyev.Io(self.socket._sock, pyev.EV_WRITE, _loop, self.handle_write)
with _loop_lock:
self.read_watcher.start()
self.write_watcher.start()
log.debug("Sending initial options message for new Connection to %s" % (host,))
self.send_msg(OptionsMessage(), self._handle_options_response)
# start the global event loop if needed
if not _start_loop():
# if the loop was already started, notify it
with _loop_lock:
_loop_notifier.send()
def close(self):
with self._lock:
if self.is_closed:
return
self.is_closed = True
self.read_watcher.stop()
self.write_watcher.stop()
self.socket.close()
with _loop_lock:
_loop_notifier.send()
def __del__(self):
self.close()
def defunct(self, exc):
pass
def handle_write(self, watcher, revents):
try:
next_msg = self.deque.popleft()
except IndexError:
self.write_watcher.stop()
return
try:
sent = self.socket.send(next_msg)
except socket.error, err:
if (err.args[0] in NONBLOCKING):
self.deque.appendleft(next_msg)
else:
self.handle_error()
return
else:
if sent < len(next_msg):
self.deque.appendleft(next_msg[sent:])
if not self.deque:
self.write_watcher.stop()
def handle_read(self, watcher, revents):
try:
buf = self.socket.recv(self.in_buffer_size)
except socket.error, err:
if err.args[0] not in NONBLOCKING:
self.handle_error()
return
if buf:
self.buf += buf
while True:
if len(self.buf) < 8:
# we don't have a complete header yet
break
elif self.total_reqd_bytes and len(self.buf) < self.total_reqd_bytes:
# we already saw a header, but we don't have a complete message yet
break
else:
body_len = int32_unpack(self.buf[4:8])
if len(self.buf) - 8 >= body_len:
msg = self.buf[:8 + body_len]
self.buf = self.buf[8 + body_len:]
self.total_reqd_bytes = 0
self.process_msg(msg, body_len)
else:
self.total_reqd_bytes = body_len + 8
else:
logging.debug("connection closed by server")
self.close()
def process_msg(self, msg, body_len):
version, flags, stream_id, opcode = map(int8_unpack, msg[:4])
# check that the protocol version is supported
if version & PROTOCOL_VERSION_MASK != PROTOCOL_VERSION:
raise ProtocolError("Unsupported CQL protocol version %d" % version)
# check that the header direction is correct
if version & HEADER_DIRECTION_MASK != HEADER_DIRECTION_TO_CLIENT:
raise ProtocolError(
"Unexpected request from server with opcode "
"%04x, stream id %r" % (opcode, stream_id))
if body_len > 0:
body = msg[8:]
elif body_len == 0:
body = ""
else:
raise ProtocolError("Got negative body length: %r" % body_len)
response = decode_response(stream_id, flags, opcode, body, self.decompressor)
try:
if stream_id < 0:
self.handle_pushed(response)
else:
self._callbacks.pop(stream_id)(response)
except:
log.error("Callback handler errored, ignoring: %s" % traceback.format_exc())
def handle_error(self):
log.error(traceback.format_exc())
self.is_defunct = True
def handle_pushed(self, response):
for cb in self._push_watchers[response.type]:
try:
cb(response)
except:
log.error("Pushed event handler errored, ignoring: %s" % traceback.format_exc())
def push(self, data):
sabs = self.out_buffer_size
with self._lock:
if len(data) > sabs:
for i in xrange(0, len(data), sabs):
self.deque.append(data[i:i + sabs])
else:
self.deque.append(data)
if not self.write_watcher.active:
with _loop_lock:
self.write_watcher.start()
_loop_notifier.send()
def send_msg(self, msg, cb):
request_id = self.make_request_id()
self._callbacks[request_id] = cb
self.push(msg.to_string(request_id, compression=self.compressor))
return request_id
def wait_for_responses(self, *msgs):
waiter = ResponseWaiter(len(msgs))
for i, msg in enumerate(msgs):
self.send_msg(msg, partial(waiter.got_response, index=i))
waiter.event.wait()
return waiter.responses
def register_watcher(self, event_type, callback):
self._push_watchers[event_type].add(callback)
def register_watchers(self, type_callback_dict):
for event_type, callback in type_callback_dict.items():
self.register_watcher(event_type, callback)
def _handle_options_response(self, options_response):
log.debug("Received options response on new Connection from %s" % self.host)
self.supported_cql_versions = options_response.cql_versions
self.remote_supported_compressions = options_response.options['COMPRESSION']
if self.cql_version:
if self.cql_version not in self.supported_cql_versions:
raise ProgrammingError(
"cql_version %r is not supported by remote (w/ native "
"protocol). Supported versions: %r"
% (self.cql_version, self.supported_cql_versions))
else:
self.cql_version = self.supported_cql_versions[0]
opts = {}
self._compressor = None
if self.compression:
overlap = (set(locally_supported_compressions) &
set(self.remote_supported_compressions))
if len(overlap) == 0:
log.debug("No available compression types supported on both ends."
" locally supported: %r. remotely supported: %r"
% (locally_supported_compressions,
self.remote_supported_compressions))
else:
compression_type = iter(overlap).next() # choose any
opts['COMPRESSION'] = compression_type
# set the decompressor here, but set the compressor only after
# a successful Ready message
self._compressor, self.decompressor = \
locally_supported_compressions[compression_type]
sm = StartupMessage(cqlversion=self.cql_version, options=opts)
self.send_msg(sm, cb=self._handle_startup_response)
def _handle_startup_response(self, startup_response):
if isinstance(startup_response, ReadyMessage):
log.debug("Got ReadyMessage on new Connection from %s" % self.host)
if self._compressor:
self.compressor = self._compressor
self.connected_event.set()
elif isinstance(startup_response, AuthenticateMessage):
log.debug("Got AuthenticateMessage on new Connection from %s" % self.host)
if self.credentials is None:
self.connect_error = ProgrammingError(
'Remote end requires authentication.')
self.connected_event.set()
return
self.authenticator = startup_response.authenticator
cm = CredentialsMessage(creds=self.credentials)
self.send_msg(cm, cb=self._handle_startup_response)
elif isinstance(startup_response, ErrorMessage):
log.debug("Received ErrorMessage on new Connection from %s" % self.host)
self.connect_error = ProgrammingError(
"Server did not accept credentials. %s"
% startup_response.summary_msg())
self.connected_event.set()
else:
log.error("Unexpected response during Connection setup")
self.connect_error = InternalError(
"Unexpected response %r during connection setup"
% (startup_response,))
self.connected_event.set()
def set_keyspace(self, keyspace):
if not keyspace:
return
with self._lock:
if keyspace == self.keyspace:
return
query = 'USE "%s"' % (keyspace,)
try:
result = self.wait_for_response(
QueryMessage(query=query, consistency_level=ConsistencyLevel.ONE))
if isinstance(result, ResultMessage):
self.keyspace = keyspace
else:
self.defunct(ConnectionException(
"Problem while setting keyspace: %r" % (result,), self.host))
except Exception, exc:
self.defunct(ConnectionException(
"Problem while setting keyspace: %r" % (exc,), self.host))
class ResponseWaiter(object):
def __init__(self, num_responses):
self.pending = num_responses
self.responses = [None] * num_responses
self.event = Event()
def got_response(self, response, index):
self.responses[index] = response
self.pending -= 1
if not self.pending:
self.event.set()