aerospike 1.0.12 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2108e0a0c9b5702676743d0164661891aeeaad17
-  data.tar.gz: 00009afe933f69b92438e3f9bf143db6d1e8e9b3
+  metadata.gz: 235bd4afc86f8bf263a458a22f7e13a247bdda6c
+  data.tar.gz: 35e141ffb29702a9cf1ea046fe731a89e2de9bb5
 SHA512:
-  metadata.gz: 31ba8b20828e50ced593cd94dd1134053dc6f6d0bdc0b66c3c100865e8612d3282039a43a847b2962777bca2c5e2a9cac3b1140e654e874c5360a5b3c1e299a2
-  data.tar.gz: 37b8b4d078d5a011c3a4c0008f94893694c30f38372557611c75a9069e94359f0e909af1404aa4742c8579276f28891156862ab26da42d602ac1a8f5a86c84cd
+  metadata.gz: e4e54c1051e29cf790f4df58ee1822c3e20fb8120f3d2aef61c69c0da516a6389d429a99d71ad8d1df8fd05b92f18c245b9e0bd2215610ee4c527dca36ae72ed
+  data.tar.gz: be8ec2b6d0247dc6fdec77eba9269561970a6688d0a328cfda38cb7a822c9b9047cdb6ff34a101dfcf60b10de629daf9113cebfa3095bd4b3d2c3cb20e04bfca

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+v2.0.0 / 2016-05-27
+===================
+
+* **Breaking Changes** - Please refer to detailed list of [API changes](docs/api-changes.md#v2.0.0) for further details.
+  * Incompatible integer key digests: digests for integer keys computed by v2 and v1 are different; the Aerospike server uses the key digest to retrieve records. This will impact your ability to read records with integer keys that were created by a v1 client version.
+  * Backward incompatible changes to the `Aerospike::Client.new` initializer.
+  * The `Aerospike::Client.new_many` initializer has been removed; use `Aerospike::Client.new` instead.
+  * Drop support for Ruby 1.9.3; requires Ruby 2.0 or later.
+
+* **Improvements**
+  * Add support for List and Map operations on List/Map Complex Data Types (CDT); requires Aerospike Server version 3.9 or later. [CLIENT-559]
+  * Read Aerospike server address from AEROSPIKE_HOSTS env variable if not specified explicity in client constructor.
+  * Add 2.3.1 to supported Ruby versions on Travis-CI.
+
+* **Fixes**
+  * Fix digest creation for integer keys. [PR #34](https://github.com/aerospike/aerospike-client-ruby/pull/34). Thanks to [@murphyslaw](https://github.com/murphyslaw)!
+  * Prevent "value must be enumerable" error when client cannot connect to cluster. [#35](https://github.com/aerospike/aerospike-client-ruby/issues/35). Thanks to [@rohanthewiz](https://github.com/rohanthewiz)!
+
 1.0.12 / 2016-02-11
 ===================
 
@@ -10,7 +28,8 @@
     bins; thanks to [fs-wu](https://github.com/fs-wu) for finding the issue and
     reporting it. [aerospike/aerospike-client-ruby#33]
 
-## December 4 2015 (1.0.11)
+1.0.11 / 2015-12-04
+===================
 
   Major feature and bug fix release.
 
@@ -39,7 +58,8 @@
 
     * Scan and Query termination has been fixed.
 
-## September 22 2015 (1.0.10)
+1.0.10 / 2015-09-22
+===================
 
   Major fix release.
 
@@ -51,7 +71,8 @@
 
     * Fixes an issue with dead connections that would cause an infinite loop.
 
-## Augest 11 2015 (1.0.9)
+1.0.9 / 2015-08-11
+==================
 
   Minor fix release.
 
@@ -59,7 +80,8 @@
 
     * Sends the original key value to the server for all relevant commands, including `operate` and `execute_udf`
 
-## July 23 2015 (1.0.8)
+1.0.8 / 2015-07-23
+==================
 
   Minor fix release.
 
@@ -75,7 +97,8 @@
 
     * Fixes an issue with including the `statement.rb` in the manifest. Thanks to [Ángel M](https://github.com/Angelmmiguel)
 
-## May 15 2015 (1.0.7)
+1.0.7 / 2015-05-15
+==================
 
   Minor fixes.
 
@@ -95,7 +118,8 @@
 
     * Removed deprecated `SetCapacity()` and `GetCapacity()` methods for LDTs.
 
-## April 2 2015 (1.0.6)
+1.0.6 / 2015-04-02
+==================
 
   Minor fixes.
 
@@ -103,7 +127,8 @@
 
     * Fixed running a stream query without parameters to the function.
 
-## March 25 2015 (1.0.5)
+1.0.5 / 2015-03-25
+==================
 
   Minor improvements.
 
@@ -111,7 +136,8 @@
 
     * Added `:execute_udf_on_query` method to `Aerospike::Client`
 
-## March 24 2015 (1.0.4)
+1.0.4 / 2015-03-24
+==================
 
   Hot fix.
 
@@ -119,7 +145,8 @@
 
     * Close a socket if connection raises an exception to avoid leaking the file descriptor.
 
-## March 24 2015 (1.0.3)
+1.0.3 / 2015-03-24
+==================
 
   Minor fixes and improvements.
 
@@ -132,7 +159,8 @@
     * Wait for a good connection on `socket.connect_nonblock` to prevent infinite loops on read/write operations.
 
 
-## March 14 2015 (1.0.2)
+1.0.2 / 2015-03-14
+==================
 
   Minor improvements.
 
@@ -140,7 +168,8 @@
 
     * Added `:new_many` method to `Aerospike::Client`
 
-## Jan 28 2015 (1.0.1)
+1.0.1 / 2015-01-28
+==================
 
   Hot fix.
 
@@ -148,7 +177,8 @@
 
     * Added `bcrypt` to the gem dependencies.
 
-## Jan 26 2015 (1.0.0)
+1.0.0 / 2015-01-26
+==================
 
   Major release. With this release, Ruby client graduates to version 1.
 
@@ -170,7 +200,8 @@
 
     * fixed size returned from `BytesValue.write`
 
-## Dec 28 2014 (0.1.6)
+0.1.6 / 2014-12-28
+==================
 
   Minor features added, minor fixes and improvements.
 
@@ -184,7 +215,8 @@
     * Fixed setting timeout on connection
     * Fixed exception handling typo for Connection#write
 
-## Dec 8 2014 (0.1.5)
+0.1.5 / 2014-12-08
+==================
 
   Major features added, minor fixes and improvements.
 
@@ -197,7 +229,8 @@
 
     * Fixed getting back results only for specified bin names.
 
-## Oct 27 2014 (0.1.3)
+0.1.3 / 2014-10-27
+==================
 
   Minor fix.
 
@@ -205,7 +238,8 @@
 
     * Fixed LDT bin and module name packing.
 
-## Oct 25 2014 (0.1.2)
+0.1.2 / 2014-10-25
+==================
 
   Minor fix.
 
@@ -213,7 +247,8 @@
 
     * Fixed String unpacking for single byte strings.
 
-## Oct 25 2014 (0.1.1)
+0.1.1 / 2014-10-25
+==================
 
   Minor fixes.
 
@@ -222,6 +257,7 @@
     * Fixed String packing header in Hash and Array.
     * #find on LDTs returns `nil` instad of raising an exception if the item is not found.
 
-## Oct 14 2014 (0.1.0)
+0.1.0 / 2014-10-14
+==================
 
   * Initial Release.

data/README.md

@@ -1,4 +1,9 @@
-# Aerospike Ruby Client
+# Aerospike Ruby Client [![travis][travis-image]][travis-url] [![gem][gem-image]][gem-url]
+
+[travis-image]: https://travis-ci.org/aerospike/aerospike-client-ruby.svg?branch=master
+[travis-url]: https://travis-ci.org/aerospike/aerospike-client-ruby
+[gem-image]: https://img.shields.io/gem/v/aerospike.svg
+[gem-url]: https://rubygems.org/gems/aerospike
 
 An Aerospike library for Ruby.
 
@@ -26,7 +31,7 @@ require 'aerospike'
 
 include Aerospike
 
-client = Client.new("127.0.0.1", 3000)
+client = Client.new("127.0.0.1")
 
 key = Key.new('test', 'test', 'key value')
 bin_map = {

data/lib/aerospike.rb

@@ -11,6 +11,8 @@ require 'aerospike/atomic/atomic'
 
 require 'aerospike/client'
 require 'aerospike/utils/pool'
+require 'aerospike/utils/packer'
+require 'aerospike/utils/unpacker'
 require 'aerospike/utils/epoc'
 require 'aerospike/utils/buffer'
 require 'aerospike/host'
@@ -40,6 +42,12 @@ require 'aerospike/command/admin_command'
 require 'aerospike/command/unsupported_particle_type_validator'
 require 'aerospike/key'
 require 'aerospike/operation'
+require 'aerospike/cdt/list_operation'
+require 'aerospike/cdt/map_operation'
+require 'aerospike/cdt/map_order'
+require 'aerospike/cdt/map_return_type'
+require 'aerospike/cdt/map_write_mode'
+require 'aerospike/cdt/map_policy'
 require 'aerospike/geo_json'
 
 require 'aerospike/policy/client_policy'

data/lib/aerospike/cdt/list_operation.rb

@@ -0,0 +1,199 @@
+# encoding: utf-8
+# Copyright 2016 Aerospike, Inc.
+#
+# Portions may be licensed to Aerospike, Inc. under one or more contributor
+# license agreements.
+#
+# 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 Aerospike
+  module CDT
+
+    ##
+    # List bin operations. Create list operations used by the Client#operate
+    # command. List operations support negative indexing. If the index is
+    # negative, the resolved index starts backwards from end of list.
+    #
+    # Index/Range examples:
+    # * Index 0: First item in list.
+    # * Index 4: Fifth item in list.
+    # * Index -1: Last item in list.
+    # * Index -3: Third to last item in list.
+    # * Index 1 Count 2: Second and third items in list.
+    # * Index -3 Count 3: Last three items in list.
+    # * Index -5 Count 4: Range between fifth to last item to second to last
+    #   item inclusive.
+    #
+    # If an index is out of bounds, a parameter error will be returned. If a
+    # range is partially out of bounds, the valid part of the range will be
+    # returned.
+
+    class ListOperation
+
+      APPEND        = 1
+      APPEND_ITEMS  = 2
+      INSERT        = 3
+      INSERT_ITEMS  = 4
+      POP           = 5
+      POP_RANGE     = 6
+      REMOVE        = 7
+      REMOVE_RANGE  = 8
+      SET           = 9
+      TRIM          = 10
+      CLEAR         = 11
+      SIZE          = 16
+      GET           = 17
+      GET_RANGE     = 18
+
+      ##
+      #  Create list append operation.
+      #  Server appends value(s) to end of the list bin.
+      #  Server returns list size.
+      def self.append(bin_name, *values)
+        if values.length > 1
+          create_operation(Operation::CDT_MODIFY, APPEND_ITEMS, bin_name, values)
+        else
+          create_operation(Operation::CDT_MODIFY, APPEND, bin_name, values.first)
+        end
+      end
+
+      ##
+      #  Create list insert operation.
+      #  Server inserts value(s) at the specified index of the list bin.
+      #  Server returns list size.
+      def self.insert(bin_name, index, *values)
+        if values.length > 1
+          create_operation(Operation::CDT_MODIFY, INSERT_ITEMS, bin_name, index, values)
+        else
+          create_operation(Operation::CDT_MODIFY, INSERT, bin_name, index, values.first)
+        end
+      end
+
+      ##
+      # Create list pop operation.
+      # Server returns item at specified index and removes item from list bin.
+      def self.pop(bin_name, index)
+        create_operation(Operation::CDT_MODIFY, POP, bin_name, index)
+      end
+
+      ##
+      # Create list pop range operation.
+      # Server returns "count" items starting at specified index and removes
+      # items from list bin. If "count" is not specified, the server returns
+      # items starting at the specified index to the end of the list and
+      # removes those items from the list bin.
+      def self.pop_range(bin_name, index, count=nil)
+        if count
+          create_operation(Operation::CDT_MODIFY, POP_RANGE, bin_name, index, count)
+        else
+          create_operation(Operation::CDT_MODIFY, POP_RANGE, bin_name, index)
+        end
+      end
+
+      ##
+      # Create list remove operation.
+      # Server removes item at specified index from list bin.
+      # Server returns number of items removed.
+      def self.remove(bin_name, index)
+        create_operation(Operation::CDT_MODIFY, REMOVE, bin_name, index)
+      end
+
+      ##
+      # Create list remove range operation.
+      # Server removes "count" items at specified index from list bin. If
+      # "count" is not specified, the server removes all items starting at the
+      # specified index to the end of the list.
+      # Server returns number of items removed.
+      def self.remove_range(bin_name, index, count=nil)
+        if count
+          create_operation(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index, count)
+        else
+          create_operation(Operation::CDT_MODIFY, REMOVE_RANGE, bin_name, index)
+        end
+      end
+
+      ##
+      # Create list set operation.
+      # Server sets item value at specified index in list bin.
+      # Server does not return a result by default.
+      def self.set(bin_name, index, value)
+        create_operation(Operation::CDT_MODIFY, SET, bin_name, index, value)
+      end
+
+      ##
+      # Create list trim operation.
+      # Server removes items in list bin that do not fall into range specified
+      # by index and count. If count is not specified, server will keep all
+      # items starting at the specified index to the end of the list.
+      # Server returns number of items removed.
+      def self.trim(bin_name, index, count=nil)
+        if count
+          create_operation(Operation::CDT_MODIFY, TRIM, bin_name, index, count)
+        else
+          create_operation(Operation::CDT_MODIFY, TRIM, bin_name, index)
+        end
+      end
+
+      ##
+      # Create list clear operation.
+      # Server removes all items in the list bin.
+      # Server does not return a result by default.
+      def self.clear(bin_name)
+        create_operation(Operation::CDT_MODIFY, CLEAR, bin_name)
+      end
+
+      ##
+      # Create list size operation.
+      # Server returns size of list.
+      def self.size(bin_name)
+        create_operation(Operation::CDT_READ, SIZE, bin_name)
+      end
+
+      ##
+      # Create list get operation.
+      # Server returns the item at the specified index in the list bin.
+      def self.get(bin_name, index)
+        create_operation(Operation::CDT_READ, GET, bin_name, index)
+      end
+
+      ##
+      # Create list get range operation.
+      # Server returns "count" items starting at the specified index in the
+      # list bin. If "count" is not specified, the server returns all items
+      # starting at the specified index to the end of the list.
+      def self.get_range(bin_name, index, count=nil)
+        if count
+          create_operation(Operation::CDT_READ, GET_RANGE, bin_name, index, count)
+        else
+          create_operation(Operation::CDT_READ, GET_RANGE, bin_name, index)
+        end
+      end
+
+      private
+
+      def self.create_operation(type, cdt_type, bin, *args)
+        bytes = nil
+        Packer.use do |packer|
+          packer.write_raw_short(cdt_type)
+          if args.length > 0
+            packer.write_array_header(args.length)
+            args.each do |value|
+              Value.of(value).pack(packer)
+            end
+          end
+          bytes = packer.bytes
+        end
+        return Operation.new(type, bin, BytesValue.new(bytes))
+      end
+
+    end
+  end
+end

data/lib/aerospike/cdt/map_operation.rb

@@ -0,0 +1,352 @@
+# encoding: utf-8
+# Copyright 2016 Aerospike, Inc.
+#
+# Portions may be licensed to Aerospike, Inc. under one or more contributor
+# license agreements.
+#
+# 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 Aerospike
+  module CDT
+
+    class MapOperation < Operation
+
+      SET_TYPE                  = 64
+      ADD                       = 65
+      ADD_ITEMS                 = 66
+      PUT                       = 67
+      PUT_ITEMS                 = 68
+      REPLACE                   = 69
+      REPLACE_ITEMS             = 70
+      INCREMENT                 = 73
+      DECREMENT                 = 74
+      CLEAR                     = 75
+      REMOVE_BY_KEY             = 76
+      REMOVE_BY_INDEX           = 77
+      REMOVE_BY_RANK            = 79
+      REMOVE_BY_KEY_LIST        = 81
+      REMOVE_BY_VALUE           = 82
+      REMOVE_BY_VALUE_LIST      = 83
+      REMOVE_BY_KEY_INTERVAL    = 84
+      REMOVE_BY_INDEX_RANGE     = 85
+      REMOVE_BY_VALUE_INTERVAL  = 86
+      REMOVE_BY_RANK_RANGE      = 87
+      SIZE                      = 96
+      GET_BY_KEY                = 97
+      GET_BY_INDEX              = 98
+      GET_BY_RANK               = 100
+      GET_BY_VALUE              = 102
+      GET_BY_KEY_INTERVAL       = 103
+      GET_BY_INDEX_RANGE        = 104
+      GET_BY_VALUE_INTERVAL     = 105
+      GET_BY_RANK_RANGE         = 106
+
+      attr_reader :map_op, :arguments, :policy, :return_type
+
+      def initialize(op_type, map_op, bin_name, *arguments, policy: nil, return_type: nil)
+        @op_type = op_type
+        @bin_name = bin_name
+        @bin_value = nil
+        @map_op = map_op
+        @arguments = arguments
+        @policy = policy
+        @return_type = return_type
+        self
+      end
+
+      ##
+      # Create set map policy operation.
+      # Server sets map policy attributes. Server returns null.
+      #
+      # The required map policy attributes can be changed after the map is created.
+      def self.set_policy(bin_name, policy)
+        MapOperation.new(Operation::CDT_MODIFY, SET_TYPE, bin_name, policy: policy)
+      end
+
+      ##
+      # Create map put operation.
+      # Server writes key/value item to map bin and returns map size.
+      #
+      # The map policy dictates the type of map to create when it does not exist.
+      # The map policy also specifies the mode used when writing items to the map.
+      def self.put(bin_name, key, value, policy: MapPolicy::DEFAULT)
+        cmd =
+          case policy.write_mode
+          when MapWriteMode::UPDATE then PUT
+          when MapWriteMode::UPDATE_ONLY then REPLACE
+          when MapWriteMode::CREATE_ONLY then ADD
+          else PUT
+          end
+        MapOperation.new(Operation::CDT_MODIFY, cmd, bin_name, key, value, policy: policy)
+      end
+
+      ##
+      # Create map put items operation
+      # Server writes each map item to map bin and returns map size.
+      #
+      # The map policy dictates the type of map to create when it does not exist.
+      # The map policy also specifies the mode used when writing items to the map.
+      def self.put_items(bin_name, values, policy: MapPolicy::DEFAULT)
+        cmd =
+          case policy.write_mode
+          when MapWriteMode::UPDATE then PUT_ITEMS
+          when MapWriteMode::UPDATE_ONLY then REPLACE_ITEMS
+          when MapWriteMode::CREATE_ONLY then ADD_ITEMS
+          else PUT_ITEMS
+          end
+        MapOperation.new(Operation::CDT_MODIFY, cmd, bin_name, values, policy: policy)
+      end
+
+      ##
+      # Create map increment operation.
+      # Server increments values by incr for all items identified by key and returns final result.
+      # Valid only for numbers.
+      #
+      # The map policy dictates the type of map to create when it does not exist.
+      # The map policy also specifies the mode used when writing items to the map.
+      def self.increment(bin_name, key, incr, policy: MapPolicy::DEFAULT)
+        MapOperation.new(Operation::CDT_MODIFY, INCREMENT, bin_name, key, incr, policy: policy)
+      end
+
+      ##
+      # Create map decrement operation.
+      # Server decrements values by decr for all items identified by key and returns final result.
+      # Valid only for numbers.
+      #
+      # The map policy dictates the type of map to create when it does not exist.
+      # The map policy also specifies the mode used when writing items to the map.
+      def self.decrement(bin_name, key, decr, policy: MapPolicy::DEFAULT)
+        MapOperation.new(Operation::CDT_MODIFY, DECREMENT, bin_name, key, decr, policy: policy)
+      end
+
+      ##
+      # Create map clear operation.
+      # Server removes all items in map.  Server returns null.
+      def self.clear(bin_name)
+        MapOperation.new(Operation::CDT_MODIFY, CLEAR, bin_name)
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map item identified by key and returns removed data specified by return_type.
+      def self.remove_keys(bin_name, *keys, return_type: MapReturnType::NONE)
+        if keys.length > 1
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_KEY_LIST, bin_name, keys, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_KEY, bin_name, keys.first, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map items identified by key range (key_begin inclusive, key_end exclusive).
+      # If key_begin is null, the range is less than key_end.
+      # If key_end is null, the range is greater than equal to key_begin.
+      #
+      # Server returns removed data specified by return_type.
+      def self.remove_key_range(bin_name, key_begin, key_end = nil, return_type: MapReturnType::NONE)
+        if key_end
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_KEY_INTERVAL, bin_name, key_begin, key_end, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_KEY_INTERVAL, bin_name, key_begin, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map items identified by value and returns removed data specified by return_type.
+      def self.remove_values(bin_name, *values, return_type: MapReturnType::NONE)
+        if values.length > 1
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_LIST, bin_name, values, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE, bin_name, values.first, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map items identified by value range (value_begin inclusive, value_end exclusive).
+      # If value_begin is null, the range is less than value_end.
+      # If value_end is null, the range is greater than equal to value_begin.
+      #
+      # Server returns removed data specified by return_type.
+      def self.remove_value_range(bin_name, value_begin, value_end = nil, return_type: MapReturnType::NONE)
+        if value_end
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_INTERVAL, bin_name, value_begin, value_end, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_VALUE_INTERVAL, bin_name, value_begin, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map item identified by index and returns removed data specified by return_type.
+      def self.remove_index(bin_name, index, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX, bin_name, index, return_type: return_type)
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes "count" map items starting at specified index and
+      # returns removed data specified by return_type. If "count" is not
+      # specified, the server selects map items starting at specified index to
+      # the end of map.
+      def self.remove_index_range(bin_name, index, count = nil, return_type: MapReturnType::NONE)
+        if count
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX_RANGE, bin_name, index, count, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_INDEX_RANGE, bin_name, index, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map remove operation.
+      # Server removes map item identified by rank and returns removed data specified by return_type.
+      def self.remove_by_rank(bin_name, rank, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_RANK, bin_name, rank, return_type: return_type)
+      end
+
+      ##
+      # Create map remove operation.
+      # Server selects "count" map items starting at specified rank and returns
+      # selected data specified by return_type. If "count" is not specified,
+      # server removes map items starting at specified rank to the last ranked.
+      def self.remove_by_rank_range(bin_name, rank, count = nil, return_type: MapReturnType::NONE)
+        if count
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_RANK_RANGE, bin_name, rank, count, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_MODIFY, REMOVE_BY_RANK_RANGE, bin_name, rank, return_type: return_type)
+        end
+      end
+
+      ##
+      # Create map size operation.
+      # Server returns size of map.
+      def self.size(bin_name)
+        MapOperation.new(Operation::CDT_READ, SIZE, bin_name)
+      end
+
+      ##
+      # Create map get by key operation.
+      # Server selects map item identified by key and returns selected data specified by return_type.
+      def self.get_key(bin_name, key, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_READ, GET_BY_KEY, bin_name, key, return_type: return_type)
+      end
+
+      # Create map get by key range operation.
+      # Server selects map items identified by key range (key_begin inclusive, key_end exclusive).
+      # If key_begin is null, the range is less than key_end.
+      # If key_end is null, the range is greater than equal to key_begin.
+      # <p>
+      # Server returns selected data specified by return_type.
+      def self.get_key_range(bin_name, key_begin, key_end = nil, return_type: MapReturnType::NONE)
+        if key_end
+          MapOperation.new(Operation::CDT_READ, GET_BY_KEY_INTERVAL, bin_name, key_begin, key_end, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_READ, GET_BY_KEY_INTERVAL, bin_name, key_begin, return_type: return_type)
+        end
+      end
+
+      # Create map get by value operation.
+      # Server selects map items identified by value and returns selected data specified by return_type.
+      def self.get_value(bin_name, value, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_READ, GET_BY_VALUE, bin_name, value, return_type: return_type)
+      end
+
+      # Create map get by value range operation.
+      # Server selects map items identified by value range (value_begin inclusive, value_end exclusive)
+      # If value_begin is null, the range is less than value_end.
+      # If value_end is null, the range is greater than equal to value_begin.
+      # <p>
+      # Server returns selected data specified by return_type.
+      def self.get_value_range(bin_name, value_begin, value_end = nil, return_type: MapReturnType::NONE)
+        if value_end
+          MapOperation.new(Operation::CDT_READ, GET_BY_VALUE_INTERVAL, bin_name, value_begin, value_end, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_READ, GET_BY_VALUE_INTERVAL, bin_name, value_begin, return_type: return_type)
+        end
+      end
+
+      # Create map get by index operation.
+      # Server selects map item identified by index and returns selected data specified by return_type.
+      def self.get_index(bin_name, index, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_READ, GET_BY_INDEX, bin_name, index, return_type: return_type)
+      end
+
+      # Create map get by index range operation.
+      # Server selects "count" map items starting at specified index and
+      # returns selected data specified by return_type.  If "count" is not
+      # specified, server selects map items starting at specified index to the
+      # end of map.
+      def self.get_index_range(bin_name, index, count = nil, return_type: MapReturnType::NONE)
+        if count
+          MapOperation.new(Operation::CDT_READ, GET_BY_INDEX_RANGE, bin_name, index, count, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_READ, GET_BY_INDEX_RANGE, bin_name, index, return_type: return_type)
+        end
+      end
+
+      # Create map get by rank operation.
+      # Server selects map item identified by rank and returns selected data
+      # specified by return_type.
+      def self.get_by_rank(bin_name, rank, return_type: MapReturnType::NONE)
+        MapOperation.new(Operation::CDT_READ, GET_BY_RANK, bin_name, rank, return_type: return_type)
+      end
+
+      # Create map get by rank range operation.
+      # Server selects "count" map items starting at specified rank and returns
+      # selected data specified by returnType.  If "count" is not specified,
+      # server selects map items starting at specified rank to the last ranked
+      # item.
+      def self.get_by_rank_range(bin_name, rank, count = nil, return_type: MapReturnType::NONE)
+        if count
+          MapOperation.new(Operation::CDT_READ, GET_BY_RANK_RANGE, bin_name, rank, count, return_type: return_type)
+        else
+          MapOperation.new(Operation::CDT_READ, GET_BY_RANK_RANGE, bin_name, rank, return_type: return_type)
+        end
+      end
+
+      def and_return(return_type)
+        @return_type = return_type
+        @bin_value = nil
+        self
+      end
+
+      def bin_value
+        @bin_value ||= pack_bin_value
+      end
+
+      private
+
+      def pack_bin_value
+        bytes = nil
+        Packer.use do |packer|
+          packer.write_raw_short(map_op)
+          args = arguments.dup
+          args.unshift(return_type) if return_type
+          if policy && policy.write_mode != MapWriteMode::UPDATE_ONLY
+            args << policy.value
+          end
+          if args.length > 0
+            packer.write_array_header(args.length)
+            args.each do |value|
+              Value.of(value).pack(packer)
+            end
+          end
+          bytes = packer.bytes
+        end
+        BytesValue.new(bytes)
+      end
+
+    end
+
+  end
+end