aws-sdk-v1 1.52.0

data/lib/aws/simple_db/attribute.rb

@@ -0,0 +1,156 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class SimpleDB
+
+    # Represents a single named item attribute in SimpleDB.
+    class Attribute
+
+      include Core::Model
+      include Enumerable
+      include ConsistentReadOption
+      include PutAttributes
+      include DeleteAttributes
+
+      # @api private
+      def initialize item, name, options = {}
+        @item = item
+        @name = name
+        super
+      end
+
+      # @return [Item] The item this attribute belongs to.
+      attr_reader :item
+
+      # @return [String] The name of this attribute.
+      attr_reader :name
+
+      # Sets all values for this attribute, replacing current values.
+      #
+      # @example Setting a list of values
+      #
+      #   attributes['colors'].set 'red', 'blue', 'green'
+      #
+      # @example Setting an array of values
+      #
+      #   attributes['colors'].set ['red', 'blue']
+      #
+      # @param [String] values A list of attribute values to set.
+      # @return [nil]
+      def set *values
+        put(values, true)
+        nil
+      end
+
+      # Appends values to this attribute.  Duplicate values are ignored
+      # by SimpleDB.
+      #
+      # @example Adding a list of values
+      #
+      #   attributes['colors'].add 'red', 'blue', 'green'
+      #
+      # @example Adding an array of values
+      #
+      #   attributes['colors'].add ['red', 'blue']
+      #
+      # @param [String] values A list of attribute values to add.
+      # @return [nil]
+      def add *values
+        put(values, false)
+        nil
+      end
+      alias_method :<<, :add
+
+      # Deletes this attribute or specific values from this attribute.
+      #
+      # @example Delete the attribute and all of its values
+      #
+      #   item.attributes['color'].delete
+      #
+      # @example Delete specific attribute values
+      #
+      #   item.attributes['color'].delete('red', 'blue')
+      #
+      # @param values One ore more values to remove from this attribute.
+      #   If values is empty, then all attribute values are deleted
+      #   (which deletes this attribute).
+      # @return [nil]
+      def delete *values
+        expect_opts = values.pop if values.last.kind_of?(Hash)
+
+        if values.empty?
+          delete_named_attributes(name, expect_opts || {})
+        else
+          delete_attribute_values(Hash[[[name, values]]].
+                                  merge(expect_opts || {}))
+        end
+        nil
+      end
+
+      # Yields once for each value on this attribute.
+      #
+      # @yield [attribute_value] Yields once for each domain in the account.
+      # @yieldparam [String] attribute_value
+      # @param [Hash] options
+      # @option options [Boolean] :consistent_read (false) A consistent read
+      #   returns values that reflects all writes that received a successful
+      #   response prior to the read.
+      # @return [nil]
+      def each options = {}, &block
+
+        resp = client.get_attributes(
+          :domain_name => item.domain.name,
+          :item_name => item.name,
+          :attribute_names => [name],
+          :consistent_read => consistent_read(options))
+
+        resp.attributes.each do |attribute|
+          yield(attribute.value)
+        end
+
+        nil
+
+      end
+
+      # Returns all values for this attribute as an array of strings.
+      #
+      # @example
+      #   item.attributes['ratings'].values
+      #   #=> ['5', '3', '4']
+      #
+      # @param [Hash] options
+      # @option options [Boolean] :consistent_read (false) A consistent read
+      #   returns values that reflects all writes that received a successful
+      #   response prior to the read.
+      # @return [Array<String>] An array of attribute values
+      def values options = {}
+        values = []
+        self.each(options) do |value|
+          values << value
+        end
+        values
+      end
+
+      # @api private
+      protected
+      def put values, replace
+        expect_opts = values.pop if values.last.kind_of?(Hash)
+        do_put(attribute_hashes(Hash[[[name, values]]],
+                                replace),
+               expect_opts || {})
+      end
+
+    end
+  end
+end

data/lib/aws/simple_db/attribute_collection.rb

@@ -0,0 +1,240 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class SimpleDB
+    class AttributeCollection
+
+      include Core::Model
+      include Enumerable
+      include ConsistentReadOption
+      include PutAttributes
+      include DeleteAttributes
+
+      # @param [Item] item The item to create an attribute collection for.
+      # @return [AttributeCollection]
+      def initialize item, options = {}
+        @item = item
+        super
+      end
+
+      # @return [Item] The item this collection belongs to.
+      attr_reader :item
+
+      # Returns an Attribute with the given name.
+      #
+      # @note This does not make a request to SimpleDB.
+      #
+      # You can ask for any attribute by name.  The attribute may or may not
+      # actually exist in SimpleDB.
+      #
+      # @example Get an attribute by symbol or string name
+      #
+      #   colors = item.attributes[:colors]
+      #   colors = item.attributes['colors']
+      #
+      # @param [String, Symbol] attribute_name name of the attribute to get.
+      # @return [Item] An item with the given name.
+      def [] attribute_name
+        Attribute.new(item, attribute_name.to_s)
+      end
+
+      # Sets the values for a given attribute.
+      #
+      # @example Replace all of the values for the named attribute.
+      #
+      #   item.attributes[:color] = 'red', 'blue'
+      #
+      # @return This method returns the values passed to it.
+      def []= attribute_name, *values
+        self[attribute_name].set(*values)
+      end
+
+      # Yields all attribute values with their names.
+      #
+      # @example Getting all values for an item
+      #
+      #   item.attributes.each_value do |name, value|
+      #     puts "#{name}: #{value}"
+      #   end
+      #
+      # @yield [attribute_name, attribute_value] Yields once for every
+      #   attribute value on the item.
+      # @yieldparam [String] attribute_name
+      # @yieldparam [String] attribute_value
+      # @param [Hash] options
+      # @option options [Boolean] :consistent_read (false) Causes this
+      #   method to yield the most current attributes for this item.
+      # @return [nil]
+      def each_value options = {}, &block
+
+        list = client.get_attributes(
+          :domain_name => item.domain.name,
+          :item_name => item.name,
+          :consistent_read => consistent_read(options))
+
+        list.attributes.each do |attribute|
+          attribute_name = attribute.name
+          attribute_value = attribute.value
+          yield(attribute_name, attribute_value)
+        end
+
+        nil
+
+      end
+
+      # Yields all attribute for this item.
+      #
+      # @example Getting all attributes for an item
+      #
+      #   item.attributes.each do |attribute|
+      #     puts attribute.name
+      #   end
+      #
+      # @yield [attribute] Yields once for every attribute
+      #   on the item.  Yields each attribute only one time, even it
+      #   has multiple values.
+      # @yieldparam [Attribute] attribute
+      # @param [Hash] options
+      # @option options [Boolean] :consistent_read (false) Causes this
+      #   method to yield the most current attributes for this item.
+      # @return [nil]
+      def each options = {}, &block
+        yielded = {}
+        each_value(options) do |attribute_name, attribute_value|
+          unless yielded[attribute_name]
+            attribute = self[attribute_name]
+            yield(attribute)
+            yielded[attribute_name] = true
+          end
+        end
+        nil
+      end
+
+      # Replaces attributes for the {#item}.
+      #
+      # The `attributes_hash` should have attribute names as keys.  The
+      # hash values should be either strings or arrays of strings.
+      #
+      # Attributes not named in this hash are left alone.  Attributes named
+      # in this hash are replaced.
+      #
+      # @example
+      #
+      #   item.attributes.set(
+      #     'colors' => ['red', 'blue'],
+      #     'category' => 'clearance')
+      #
+      # @param [Hash] attributes
+      # @return [nil]
+      def replace attributes
+        do_put(attribute_hashes(attributes, true), attributes)
+      end
+      alias_method :set, :replace
+
+      # Adds values to attributes on the {#item}.
+      #
+      # The `attributes_hash` should have attribute names as keys.  The
+      # hash values should be either strings or arrays of strings.
+      #
+      # @example
+      #
+      #   item.attributes.add(
+      #     'colors' => ['red', 'blue'],
+      #     'category' => 'clearance')
+      #
+      # @param[Hash] attribute_hash
+      # @return [nil]
+      def add attributes
+        do_put(attribute_hashes(attributes, false), attributes)
+      end
+
+      # Perform a mixed update of added and replace attributes.
+      #
+      # @example
+      #
+      #   item.attributes.put(
+      #     :add => { 'colors' => %w(green blue), 'tags' => 'cool' }
+      #     :replace => { 'quantity' => 5 }
+      #   )
+      #
+      # @param [Hash] options
+      # @option options [Hash] :add A hash of attribute names and values to
+      #   append to this item.
+      # @option options [Hash] :replace A hash of attribute names and values to
+      #   add to this item.  If there are currently attributes of the same
+      #   name they will be replaced (not appended to).
+      # @option options [Hash] :replace
+      # @return [nil]
+      def put options = {}
+        add = options[:add] || {}
+        replace = options[:replace] || {}
+        attributes = attribute_hashes(add, false)
+        attributes += attribute_hashes(replace, true)
+        do_put(attributes, options)
+      end
+
+      # Returns a hash of all attributes (names and values).
+      # The attribute names are strings and the values are
+      # arrays of strings.
+      #
+      # @example
+      #
+      #   item.attributes.to_h
+      #   #=> { 'colors' => ['red','blue'], 'size' => ['large'] }
+      #
+      # @param [Hash] options
+      # @option options [Boolean] :consistent_read (false) Causes this
+      #   method to return the most current attributes values.
+      # @return [Hash]
+      def to_h options = {}
+        hash = {}
+        each_value(options) do |attribute_name,attribute_value|
+          hash[attribute_name] ||= []
+          hash[attribute_name] << attribute_value
+        end
+        hash
+      end
+
+      # Delete one or more attributes from {#item}.
+      #
+      # @example Delete a list of attributes by name (accepts a list or array)
+      #
+      #   item.attributes.delete 'size', 'color'
+      #   item.attributes.delete %w(size color)
+      #
+      # @example Delete a specific list of attribute values
+      #
+      #   item.attributes.delete(:color => 'red', :tags => %w(special limited))
+      #
+      # @overload delete(attributes)
+      #   @param [Hash] attributes A hash of attribute names and values to
+      #     delete.
+      #   @return [nil]
+      #
+      # @overload delete(*attribute_names)
+      #   @param [String] A list of attribute names to delete.
+      #   @return [nil]
+      #
+      def delete *args
+        if args.size == 1 and args.first.kind_of?(Hash)
+          delete_attribute_values(args.first)
+        else
+          delete_named_attributes(*args)
+        end
+        nil
+      end
+
+    end
+  end
+end

data/lib/aws/simple_db/client.rb

@@ -0,0 +1,67 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file 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 AWS
+  class SimpleDB
+
+    # Client class for Amazon SimpleDB.
+    class Client < Core::QueryClient
+
+      API_VERSION = '2009-04-15'
+
+      signature_version :Version2
+
+      # @api private
+      REGION_US_E1 = 'sdb.amazonaws.com'
+
+      # @api private
+      REGION_US_W1 = 'sdb.us-west-1.amazonaws.com'
+
+      # @api private
+      REGION_EU_W1 = 'sdb.eu-west-1.amazonaws.com'
+
+      # @api private
+      REGION_APAC_SE1 = 'sdb.ap-southeast-1.amazonaws.com'
+
+      # @api private
+      CACHEABLE_REQUESTS = Set[
+        :domain_metadata,
+        :get_attributes,
+        :list_domains,
+        :select,
+      ]
+
+      # @param [String] name
+      # @return [Boolean] Returns true if the given name is a valid
+      #   Amazon SimpleDB domain name.
+      # @api private
+      def valid_domain_name? name
+        self.class.valid_domain_name?(name)
+      end
+
+      # @param [String] name
+      # @return [Boolean] Returns true if the given name is a valid
+      #   Amazon SimpleDB domain name.
+      def self.valid_domain_name? name
+        name.to_s =~ /^[a-z_\-\.]{3,255}$/i ? true : false
+      end
+
+    end
+
+    class Client::V20090415 < Client
+
+      define_client_methods('2009-04-15')
+
+    end
+  end
+end