cassandra-driver 1.0.0.rc.1 → 1.0.0

data/lib/cassandra/client/query_result.rb

@@ -1,230 +0,0 @@
-# encoding: utf-8
-
-#--
-# Copyright 2013-2014 DataStax, Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#++
-
-module Cassandra
-  module Client
-    # Query results encapsulate the rows returned by a query.
-    #
-    # In addition to containing the rows it contains metadata about the data
-    # types of the columns of the rows, and it knows the ID of the trace,
-    # if tracing was requested for the query.
-    #
-    # When paging over a big result you can use {#last_page?} to find out if the
-    # page is the last, or {#next_page} to retrieve the next page.
-    #
-    # `QueryResult` is an `Enumerable` so it can be mapped, filtered, reduced, etc.
-    class QueryResult
-      include Enumerable
-
-      # @return [ResultMetadata]
-      attr_reader :metadata
-
-      # The ID of the query trace associated with the query, if any.
-      #
-      # @return [Cassandra::Uuid]
-      attr_reader :trace_id
-
-      # @private
-      attr_reader :paging_state
-
-      # @private
-      def initialize(metadata, rows, trace_id, paging_state)
-        @metadata = ResultMetadata.new(metadata)
-        @rows = rows
-        @trace_id = trace_id
-        @paging_state = paging_state
-      end
-
-      # Returns whether or not there are any rows in this result set
-      def empty?
-        @rows.empty?
-      end
-
-      # Returns count of underlying rows
-      def size
-        @rows.size
-      end
-      alias :length :size
-
-      # Iterates over each row in the result set.
-      #
-      # @yieldparam [Hash] row each row in the result set as a hash
-      # @return [Enumerable<Hash>]
-      def each(&block)
-        @rows.each(&block)
-      end
-      alias_method :each_row, :each
-
-      # Returns true when there are no more pages to load.
-      #
-      # This is only relevant when you have requested paging of the results with
-      # the `:page_size` option to {Cassandra::Client::Client#execute} or
-      # {Cassandra::Client::PreparedStatement#execute}.
-      #
-      # @see Cassandra::Client::Client#execute
-      def last_page?
-        true
-      end
-
-      # Returns the next page or nil when there is no next page.
-      #
-      # This is only relevant when you have requested paging of the results with
-      # the `:page_size` option to {Cassandra::Client::Client#execute} or
-      # {Cassandra::Client::PreparedStatement#execute}.
-      #
-      # @see Cassandra::Client::Client#execute
-      def next_page
-        nil
-      end
-    end
-
-    # @private
-    class PagedQueryResult < QueryResult
-      def metadata
-        @result.metadata
-      end
-
-      def trace_id
-        @result.trace_id
-      end
-
-      def paging_state
-        @result.paging_state
-      end
-
-      def empty?
-        @result.empty?
-      end
-
-      def each(&block)
-        @result.each(&block)
-      end
-      alias_method :each_row, :each
-
-      def last_page?
-        @last_page
-      end
-
-      def next_page
-      end
-    end
-
-    # @private
-    class AsynchronousPagedQueryResult < PagedQueryResult
-      def initialize(request, result, options)
-        @request = request
-        @result = result
-        @result = result
-        @options = options.merge(paging_state: result.paging_state)
-        @last_page = !result.paging_state
-      end
-    end
-
-    # @private
-    class AsynchronousQueryPagedQueryResult < AsynchronousPagedQueryResult
-      def initialize(client, request, result, options)
-        super(request, result, options)
-        @client = client
-      end
-
-      def next_page
-        return Ione::Future.resolved(nil) if last_page?
-        @client.execute(@request.cql, *@request.values, @options)
-      end
-    end
-
-    # @private
-    class AsynchronousPreparedPagedQueryResult < AsynchronousPagedQueryResult
-      def initialize(prepared_statement, request, result, options)
-        super(request, result, options)
-        @prepared_statement = prepared_statement
-      end
-
-      def next_page
-        return Ione::Future.resolved(nil) if last_page?
-        @prepared_statement.execute(*@request.values, @options)
-      end
-    end
-
-    # @private
-    class SynchronousPagedQueryResult < PagedQueryResult
-      include SynchronousBacktrace
-
-      def initialize(asynchronous_result)
-        @result = asynchronous_result
-      end
-
-      def async
-        @result
-      end
-
-      def last_page?
-        @result.last_page?
-      end
-
-      def next_page
-        synchronous_backtrace do
-          asynchronous_result = @result.next_page.value
-          asynchronous_result && self.class.new(asynchronous_result)
-        end
-      end
-    end
-
-    # @private
-    class LazyQueryResult < QueryResult
-      def initialize(metadata, lazy_rows, trace_id, paging_state)
-        super(metadata, nil, trace_id, paging_state)
-        @raw_metadata = metadata
-        @lazy_rows = lazy_rows
-        @lock = Mutex.new
-      end
-
-      def empty?
-        ensure_materialized
-        super
-      end
-
-      def size
-        ensure_materialized
-        super
-      end
-      alias :length :size
-
-      def each(&block)
-        ensure_materialized
-        super
-      end
-      alias_method :each_row, :each
-
-      private
-
-      def ensure_materialized
-        unless @rows
-          @lock.lock
-          begin
-            unless @rows
-              @rows = @lazy_rows.materialize(@raw_metadata)
-            end
-          ensure
-            @lock.unlock
-          end
-        end
-      end
-    end
-  end
-end

data/lib/cassandra/client/request_runner.rb

@@ -1,70 +0,0 @@
-# encoding: utf-8
-
-#--
-# Copyright 2013-2014 DataStax, Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#++
-
-module Cassandra
-  module Client
-    # @private
-    class RequestRunner
-      def execute(connection, request, timeout=nil, raw_metadata=nil)
-        connection.send_request(request, timeout).map do |response|
-          case response
-          when Protocol::RawRowsResultResponse
-            LazyQueryResult.new(raw_metadata, response, response.trace_id, response.paging_state)
-          when Protocol::RowsResultResponse
-            QueryResult.new(response.metadata, response.rows, response.trace_id, response.paging_state)
-          when Protocol::VoidResultResponse
-            response.trace_id ? VoidResult.new(response.trace_id) : VoidResult::INSTANCE
-          when Protocol::ErrorResponse
-            cql = request.is_a?(Protocol::QueryRequest) ? request.cql : nil
-            raise response.to_error(cql)
-          when Protocol::SetKeyspaceResultResponse
-            KeyspaceChanged.new(response.keyspace)
-          when Protocol::AuthenticateResponse
-            AuthenticationRequired.new(response.authentication_class)
-          when Protocol::SupportedResponse
-            response.options
-          else
-            if block_given?
-              yield response
-            else
-              nil
-            end
-          end
-        end
-      end
-    end
-
-    # @private
-    class AuthenticationRequired
-      attr_reader :authentication_class
-
-      def initialize(authentication_class)
-        @authentication_class = authentication_class
-      end
-    end
-
-    # @private
-    class KeyspaceChanged
-      attr_reader :keyspace
-
-      def initialize(keyspace)
-        @keyspace = keyspace
-      end
-    end
-  end
-end

data/lib/cassandra/client/result_metadata.rb

@@ -1,48 +0,0 @@
-# encoding: utf-8
-
-#--
-# Copyright 2013-2014 DataStax, Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#++
-
-module Cassandra
-  module Client
-    # A collection of metadata (keyspace, table, name and type) of a result set.
-    #
-    # @see Cassandra::Client::ColumnMetadata
-    class ResultMetadata
-      include Enumerable
-
-      # @private
-      def initialize(metadata)
-        @metadata = metadata.each_with_object({}) { |m, h| h[m[2]] = ColumnMetadata.new(*m) }
-      end
-
-      # Returns the column metadata
-      #
-      # @return [ColumnMetadata] column_metadata the metadata for the column
-      def [](column_name)
-        @metadata[column_name]
-      end
-
-      # Iterates over the metadata for each column
-      #
-      # @yieldparam [ColumnMetadata] metadata the metadata for each column
-      # @return [Enumerable<ColumnMetadata>]
-      def each(&block)
-        @metadata.each_value(&block)
-      end
-    end
-  end
-end

data/lib/cassandra/client/void_result.rb

@@ -1,78 +0,0 @@
-# encoding: utf-8
-
-#--
-# Copyright 2013-2014 DataStax, Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#++
-
-module Cassandra
-  module Client
-    # Many CQL queries do not return any rows, but they can still return
-    # data about the query, for example the trace ID. This class exist to make
-    # that data available.
-    #
-    # It has the exact same API as {Cassandra::Client::QueryResult} so that you don't
-    # need to check the return value of for example {Cassandra::Client::Client#execute}.
-    #
-    # @see Cassandra::Client::QueryResult
-    # @see Cassandra::Client::Client#execute
-    # @see Cassandra::Client::PreparedStatement#execute
-    class VoidResult
-      include Enumerable
-
-      INSTANCE = self.new
-
-      # @return [ResultMetadata]
-      attr_reader :metadata
-
-      # The ID of the query trace associated with the query, if any.
-      #
-      # @return [Cassandra::Uuid]
-      attr_reader :trace_id
-
-      # @private
-      def initialize(trace_id=nil)
-        @trace_id = trace_id
-        @metadata = EMPTY_METADATA
-      end
-
-      # Always returns true
-      def empty?
-        true
-      end
-
-      # Always returns true
-      def last_page?
-        true
-      end
-
-      # Always returns nil
-      def next_page
-        nil
-      end
-
-      # No-op for API compatibility with {QueryResult}.
-      #
-      # @return [Enumerable]
-      def each(&block)
-        self
-      end
-      alias_method :each_row, :each
-
-      private
-
-      EMPTY_METADATA = ResultMetadata.new([])
-    end
-  end
-end